Crea e aggiorna le configurazioni di distribuzione AMI

Apri la console EC2 Image Builder all'indirizzo https://console.aws.amazon.com/imagebuilder/.

Scegli Impostazioni di distribuzione dal pannello di navigazione. Questo mostra un elenco delle configurazioni di distribuzione create con il tuo account.

Scegli Crea impostazioni di distribuzione nella parte superiore del pannello delle impostazioni di distribuzione.

Nella sezione Tipo di immagine, scegli il tipo di output Amazon Machine Image (AMI).

Nella sezione Generale, inserisci un nome per la configurazione della distribuzione e una descrizione opzionale.

Nella sezione Impostazioni della regione, inserisci i seguenti dettagli per ciascuna regione in cui stai distribuendo il tuo AMI:

1. Per impostazione predefinita, l'AMI viene distribuito nella regione corrente (Regione 1). La regione 1 è la fonte della distribuzione. Alcune impostazioni per la Regione 1 non possono essere modificate. Per tutte le regioni che aggiungi, puoi sceglierne una dall'elenco a discesa Regione.

   La chiave Kms identifica AWS KMS key quella utilizzata per crittografare i volumi EBS per l'immagine nella regione di destinazione. È importante notare che ciò non si applica all'AMI originale creata dalla build con il tuo account nella Regione di origine (Regione 1). La crittografia eseguita durante la fase di distribuzione della build è valida solo per le immagini distribuite ad altri account o regioni.

   Per crittografare i volumi EBS per l'AMI creata nella regione di origine del tuo account, devi impostare la chiave KMS nella mappatura dei dispositivi del blocco di ricette delle immagini (Archiviazione (volumi) nella console).

   Image Builder copia l'AMI negli account Target specificati per la regione.

   Prerequisito

   Per copiare un'immagine tra gli account, è necessario creare il EC2ImageBuilderDistributionCrossAccountRole ruolo in tutti gli account del target di distribuzione e allegare al ruolo la policy Ec2ImageBuilderCrossAccountDistributionAccess policy gestita.

   Il nome Output AMI è facoltativo. Se fornisci un nome, il nome dell'AMI di output finale include un timestamp aggiunto di quando l'AMI è stata creata. Se non si specifica un nome, Image Builder aggiunge il timestamp di compilazione al nome della ricetta. Ciò garantisce nomi AMI univoci per ogni build.

   1. Con la condivisione AMI, puoi concedere l'accesso a AWS Principal specifici per avviare istanze dalla tua AMI. Se espandi la sezione di condivisione AMI, puoi inserire i seguenti dettagli:

      • Autorizzazioni di avvio: seleziona Privato se desideri mantenere privata la tua AMI e consentire l'accesso a AWS Principal specifici per avviare un'istanza dalla tua AMI privata. Seleziona Pubblico se desideri rendere pubblica la tua AMI. Qualsiasi AWS principale può lanciare un'istanza dalla tua AMI pubblica.

      • Principal: puoi concedere l'accesso ai seguenti tipi di AWS Principal per avviare le istanze:

        • AWS account: concedi l'accesso a un account specifico AWS

        • Unità organizzativa (OU): concede l'accesso a un'unità organizzativa e a tutte le relative entità secondarie. Le entità secondarie includono unità organizzative e AWS account.

        • Organizzazione: concedi l'accesso alla tua AWS Organizations e a tutte le relative entità secondarie. Le entità secondarie includono unità organizzative e AWS account.

          Innanzitutto, seleziona il tipo di principale. Quindi inserisci l'ID del AWS mandante a cui desideri concedere l'accesso nella casella a destra dell'elenco a discesa. Puoi inserire più ID di diversi tipi.

   2. È possibile espandere la sezione Configurazione della licenza per allegare le configurazioni di licenza create con AWS License Manager alle immagini di Image Builder. Le configurazioni di licenza contengono regole di licenza basate sui termini degli accordi aziendali. Image Builder include automaticamente le configurazioni di licenza associate all'AMI di base.

   3. È possibile espandere la sezione di configurazione del modello di avvio per specificare un modello di lancio EC2 da utilizzare per avviare le istanze dall'AMI creata.

      Se stai utilizzando un modello di lancio EC2, puoi indicare a Image Builder di creare una nuova versione del modello di lancio che includa l'ID AMI più recente al termine della compilazione. Per aggiornare il modello di lancio, configura le impostazioni come segue:

      • Nome del modello di avvio: seleziona il nome del modello di avvio che desideri che Image Builder aggiorni.

      • Imposta la versione predefinita: seleziona questa casella di controllo per aggiornare la versione predefinita del modello di avvio alla nuova versione.

      Per aggiungere un'altra configurazione del modello di avvio, scegli Aggiungi configurazione del modello di avvio. Puoi avere fino a cinque configurazioni del modello di avvio per regione.

   4. Puoi espandere la sezione delle configurazioni dei parametri SSM per configurare un parametro SSM che memorizzerà l'ID AMI di output per l'immagine distribuita nella regione di destinazione. È possibile specificare facoltativamente un account di distribuzione nella regione.

      Nome del parametro: immettete il nome del parametro. Ad esempio, /output/image/param.

      Tipo di dati: mantiene il valore predefinito (AWS EC2 Image). Ciò indica a Systems Manager di convalidare il valore del parametro per assicurarsi che sia un ID AMI valido.

2. Per aggiungere le impostazioni di distribuzione per un'altra regione, scegli Aggiungi regione.

Quando hai finito, scegli Crea impostazioni.

Creazione di un file JSON di input nella CLI

Usa uno strumento di modifica dei file per creare un file JSON con le chiavi mostrate in uno degli esempi seguenti e valori validi per il tuo ambiente. Questi esempi definiscono quali Account AWS unità AWS Organizations organizzative (OU) sono autorizzate a lanciare l'AMI che distribuisci nelle regioni specificate. Assegna un nome al filecreate-ami-distribution-configuration.json, da utilizzare nella fase successiva:

Esempio 1: distribuisci a Account AWS

Questo esempio distribuisce un'AMI in due regioni e specifica Account AWS che dispongono delle autorizzazioni di avvio in ciascuna regione.

{
	"name": "MyExampleAccountDistribution",
	"description": "Copies AMI to eu-west-1, and specifies accounts that can launch instances in each Region.",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{imagebuilder:buildDate}}",
				"description": "An example image name with parameter references",
				"amiTags": {
					"KeyName": "Some Value"
				},
				"launchPermission": {
					"userIds": [
						"987654321012"
					]
				}
			}
		},
		{
			"region": "eu-west-1",
			"amiDistributionConfiguration": {
				"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
				"amiTags": {
					"KeyName": "Some value"
				},
				"launchPermission": {
					"userIds": [
						"100000000001"
					]
				}
			}
		}
	]
}

Esempio 2: distribuzione a organizzazioni e unità organizzative

Questo esempio distribuisce un'AMI nella regione di origine e specifica le autorizzazioni di avvio dell'organizzazione e dell'unità organizzativa.

{
	"name": "MyExampleAWSOrganizationDistribution",
	"description": "Shares AMI with the Organization and OU",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{ imagebuilder:buildDate }}",
				"launchPermission": {
					"organizationArns": [
						"arn:aws:organizations::123456789012:organization/o-myorganization123"
					],
					"organizationalUnitArns": [
						"arn:aws:organizations::123456789012:ou/o-123example/ou-1234-myorganizationalunit"
					]
				}
			}
		}
	]
}

Esempio 3: memorizza l'ID AMI di uscita in un parametro SSM

Questo esempio memorizza l'ID AMI di output in un AWS Systems Manager parametro Parameter Store nella regione di distribuzione.

{
	"name": "SSMParameterOutputAMI",
	"description": "Updates an SSM parameter with the output AMI ID for the distribution.",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{ imagebuilder:buildDate }}"
			},
			"ssmParameterConfigurations": [
				{
					"amiAccountId": "111122223333",
					"parameterName": "/output/image/param",
					"dataType": "aws:ec2:image"
				}
			]
		}
	]
}

Esegui il comando seguente utilizzando il file creato come input.

aws imagebuilder create-distribution-configuration --cli-input-json file://create-ami-distribution-configuration.json

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

Apri la console EC2 Image Builder all'indirizzo https://console.aws.amazon.com/imagebuilder/.

Scegli Impostazioni di distribuzione dal pannello di navigazione. Questo mostra un elenco delle configurazioni di distribuzione create con il tuo account.

Per visualizzare i dettagli o aggiornare una configurazione di distribuzione, scegli il link Nome della configurazione. Si apre la vista dettagliata delle impostazioni di distribuzione.

Per modificare la configurazione della distribuzione, scegli Modifica nell'angolo in alto a destra della sezione Dettagli sulla distribuzione. Alcuni campi sono bloccati, come il nome della configurazione di distribuzione e la regione predefinita visualizzata come Regione 1. Per ulteriori informazioni sulle impostazioni di configurazione della distribuzione, vedereCrea una configurazione di distribuzione AMI.

Al termine, scegli Save changes (Salva modifiche).

Creazione di un file JSON di input nella CLI

Usa uno strumento di modifica dei file per creare un file JSON con le chiavi mostrate nell'esempio seguente e i valori validi per il tuo ambiente. Questo esempio utilizza un file denominato. update-ami-distribution-configuration.json

{
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-ami-distribution-configuration.json",
	"description": "Copies AMI to eu-west-2, and specifies accounts that can launch instances in each Region.",
	"distributions": [
	  {
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{imagebuilder:buildDate}}",
				"description": "An example image name with parameter references",
				"launchPermissions": {
					"userIds": [
						"987654321012"
					]
				}
			}
		},
		{
			"region": "eu-west-2",
			"amiDistributionConfiguration": {
				"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
				"tags": {
					"KeyName": "Some value"
				},
				"launchPermissions": {
					"userIds": [
						"100000000001"
					]
				}
			}
		}
	]
}

Esegui il comando seguente utilizzando il file creato come input.

aws imagebuilder update-distribution-configuration --cli-input-json file://update-ami-distribution-configuration.json

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.