View a markdown version of this page

Création d'un flux de travail d'images - 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.

Création d'un flux de travail d'images

Lorsque vous créez un flux de travail d'images, vous avez davantage de contrôle sur votre processus de création d'images. Vous pouvez spécifier le flux de travail qui s'exécute lorsqu'Image Builder crée votre image, les flux de travail qui s'exécutent lorsqu'il teste l'image et le flux de travail qui s'exécute lorsqu'il distribue l'image. Vous pouvez également spécifier une clé gérée par le client pour chiffrer les ressources de votre flux de travail. Pour en savoir plus sur le chiffrement des ressources de votre flux de travail, consultezChiffrement et gestion des clés dans Image Builder.

Pour la création d'images, vous pouvez spécifier un flux de travail pour la phase de création, un ou plusieurs flux de travail pour la phase de test et un flux de travail pour l'étape de distribution. Vous pouvez même sauter complètement une étape, selon vos besoins. Vous configurez les actions que votre flux de travail entreprend dans le document de définition YAML qu'il utilise. Pour plus d'informations sur la syntaxe de votre document YAML, consultezCréation d'un document de flux de travail YAML.

Pour créer un nouveau flux de production, de test ou de distribution, sélectionnez l'onglet correspondant à votre environnement.

Console de gestion AWS

Vous pouvez utiliser le processus suivant pour créer un nouveau flux de travail dans la console Image Builder.

  1. Ouvrez la console EC2 Image Builder à https://console.aws.amazon.com/imagebuilder/ l'adresse.

  2. Choisissez Flux de travail liés à l'image dans le volet de navigation. Cela affiche la liste des flux de travail liés aux images que votre compte possède ou auxquels vous avez accès.

    Note

    La liste inclut toujours les ressources de flux de travail gérés par Amazon qu'Image Builder utilise pour ses flux de travail par défaut. Pour afficher les détails de ces flux de travail, sélectionnez le lien Workflow.

  3. Pour créer un nouveau flux de travail, choisissez Créer un flux de travail avec des images. La page Créer un flux de travail d'image s'affiche.

  4. Configurez les détails de votre nouveau flux de travail. Sélectionnez le type de flux de travail en haut du formulaire : choisissez Créer pour créer un flux de travail de génération, Tester pour créer un flux de travail de test ou Distribution pour créer un flux de travail de distribution. Le type de flux de travail correspond à la Type valeur de l'API (BUILDTEST, ouDISTRIBUTION). Image Builder remplit la liste des modèles en fonction de cette option. Toutes les autres étapes sont identiques pour les workflows de création, de test et de distribution.

    Général

    La section générale inclut les paramètres qui s'appliquent à votre ressource de flux de travail, tels que le nom et la description. Les paramètres généraux sont les suivants :

    • Nom du flux de travail d'image (obligatoire) : nom de votre flux de travail d'image. Le nom doit être unique dans votre compte. Le nom peut comporter jusqu'à 128 caractères. Les caractères valides incluent les lettres, les chiffres-, les espaces et_.

    • Version (obligatoire) : version sémantique de la ressource de flux de travail à créer (major.minor.patch).

    • Description (facultatif) — Ajoutez éventuellement une description de votre flux de travail.

    • Clé KMS (optionnelle) : vous pouvez chiffrer les ressources de votre flux de travail à l'aide d'une clé gérée par le client. Pour de plus amples informations, veuillez consulter Chiffrez les flux d'images à l'aide d'une clé gérée par le client.

    Document de définition

    Le document de flux de travail YAML contient toutes les configurations de votre flux de travail.

    Prise en main

    • Pour commencer avec un modèle par défaut d'Image Builder comme référence pour votre flux de travail, sélectionnez l'option Commencer à partir de modèles. Cette option est sélectionnée par défaut. Une fois que vous avez choisi le modèle à utiliser dans la liste des modèles, la configuration par défaut du modèle que vous avez sélectionné est copiée dans le contenu de votre nouveau document de flux de travail, où vous pouvez apporter des modifications.

    • Pour définir votre document de flux de travail à partir de zéro, sélectionnez l'option Partir de zéro. Cela permet de remplir le contenu avec un bref aperçu de certaines parties importantes du format du document pour vous aider à démarrer.

    Le panneau Contenu comprend une barre d'état en bas qui affiche des avertissements ou des erreurs pour votre document YAML. Pour plus d'informations sur la création d'un document de flux de travail YAML, consultezCréation d'un document de flux de travail YAML.

  5. Lorsque vous avez terminé votre flux de travail, ou si vous souhaitez enregistrer la progression et y revenir plus tard, choisissez Créer un flux de travail.

AWS CLI

Avant d'exécuter la create-workflow commande dans le AWS CLI, vous devez créer le document YAML contenant l'ensemble de la configuration de votre flux de travail. Pour de plus amples informations, veuillez consulter Création d'un document de flux de travail YAML.

L'exemple suivant montre comment créer un flux de travail de génération à l'aide de la commande create-workflow AWS CLI . Le --data paramètre fait référence à un document YAML qui contient la configuration de génération pour le flux de travail que vous créez.

Exemple : création d'un flux de travail 

aws imagebuilder create-workflow --name example-build-workflow --semantic-version 1.0.0 --type BUILD --data file://example-build-workflow.yml

Sortie :

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

L'exemple suivant montre comment créer un flux de travail de test à l'aide de la commande create-workflow AWS CLI . Le --data paramètre fait référence à un document YAML qui contient la configuration de test pour le flux de travail que vous créez.

Exemple : création d'un flux de travail de test 

aws imagebuilder create-workflow --name example-test-workflow --semantic-version 1.0.0 --type TEST --data file://example-test-workflow.yml

Sortie :

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

L'exemple suivant montre comment créer un flux de travail de distribution à l'aide de la commande create-workflow AWS CLI . Le --data paramètre fait référence à un document YAML qui contient la configuration de distribution pour le flux de travail que vous créez.

Exemple : création d'un flux de travail de distribution 

aws imagebuilder create-workflow --name example-distribution-workflow --semantic-version 1.0.0 --type DISTRIBUTION --data file://example-distribution-workflow.yml

Sortie :

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/distribution/example-distribution-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}