Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'un document de flux de travail YAML

Le document de définition du format YAML configure les étapes d'entrée, de sortie et de flux de travail pour les étapes de création, de test et de distribution du processus de création d'image. Le même format de document s'applique aux trois types de flux de travail. Vous pouvez partir de modèles qui incluent des étapes standardisées, ou vous pouvez partir de zéro pour définir votre propre flux de travail. Que vous utilisiez un modèle ou que vous partiez de zéro, vous pouvez personnaliser le flux de travail en fonction de vos besoins.

Structure d'un document de flux de travail YAML

Les sections suivantes décrivent la structure du document de flux de travail YAML utilisé par Image Builder pour effectuer des actions de création, de test et de distribution d'images.

Identification des documents relatifs au flux

Identifie le flux de travail de manière unique. Cette section peut inclure les attributs suivants.

Exemple

---
name: sample-test-image
description: Workflow for a sample image, with extra configuration options exposed through workflow parameters.
schemaVersion: 1.0

Paramètres d'entrée du document de flux de travail

Cette partie du document de flux de travail définit les paramètres d'entrée que l'appelant peut spécifier. Si vous n'avez aucun paramètre, vous pouvez omettre cette section. Si vous spécifiez des paramètres, chaque paramètre peut inclure les attributs suivants.

Vous pouvez définir jusqu'à 25 paramètres dans un document de flux de travail. Chaque valeur de paramètre peut contenir jusqu'à 1 024 caractères. Un paramètre doit utiliser l'un des quatre types de données pris en charge : stringinteger,boolean, oustringList. Si vous ne spécifiez aucune default valeur pour un paramètre, vous devez fournir la valeur du paramètre au moment de l'exécution.

Exemple

Spécifiez le paramètre dans le document de flux de travail.

parameters:
  - name: waitForActionAtEnd
    type: boolean
    default: true
    description: "Wait for an external action at the end of the workflow"

Utilisez la valeur du paramètre dans le document de flux de travail.

$.parameters.waitForActionAtEnd

Étapes du document de workflow

Spécifie jusqu'à 15 étapes d'actions pour le flux de travail. Les étapes s'exécutent dans l'ordre dans lequel elles sont définies dans le document de flux de travail. En cas d'échec, une annulation s'exécute dans l'ordre inverse, en commençant par l'étape qui a échoué et en remontant jusqu'aux étapes précédentes.

Chaque étape peut faire référence au résultat de toute action d'étape précédente. C'est ce que l'on appelle le chaînage ou le référencement. Pour faire référence au résultat d'une action d'une étape précédente, vous pouvez utiliser un sélecteur JSONPath. Par exemple :

$.stepOutputs.step-name.output-name

Pour plus d’informations, consultez Utiliser des variables dynamiques dans votre document de flux de travail.

Chaque étape peut inclure les attributs suivants.

Exemple

steps:
  - name: LaunchTestInstance
    action: LaunchInstance
    onFailure: Abort
    inputs:
      waitFor: "ssmAgent"

  - name: ApplyTestComponents
    action: ExecuteComponents
    onFailure: Abort
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

  - name: TerminateTestInstance
    action: TerminateInstance
    onFailure: Continue
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

  - name: WaitForActionAtEnd
    action: WaitForAction
    if:
      booleanEquals: true
      value: "$.parameters.waitForActionAtEnd"

Réessayer les étapes du flux de travail qui ont échoué

Par défaut, chaque étape d'un flux de travail ne s'exécute qu'une seule fois. Pour qu'Image Builder réexécute automatiquement une étape en cas d'échec, ajoutez l'retryattribut à l'étape. L'retryattribut contient les champs suivants.

Les nouvelles tentatives fonctionnent comme suit :

Certaines actions d'étape ont un comportement de nouvelle tentative supplémentaire :

Pour voir combien de fois une étape a été exécutée, utilisez les opérations de l'ListWorkflowStepExecutionsAPI GetWorkflowStepExecution or. La réponse inclut les maxAttempts champs attemptNumber et de l'étape.

Exemple

steps:
  - name: LaunchBuildInstance
    action: LaunchInstance
    onFailure: Abort
    retry:
      maxAttempts: 3
      backoffSeconds: 60
    inputs:
      waitFor: "ssmAgent"

Sorties de documents de workflow

Définit les sorties pour le flux de travail. Chaque sortie est une paire clé-valeur qui indique le nom de la sortie et la valeur. Vous pouvez utiliser les sorties pour exporter des données au moment de l'exécution que les flux de travail suivants pourront utiliser. Cette section est facultative.

Vous pouvez définir jusqu'à 25 sorties dans un document de flux de travail. Chaque nom de sortie doit être unique dans tous les flux de travail que vous incluez dans votre pipeline. Un flux de travail ultérieur peut ensuite référencer une sortie par son nom avec$.workflowOutputs.name.

Chaque sortie que vous définissez inclut les attributs suivants.

Exemple

Créez un ID d'image de sortie pour le document de flux de travail avec le résultat de l'createProdImageétape.

outputs:
  - name: 'outputImageId'
    value: '$.stepOutputs.createProdImage.imageId'

Reportez-vous au résultat du flux de travail dans le flux de travail suivant.

$.workflowOutputs.outputImageId