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 façon dont vos AMI sont distribuées 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 les images existantes à la demande, de vous remettre efficacement en cas d'échec de distribution et de mettre en œuvre des stratégies de distribution contrôlées en plusieurs étapes via des flux de travail personnalisables.
Vous pouvez utiliser les fonctionnalités de distribution 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 AMI standard (par exemple,
ami-0abcdef1234567890) -
Paramètre SSM : paramètre SSM qui stocke un ID AMI (par exemple,)
ssm:/my/ami/parameter -
ARN de la version d'Image Builder — Un ARN de version d'image d'Image Builder
Nouvelle tentative de distribution
Si la distribution d'une image échoue, utilisez l'RetryImageAPI pour réessayer de la distribuer. Cela réduit 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 un ARN de version 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 des distributions qui ont échoué pendant la phase de distribution, la phase de test ou la phase d'intégration. Il fonctionne avec les AMI dans les états suivants : en attente, en échec, supprimée ou disponible.
Conditions préalables
Avant de réessayer une distribution, assurez-vous de ce qui suit :
-
Vous avez identifié et résolu la cause première de l'échec. Consultez les journaux de distribution dans CloudWatch Logs pour plus de détails sur les erreurs.
-
Vous disposez des autorisations IAM nécessaires pour réessayer de générer l'image.
-
En cas d'échec de distribution entre comptes, vérifiez que
EC2ImageBuilderDistributionCrossAccountRolelaEc2ImageBuilderCrossAccountDistributionAccesspolitique est associée au compte de destination.
Important : Réessayer sans résoudre le problème sous-jacent entraînera des échecs répétés.
Workflows de distribution
Les flux de travail de distribution sont un nouveau type de flux de travail qui complète les flux de création et de test, vous permettant de définir et de contrôler le processus de distribution par étapes séquentielles. Avec les flux de distribution, vous pouvez créer des processus de distribution personnalisés qui incluent des opérations de copie AMI, des points de contrôle en attente d'action, des modifications des attributs d'image et d'autres étapes liées à la distribution. Cela fournit un contrôle structuré sur la façon dont vos AMI sont distribuées, avec une visibilité progressive, des fonctionnalités de distribution parallèle et des rapports d'erreurs granulaires.
Pour en savoir plus sur la création et la personnalisation de flux de travail, voir Gérer les flux de travail liés aux images.
