Crea una pipeline di immagini di un contenitore da AWS CLI - EC2Image Builder

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea una pipeline di immagini di un contenitore da AWS CLI

È possibile creare una pipeline di immagini del contenitore utilizzando un JSON file come input per il create-image-pipeline comando in. AWS CLI

La frequenza con cui la pipeline crea una nuova immagine per incorporare eventuali aggiornamenti in sospeso dell'immagine e dei componenti di base dipende dalla configurazioneschedule. A schedule ha i seguenti attributi:

  • scheduleExpression— Imposta la pianificazione dell'esecuzione della pipeline per valutare pipelineExecutionStartCondition e determinare se avviare una build. La pianificazione è configurata con espressioni cron. Per ulteriori informazioni su come formattare un'espressione cron in Image Builder, vedere. Usa le espressioni cron in Image Builder

  • pipelineExecutionStartCondition— Determina se la pipeline deve avviare la compilazione. I valori validi includono:

    • EXPRESSION_MATCH_ONLY— la pipeline creerà una nuova immagine ogni volta che l'espressione cron corrisponde all'ora corrente.

    • EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE— la pipeline non avvierà una nuova creazione di immagini a meno che non vi siano modifiche in sospeso all'immagine o ai componenti di base.

Quando si esegue il create-image-pipeline comando in AWS CLI, molte risorse di configurazione sono opzionali. Tuttavia, alcune risorse hanno requisiti condizionali, a seconda del tipo di immagine creata dalla pipeline. Le seguenti risorse sono necessarie per le pipeline di immagini dei contenitori:

  • Ricetta del contenitore ARN

  • Configurazione dell'infrastruttura ARN

Se non includi una risorsa di configurazione della distribuzione quando esegui il create-image-pipeline comando, l'immagine di output viene archiviata nel ECR repository specificato come repository di destinazione nella ricetta del contenitore nella regione in cui esegui il comando. Se includi una risorsa di configurazione della distribuzione per la tua pipeline, viene utilizzato il repository di destinazione che hai specificato per la prima regione della distribuzione.

  1. Crea un file di input CLI JSON

    Usa il tuo strumento di modifica dei file preferito per creare un JSON file con le seguenti chiavi, oltre a valori validi per il tuo ambiente. In questo esempio viene utilizzato un file denominato create-image-pipeline.json:

    {
	"name": "MyWindows2019Pipeline",
	"description": "Builds Windows 2019 Images",
	"enhancedImageMetadataEnabled": true,
	"containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-example-recipe/2020.12.03",
	"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": 60
	},
	"schedule": {
		"scheduleExpression": "cron(0 0 * * SUN *)",
		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
	},
	"status": "ENABLED"
}
    Nota

    • È necessario includere la file:// notazione all'inizio del percorso del JSON file.

    • Il percorso del JSON file deve seguire la convenzione appropriata per il sistema operativo di base su cui viene eseguito il comando. Ad esempio, Windows utilizza la barra rovesciata (\) per fare riferimento al percorso della directory, mentre Linux e macOS utilizzano la barra (/).

  2. Esegui il comando seguente utilizzando il file creato come input.

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