Configurer la distribution d'AMI entre comptes avec Image Builder

Pour utiliser les AMI Image Builder distribuées entre les comptes, le propriétaire du compte de destination doit créer un nouveau rôle IAM dans son compte appeléEC2ImageBuilderDistributionCrossAccountRole.

Ils doivent associer le Ec2ImageBuilderCrossAccountDistributionAccess policy au rôle pour permettre la distribution entre comptes. Pour plus d'informations sur les politiques gérées, voir Stratégies gérées et politiques intégrées dans le Guide de l'Gestion des identités et des accès AWS utilisateur.

Vérifiez que l'ID du compte source est ajouté à la politique de confiance associée au rôle IAM du compte de destination. L'exemple suivant montre une politique de confiance dans le compte de destination qui spécifie l'ID du compte source.

Pour plus d'informations sur les politiques de confiance, consultez la section Resource-Based Politiques du Guide de Gestion des identités et des accès AWS l'utilisateur.

Si l'AMI que vous distribuez est cryptée, le propriétaire du compte de destination doit ajouter la politique EC2ImageBuilderDistributionCrossAccountRole en ligne suivante à son compte afin de pouvoir utiliser vos clés KMS. La Principal section contient leur numéro de compte. Cela permet à Image Builder d'agir en leur nom lorsqu'il AWS KMS crypte et déchiffre l'AMI avec les clés appropriées pour chaque région.

Pour plus d'informations sur les politiques intégrées, consultez la section Politiques intégrées dans le Guide de l'Gestion des identités et des accès AWS utilisateur.

Si vous utilisez launchTemplateConfigurations pour spécifier un modèle de lancement Amazon EC2, vous devez également ajouter la politique suivante EC2ImageBuilderDistributionCrossAccountRole à votre compte de destination.

Si vous utilisez un AWS Systems Manager paramètre Parameter Store pour stocker l'ID AMI de l'AMI de sortie pour le compte de distribution et la région, vous devez ajouter la politique suivante EC2ImageBuilderDistributionCrossAccountRole à votre compte de destination.

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 une liste des paramètres de distribution créés sous votre compte.

En haut de la page Paramètres de distribution, choisissez Créer des paramètres de distribution. Cela vous amène à la page Créer des paramètres de distribution.

Dans la section Type d'image, choisissez Amazon Machine Image (AMI) comme type de sortie. Il s’agit du paramètre par défaut.

Dans la section Général, entrez le nom de la ressource de paramètres de distribution que vous souhaitez créer (obligatoire).

Dans la section Paramètres régionaux, entrez un identifiant de compte à 12 chiffres auquel vous souhaitez distribuer votre AMI dans les comptes Target de la région sélectionnée, puis appuyez sur Entrée. Cela vérifie le formatage correct, puis affiche l'identifiant de compte que vous avez saisi sous la case. Répétez le processus pour ajouter d'autres comptes.

Pour supprimer un compte que vous avez saisi, choisissez le X affiché à droite de l'identifiant du compte.

Entrez le nom de l'AMI de sortie pour chaque région.

Continuez à spécifier les paramètres supplémentaires dont vous avez besoin, puis choisissez Créer des paramètres pour créer votre nouvelle ressource de paramètres de distribution.

Configuration d'un fichier de paramètres de distribution

Avant d'utiliser la create-image commande du AWS CLI pour créer une AMI Image Builder distribuée à un autre compte, vous devez créer une structure DistributionConfiguration JSON qui spécifie les ID de compte cible dans les AmiDistributionConfiguration paramètres. Vous devez en spécifier au moins un AmiDistributionConfiguration dans la région source.

L'exemple de fichier suivant, intitulécreate-distribution-configuration.json, montre la configuration de la distribution d'images entre comptes dans la région source.

{
	"name": "cross-account-distribution-example",
	"description": "Cross Account Distribution Configuration Example",
	"distributions": [
		{
			"amiDistributionConfiguration": {
				"targetAccountIds": ["123456789012", "987654321098"],
				"name": "Name {{ imagebuilder:buildDate }}", 
				"description": "ImageCopy Ami Copy Configuration"
			}, 
			"region": "us-west-2"
		}
	]
}

Création des paramètres de distribution

Pour créer une ressource de paramètres de distribution d'Image Builder à l'aide de la commande create-distribution-configuration du AWS CLI, indiquez les paramètres suivants dans la commande :

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