View a markdown version of this page

Crea e aggiorna le impostazioni di distribuzione per le immagini dei contenitori - EC2 Image Builder
Crea le impostazioni di distribuzione per le immagini dei contenitori di Image Builder da AWS CLIAggiorna le impostazioni di distribuzione per l'immagine del contenitore da AWS CLI

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 e aggiorna le impostazioni di distribuzione per le immagini dei contenitori

Questa sezione descrive la creazione e l'aggiornamento delle impostazioni di distribuzione per le immagini del contenitore di Image Builder.

Crea le impostazioni di distribuzione per le immagini dei contenitori di Image Builder da AWS CLI

Una configurazione di distribuzione consente di specificare il nome e la descrizione dell'immagine del contenitore di output e di replicare l'immagine del contenitore in altre AWS regioni. È inoltre possibile applicare tag separati alla risorsa di configurazione della distribuzione e alle immagini del contenitore all'interno di ciascuna regione.

  1. Creazione di un file JSON di input nella CLI

    Usa il tuo strumento di modifica dei file preferito per creare un file JSON con le chiavi mostrate nell'esempio seguente, più i valori validi per il tuo ambiente. In questo esempio viene utilizzato un file denominato create-container-distribution-configuration.json:

    {
	"name": "distribution-configuration-name",
	"description": "Distributes container image to Amazon ECR repository in two regions.",
	"distributions": [
		{
			"region": "us-west-2",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
				"containerTags": ["west2", "image1"]
			}
		},
		{
			"region": "us-east-1",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
			   "containerTags": ["east1", "imagedist"]
			}
		}
	],
	"tags": {
	   "DistributionConfigurationTestTagKey1": "DistributionConfigurationTestTagValue1",
	   "DistributionConfigurationTestTagKey2": "DistributionConfigurationTestTagValue2"
	}
}
  2. Esegui il comando seguente utilizzando il file creato come input.
    aws imagebuilder create-distribution-configuration --cli-input-json file://create-container-distribution-configuration.json
    Nota

    • È necessario includere l'annotazione file:// all'inizio del percorso del file JSON.

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

    Per informazioni più dettagliate, vedere create-distribution-configuration nel Command Reference. AWS CLI

Aggiorna le impostazioni di distribuzione per l'immagine del contenitore da AWS CLI

L'esempio seguente mostra come utilizzare il update-distribution-configuration comando per aggiornare le impostazioni di distribuzione per l'immagine del contenitore, utilizzando il AWS CLI. Puoi anche aggiornare i tag per le immagini dei contenitori all'interno di ciascuna regione.

  1. Creazione di un file JSON di input nella CLI

    Usa il tuo strumento di modifica dei file preferito per creare un file JSON con le chiavi mostrate nell'esempio seguente, più i valori validi per il tuo ambiente. In questo esempio viene utilizzato un file denominato update-container-distribution-configuration.json:

    {
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-container-distribution-configuration.json",
	"description": "Distributes container image to Amazon ECR repository in two regions.",
	"distributions": [
		{
			"region": "us-west-2",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
				"containerTags": ["west2", "image1"]
			}
		},
		{
			"region": "us-east-2",
			"containerDistributionConfiguration": {
				"description": "My test image.",
				"targetRepository": {
					"service": "ECR",
					"repositoryName": "testrepo"
				},
			   "containerTags": ["east2", "imagedist"]
			}
		}
	]
}
  2. Esegui il comando seguente, utilizzando il file creato come input:
    aws imagebuilder update-distribution-configuration --cli-input-json file://update-container-distribution-configuration.json
    Nota

    • È necessario includere l'annotazione file:// all'inizio del percorso del file JSON.

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

    Per informazioni più dettagliate, vedere update-distribution-configuration nel Command Reference. AWS CLI Per aggiornare i tag per la risorsa di configurazione della distribuzione, consulta la Aggiunta di tag alle risorse sezione.