Configurer un workflow en mode Advanced

Objectif

Les workflows peuvent également être configurés directement à l'aide d'une configuration JSON. Pour accéder à la configuration JSON d'un nouveau workflow, cliquez sur l'onglet Expert de la fenêtre "New Workflow" ou "Edit Workflow".

Découvrir la configuration JSON

Les utilisateurs peuvent saisir directement dans l'éditeur JSON pour configurer un Workflow. La configuration JSON inclut plus d'options que celles disponibles via l'interface graphique.

Référence des paramètres du workflow

Par ordre alphabétique, les paramètres sont les suivants :

Exemple de configuration JSON

Ci-dessous, la configuration JSON d'un workflow typique. Il comporte 2 Stages avec respectivement 2 actions dans "Stage 1" et 2 actions dans "Stage 2".

{
  "params": {
     "log_level": "info"
  },
  "auto_flushall": true,
  "display_name": "flushall",
  "description": "routine maintenance workflow",
  "stages": [
    {
      "stageName": "Stage 1",
      "actions": [
        {"action_conf": "5c9bba68555fb219eb000020"},
        {"action_conf": "5c9bba68555fb2190000ll99"}

      ]
    },
    {
      "stageName": "Stage 2",
      "actions": [
        {"action_conf": "5c9bba68555hghjgjhgjhgjh"}
      ]
    }
  ]
}

Paramètres du périmètre de dates

Pour définir le périmètre de dates, vous pouvez utiliser une limite de date absolue (par ex., fixée dans le temps) ou une limite de date relative (par ex., calculée à partir de la date actuelle).

Pour définir un périmètre de dates absolu, utilisez les paramètres dateMin et dateMax et saisissez les dates sous forme de chaîne au format YYYY-MM-DD. Par exemple, cela vous permettrait de relancer le calcul d'un workflow entre des dates spécifiques dans le passé.

{
  ...
  "dateMin": "2019-04-25",
  "dateMax": "2019-04-25"
}

Pour définir un périmètre de dates relatif, utilisez le paramètre days et saisissez, en jours, la distance par rapport à la date actuelle pour les limites inférieure et supérieure. Par exemple, cela serait utilisé dans un workflow quotidien qui ne devrait affecter que les données d'"avant-hier" et d'"aujourd'hui". Le nombre correspond au nombre de jours à soustraire de la date du jour.

{
  ...
  "days": {
    "min": "2",
    "max": "0"
  }
}

Paramètres des Stages

Les paramètres des Stages peuvent également être modifiés directement depuis l'interface utilisateur.

{
  "display_name": "flushall",
  …
  "workflow": [
    {
      "disable": false,
      "stageName": "update_metas_lite",
      "actions": [
        {
          "action_conf": "update_metas_lite",
          "disable": false
        }
      ]
    …
  ]
}

Configurations de substitution

Configurations d'action

La substitution des configurations d'action vous permet de réutiliser la même action dans plusieurs workflows avec des paramètres d'exécution différents, sans affecter les configurations des actions elles-mêmes. Par exemple, supposons que vous ayez défini le périmètre d'une action, avec un ensemble de valeurs spécifique : "perimeterValues":["1","2"]

Vous pouvez réutiliser cette même action avec des valeurs de périmètre différentes dans le même workflow comme suit :

{
  "logLevel": "info",
  "auto_flushall": true,
  "display_name": "flushall",
  "workflow": [
    {
      "stageName": "Stage 1",
      "actions": [
        {"action_conf": "5c9bba68555fb219eb000020", "perimeterValues": ["1","2"]},
        {"action_conf": "5c9bba68555fb219eb000020", "perimeterValues": ["8"]}
      ]
    }
  ]
}

Priorités de configuration

Les configurations peuvent être substituées à 3 niveaux différents : workflow, Stages ou actions. Le niveau de configuration le plus granulaire s'applique à tous les sous-objets. Par exemple, les configurations définies au niveau du Stage seront remplacées par toute configuration définie au niveau de l'action. Utilisons l'exemple suivant pour illustrer l'ordre de priorité :

{
  "logLevel": "info",
  "perimeterValues": ["0"],
  "auto_flushall": true,
  "display_name": "flushall",
  "workflow": [
    {
      "stageName": "Stage 1",
      "perimeterValues": ["1"],
      "actions": [
        {"action_conf": "abc", "perimeterValues": ["2"]},
        {"action_conf": "efg"}

      ]
    },
    {
      "stageName": "Stage 2",
      "actions": [
        {"action_conf": "hij"}
      ]
    }
  ]
}

D'après la configuration JSON ci-dessus, les valeurs de périmètre pour les différentes actions exécutées dans le workflow seront les suivantes :

Délai d'expiration du workflow

Si une action au sein d'un workflow prend plus de temps que prévu, il est possible de définir une option de timeout afin que le workflow soit interrompu. La durée du timeout est définie comme la valeur du paramètre workflow_timeout dans un format lisible tel que "worfklow_timeout":"1h 10m"

Les valeurs sont cumulatives d'une unité de temps à l'autre. Les unités de temps prises en charge incluent :

Ci-dessous, un exemple de configuration JSON utilisant l'option de timeout du workflow :

{
  "logLevel": "info",
  "auto_flushall": true,
  "worfklow_timeout":"59m 50s",
  "display_name": "flushall",
  "workflow": [
    {
      "stageName": "Stage 1",
      "actions": [
        {"action_conf": "5c9bba68555fb219eb000020"},
        {"action_conf": "5c9bba68555fb2190000ll99"}

      ]
    }
  ]
}

Aller plus loin

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l’équipe qui développe la Data Platform sur le canal Discord dédié.

Si vous avez besoin d'une assistance concernant vos services OVHcloud, créez une demande depuis notre centre d'aide.

Rejoignez notre communauté d'utilisateurs.