Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisez des fonctionnalités de distribution d'AMI améliorées
Image Builder propose des fonctionnalités de distribution avancées qui vous offrent flexibilité et contrôle sur la manière dont vous AMIs êtes distribué entre les régions et les comptes. Ces fonctionnalités séparent la distribution du processus de création, ce qui vous permet de distribuer des images existantes à la demande, de remédier efficacement aux défaillances de distribution et de mettre en œuvre des stratégies de distribution contrôlées en plusieurs étapes grâce à des flux de travail personnalisables.
Vous pouvez utiliser les fonctionnalités de distribution d'AMI améliorées d'Image Builder pour effectuer directement des activités de distribution sans avoir à réexécuter une génération d'image complète.
Distribution découplée
L' DistributeImage API accepte trois types de références d'image source :
-
ID AMI : identifiant d'AMI standard (par exemple,
ami-0abcdef1234567890) -
Paramètre SSM : paramètre SSM qui stocke un ID d'AMI (par exemple,)
ssm:/my/ami/parameter -
Image Builder version ARN — Une image Image Builder version ARN
Nouvelle tentative de distribution
Si la distribution d'une image échoue, utilisez l'RetryImageAPI pour réessayer la distribution. Cela permet de réduire le temps nécessaire pour résoudre la cause de la panne en évitant une reconstruction complète de l'image. À utiliser RetryImage après avoir résolu la cause sous-jacente de l'échec de distribution.
L' RetryImage API accepte une version ARN de génération d'image (par exemple,arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1). Lorsque vous appelez l'API, Image Builder reprend automatiquement le processus de distribution à partir du point d'échec en utilisant la configuration et les paramètres de distribution d'origine. L'RetryImageAPI peut réessayer les distributions qui ont échoué pendant la phase de distribution, la phase de test ou la phase d'intégration. Il fonctionne AMIs dans les états suivants : en attente, en échec, supprimé ou disponible.
Prérequis
Avant de réessayer une distribution, vérifiez les points suivants :
-
Vous avez identifié et résolu la cause première de l'échec. Consultez les journaux de distribution dans CloudWatch Logs pour obtenir des informations détaillées sur les erreurs.
-
Vous disposez des autorisations IAM nécessaires pour réessayer de créer l'image.
-
En cas d'échec de distribution entre comptes, vérifiez que
EC2ImageBuilderDistributionCrossAccountRolelaEc2ImageBuilderCrossAccountDistributionAccesspolitique est attachée au compte de destination.
Important : Toute nouvelle tentative sans résoudre le problème sous-jacent entraînera des échecs répétés.
Flux de travail de distribution
Les flux de travail de distribution sont un nouveau type de flux de travail qui complète les flux de travail de création et de test, vous permettant de définir et de contrôler le processus de distribution à l'aide d'étapes séquentielles. Les flux de travail de distribution vous permettent de créer des processus de distribution personnalisés qui incluent des opérations de copie d'AMI, des wait-for-action points de contrôle, des modifications d'attributs d'image et d'autres étapes liées à la distribution. Cela permet un contrôle structuré de la manière dont vous AMIs êtes distribué, avec une visibilité par étapes, des fonctionnalités de distribution parallèle et des rapports d'erreurs détaillés.
Pour en savoir plus sur la création et la personnalisation des flux de travail, consultez la section Gérer les flux de travail liés aux images.
