Utiliser des variables dynamiques dans votre document de flux de travail - EC2Image Builder
Utiliser les variables système Image Builder

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.

Utiliser des variables dynamiques dans votre document de flux de travail

Vous pouvez utiliser des variables dynamiques dans vos documents de flux de travail pour représenter des valeurs qui varient au moment de l'exécution de votre processus de création d'image. Les valeurs des variables dynamiques sont représentées sous forme de JSONPath sélecteurs dotés de nœuds structurels qui identifient de manière unique la variable cible.

JSONPathstructure variable du flux de travail dynamique

$.<document structure>.[<step name>].<variable name>

Le premier nœud après la racine ($) fait référence à la structure du document du flux de travail, telle questepOutputs, ou dans le cas des variables système Image Builder,imageBuilder. La liste suivante contient les nœuds de structure JSONPath de documents de flux de travail pris en charge.

Nœuds de structure de document

  • paramètres - Les paramètres du flux de travail

  • stepOutputs - Sorties d'une étape du même document de flux de travail

  • workflowOutputs - Sorties d'un document de flux de travail déjà exécuté

  • imagebuilder - Variables système Image Builder

Les nœuds parameters et structure du stepOutputs document incluent un nœud facultatif pour le nom de l'étape. Cela permet de garantir des noms de variables uniques pour toutes les étapes.

Le dernier nœud de JSONPath est le nom de la variable cible, par exempleinstanceId.

Chaque étape peut faire référence à la sortie de toute action d'étape précédente avec ces variables JSONPath dynamiques. Ceci est également connu sous le nom de chaînage ou de référencement. Pour faire référence au résultat d'une action d'une étape précédente, vous pouvez utiliser la variable dynamique suivante.

$.stepOutputs.step-name.output-name

Exemple

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

Utiliser les variables système Image Builder

Image Builder fournit les variables système suivantes que vous pouvez utiliser dans votre document de flux de travail :

Nom de variable

Description

Type

Exemple de valeur

cloudWatchLogGroupe

Nom du groupe CloudWatch Logs pour les logs de sortie.

Format : /aws/imagebuilder/<recipe-name>

Chaîne

/aws/imagebuilder/sampleImageRecipe

cloudWatchLogStream

Nom du flux CloudWatch Logs pour les logs de sortie.

Chaîne

1.0.0/1

collectImageMetadata

Le paramètre qui indique à Image Builder s'il doit collecter les métadonnées de l'instance.

Booléen

true | false

collectImageScanConclusions

La valeur actuelle du paramètre qui permet à Image Builder de collecter les résultats de numérisation d'images.

Booléen

true | false

imageBuildNumber

Numéro de version de compilation de l'image.

Entier

1

imageId

L'AMIidentifiant de l'image de base.

Chaîne

ami-1234567890abcdef1

imageName

Le nom de l'image.

Chaîne

sampleImage

imageType

Type de sortie d'image.

Chaîne

AMI | Docker

imageVersionNumber

Numéro de version de l'image.

Chaîne

1.0.0

instanceProfileName

Nom du rôle de profil d'instance utilisé par Image Builder pour lancer les instances de génération et de test.

Chaîne

SampleImageBuilderInstanceProfileRole

platform

La plate-forme du système d'exploitation de l'image créée.

Chaîne

Linux | Windows | MacOS

Journaux S3

JSONObjet contenant la configuration des journaux S3 écrits par Image Builder.

JSONobjet

{'S3logs' : {'s3 BucketName ':'sample-bucket',' S3 KeyPrefix ':'ib-logs'}}

securityGroups

Le groupe de sécurité IDs qui s'applique à la création et au test des instances.

Liste [Chaîne]

[sg-1234567890abcdef1, sg-11112222333344445]

sourceImageARN

Nom de la ressource Amazon (ARN) de la ressource image Image Builder que le flux de travail utilise pour les étapes de création et de test.

Chaîne

arn:aws:imagebuilder :us-east-1:111122223333:image/sampleImage/1.0.0/1

subnetId

ID du sous-réseau dans lequel lancer les instances de génération et de test.

Chaîne

subnet-1234567890abcdef1

terminateInstanceOnDéfaillance

La valeur actuelle du paramètre qui indique à Image Builder de mettre fin à l'instance en cas de défaillance ou de la conserver à des fins de dépannage.

Booléen

true | false

workflowPhase

Étape en cours d'exécution pour l'exécution du flux de travail.

Chaîne

Build | Test

workingDirectory

Le chemin d'accès au répertoire de travail.

Chaîne

/tmp