Création et mise à jour des configurations de distribution AMI

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

Choisissez les paramètres de distribution dans le volet de navigation. Cela affiche la liste des configurations de distribution créées sous votre compte.

Choisissez Créer des paramètres de distribution en haut du panneau des paramètres de distribution.

Dans la section Type d'image, choisissez le type de sortie Amazon Machine Image (AMI).

Dans la section Général, entrez un nom pour votre configuration de distribution, ainsi qu'une description facultative.

Dans la section Paramètres régionaux, entrez les informations suivantes pour chaque région dans laquelle vous distribuez votre AMI :

1. L'AMI est distribuée dans la région actuelle (région 1), par défaut. La région 1 est la source de la distribution. Certains paramètres de la Région 1 ne peuvent pas être modifiés. Pour toutes les régions que vous ajoutez, vous pouvez choisir une région dans la liste déroulante des régions.

   La clé Kms identifie celle AWS KMS key qui est utilisée pour chiffrer les volumes EBS de votre image dans la région cible. Il est important de noter que cela ne s'applique pas à l'AMI d'origine créée par le build sous votre compte dans la région source (région 1). Le cryptage qui s'exécute pendant la phase de distribution de la version concerne uniquement les images distribuées vers d'autres comptes ou régions.

   Pour chiffrer les volumes EBS pour l'AMI créée dans la région source de votre compte, vous devez définir la clé KMS dans l'image, la recette, le bloc, le mappage des appareils (Stockage (volumes) dans la console).

   Image Builder copie l'AMI vers les comptes cibles que vous spécifiez pour la région.

   Prérequis

   Pour copier une image sur plusieurs comptes, vous devez créer le EC2ImageBuilderDistributionCrossAccountRole rôle dans tous les comptes cibles de distribution et associer la politique Ec2ImageBuilderCrossAccountDistributionAccess policy gérée au rôle.

   Le nom de l'AMI de sortie est facultatif. Si vous fournissez un nom, le nom final de l'AMI en sortie inclut un horodatage ajouté indiquant la date de création de l'AMI. Si vous ne spécifiez pas de nom, Image Builder ajoute l'horodatage de génération au nom de la recette. Cela garantit des noms d'AMI uniques pour chaque build.

   1. Avec le partage d'AMI, vous pouvez accorder l'accès à AWS des principaux spécifiques pour lancer des instances à partir de votre AMI. Si vous développez la section Partage d'AMI, vous pouvez saisir les informations suivantes :

      • Autorisations de lancement  : sélectionnez Privé si vous souhaitez préserver la confidentialité de votre AMI et autoriser l'accès à des AWS principaux spécifiques pour lancer une instance à partir de votre AMI privée. Sélectionnez Public si vous souhaitez rendre votre AMI publique. N'importe quel AWS principal peut lancer une instance depuis votre AMI publique.

      • Principaux  : vous pouvez accorder l'accès aux types de AWS principaux suivants pour lancer des instances :

        • AWS compte — Autoriser l'accès à un AWS compte spécifique

        • Unité organisationnelle (UO)  : accordez l'accès à une UO et à toutes ses entités enfants. Les entités enfants incluent les unités d'organisation et AWS les comptes.

        • Organisation  : accordez l'accès à vos AWS Organizations entités et à toutes ses entités enfants. Les entités enfants incluent les unités d'organisation et AWS les comptes.

          Sélectionnez d'abord le type principal. Entrez ensuite l'ID du AWS principal auquel vous souhaitez accorder l'accès dans la case située à droite de la liste déroulante. Vous pouvez saisir plusieurs identifiants de différents types.

   2. Vous pouvez développer la section Configuration des licences pour joindre les configurations de licence créées avec AWS License Manager à vos images Image Builder. Les configurations de licence contiennent des règles de licence basées sur les termes de vos contrats d'entreprise. Image Builder inclut automatiquement les configurations de licence associées à votre AMI de base.

   3. Vous pouvez développer la section Configuration du modèle de lancement pour spécifier un modèle de lancement EC2 à utiliser pour lancer des instances à partir de l'AMI que vous créez.

      Si vous utilisez un modèle de lancement EC2, vous pouvez demander à Image Builder de créer une nouvelle version de votre modèle de lancement qui inclut le dernier ID AMI une fois la génération terminée. Pour mettre à jour le modèle de lancement, configurez les paramètres comme suit :

      • Nom du modèle de lancement  : sélectionnez le nom du modèle de lancement que vous souhaitez qu'Image Builder mette à jour.

      • Définir la version par défaut  : cochez cette case pour mettre à jour la version par défaut du modèle de lancement vers la nouvelle version.

      Pour ajouter une autre configuration de modèle de lancement, choisissez Ajouter une configuration de modèle de lancement. Vous pouvez avoir jusqu'à cinq configurations de modèles de lancement par région.

   4. Vous pouvez développer la section Configurations des paramètres SSM pour configurer un paramètre SSM qui stockera l'ID AMI de sortie pour l'image distribuée dans la région de destination. Vous pouvez éventuellement spécifier un compte de distribution dans la région.

      Nom du paramètre — Entrez le nom de votre paramètre. Par exemple /output/image/param.

      Type de données — Conservez la valeur par défaut (AWS EC2 Image). Cela indique à Systems Manager de valider la valeur du paramètre pour s'assurer qu'il s'agit d'un ID AMI valide.

2. Pour ajouter des paramètres de distribution pour une autre région, choisissez Ajouter une région.

Choisissez Créer des paramètres lorsque vous avez terminé.

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

Utilisez un outil d'édition de fichiers pour créer un fichier JSON avec les clés illustrées dans l'un des exemples suivants et des valeurs valides pour votre environnement. Ces exemples définissent quelles Comptes AWS unités organisationnelles ( AWS Organizations OU) sont autorisées à lancer l'AMI que vous distribuez dans les régions spécifiées. Donnez un nom au fichiercreate-ami-distribution-configuration.json, à utiliser à l'étape suivante :

Exemple 1 : distribuer à Comptes AWS

Cet exemple distribue une AMI à deux régions et Comptes AWS indique quelles régions disposent d'autorisations de lancement dans chaque région.

{
	"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"
					]
				}
			}
		}
	]
}

Exemple 2 : Distribution aux organisations et aux unités d'organisation

Cet exemple distribue une AMI à la région source et spécifie les autorisations de lancement de l'organisation et de l'unité d'organisation.

{
	"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"
					]
				}
			}
		}
	]
}

Exemple 3 : stocker l'ID AMI de sortie dans un paramètre SSM

Cet exemple enregistre l'ID AMI en sortie dans un AWS Systems Manager paramètre de magasin de paramètres dans la région de distribution.

{
	"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"
				}
			]
		}
	]
}

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

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

Pour plus d'informations, consultez create-distribution-configuration la référence des AWS CLI commandes.

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

Choisissez les paramètres de distribution dans le volet de navigation. Cela affiche la liste des configurations de distribution créées sous votre compte.

Pour afficher les détails ou mettre à jour une configuration de distribution, cliquez sur le lien Nom de la configuration. Cela ouvre la vue détaillée des paramètres de distribution.

Pour modifier la configuration de distribution, choisissez Modifier dans le coin supérieur droit de la section Détails de distribution. Certains champs sont verrouillés, tels que le nom de la configuration de distribution et la région par défaut qui s'affiche en tant que région 1. Pour plus d'informations sur les paramètres de configuration de distribution, consultezCréation d'une configuration de distribution AMI.

Lorsque vous avez terminé, choisissez Save changes (Enregistrer les modifications).

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

Utilisez un outil d'édition de fichiers pour créer un fichier JSON avec les clés illustrées dans l'exemple suivant et des valeurs valides pour votre environnement. Cet exemple utilise un fichier nommé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"
					]
				}
			}
		}
	]
}

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

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

Pour plus d'informations, consultez update-distribution-configuration la référence des AWS CLI commandes. Pour mettre à jour les balises de votre ressource de configuration de distribution, consultez la Balisage des ressources section.