View a markdown version of this page

Mettez à jour les pipelines d'images de conteneurs à partir du AWS CLI - 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.

Mettez à jour les pipelines d'images de conteneurs à partir du AWS CLI

Vous pouvez mettre à jour un pipeline d'images de conteneur à l'aide d'un fichier JSON comme entrée de la update-image-pipeline commande dans le AWS CLI. Pour configurer le fichier JSON, vous devez disposer des Amazon Resource Names (ARN) pour référencer les ressources existantes suivantes :

  • Pipeline d'images à mettre à jour

  • Recette de contenant

  • Configuration de l’infrastructure

  • Paramètres de distribution (s'ils sont inclus dans le pipeline actuel)

Note

Si la ressource des paramètres de distribution est incluse, le référentiel ECR spécifié comme référentiel cible dans les paramètres de distribution de la région où la commande s'exécute (région 1) a priorité sur le référentiel cible spécifié dans la recette du conteneur.

Procédez comme suit pour mettre à jour un pipeline d'images de conteneur à l'aide de la update-image-pipeline commande suivante AWS CLI :

Note

La update-image-pipeline commande remplace la configuration complète du pipeline. Vous devez spécifier toutes les propriétés requises dans la demande de mise à jour. Incluez toutes les propriétés, qu'il s'agisse des propriétés que vous souhaitez modifier ou des propriétés qui doivent rester inchangées. Les propriétés que vous omettez sont rétablies aux valeurs par défaut ou supprimées.

Pour empêcher la suppression involontaire de paramètres existants, utilisez la get-image-pipeline commande pour récupérer la configuration actuelle. Modifiez ensuite uniquement les champs que vous souhaitez modifier :

aws imagebuilder get-image-pipeline --image-pipeline-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-container-pipeline

Utilisez le résultat comme base pour le fichier JSON de demande de mise à jour.

  1. Créer un fichier JSON d'entrée CLI

    Utilisez votre outil d'édition de fichiers préféré pour créer un fichier JSON avec les clés suivantes, ainsi que des valeurs valides pour votre environnement. Cet exemple utilise un fichier nommécreate-component.json :

    {
	"imagePipelineArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline",
	"containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-example-recipe/2020.12.08",
	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/my-example-distribution-configuration",
	"imageTestsConfiguration": {
		"imageTestsEnabled": true,
		"timeoutMinutes": 120
	},
	"schedule": {
		"scheduleExpression": "cron(0 0 * * MON *)",
		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
	},
	"status": "DISABLED"
}
    Note

    • Vous devez inclure l'option file:// au début du chemin du fichier JSON.

    • Le chemin d'accès du fichier JSON doit suivre la convention appropriée pour le système d'exploitation de base sur lequel vous exécutez la commande. Par exemple, Windows utilise la barre oblique inverse (\) pour faire référence au chemin du répertoire, tandis que Linux et macOS utilisent la barre oblique (/).

  2. Exécutez la commande suivante en utilisant le fichier que vous avez créé en entrée.

    aws imagebuilder update-image-pipeline --cli-input-json file://update-image-pipeline.json