Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Utiliser des variables dynamiques dans votre document de flux de travail

Mode de mise au point

Sur cette page

Utiliser des variables dynamiques dans votre document de flux de travail - EC2 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.

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.

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.

JSONPath structure 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 document 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 au résultat 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

Lorsqu'un paramètre d'entrée fait référence à une variable dynamique, l'indicateur de chaînage (.$) doit être attaché à la fin du nom du paramètre, comme indiqué dans l'exemple suivant.

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 la 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

ID AMI de l'image de base.

Chaîne

ami-1234567890abcdef1

Nom de l'image

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

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

Objet JSON

{'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]

Source ImageLearn

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

Chaîne

arn:aws:imagebuilder : ::image/ us-east-1 111122223333 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

Phase du flux de travail

L'é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

Rubrique suivante :

Instructions conditionnelles

Rubrique précédente :

Actions par étapes
ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.