View a markdown version of this page

Verwenden Sie erweiterte AMI-Verteilungsfunktionen - EC2 Image Builder
Entkoppelte VerteilungVersuchen Sie es erneut mit der VerteilungWorkflows zur Verteilung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie erweiterte AMI-Verteilungsfunktionen

Image Builder bietet erweiterte Verteilungsfunktionen, die Ihnen Flexibilität und Kontrolle darüber geben, wie Ihre AMIs auf Regionen und Konten verteilt werden. Diese Funktionen trennen die Verteilung vom Erstellungsprozess, sodass Sie vorhandene Images auf Abruf verteilen, Verteilungsfehler effizient beheben und kontrollierte, mehrstufige Verteilungsstrategien mithilfe anpassbarer Workflows implementieren können.

Sie können die erweiterten AMI-Verteilungsfunktionen in Image Builder verwenden, um Verteilungsaktivitäten direkt durchzuführen, ohne einen vollständigen Image-Build erneut ausführen zu müssen.

Entkoppelte Verteilung

Die DistributeImage API akzeptiert drei Arten von Quellbildreferenzen:

  • AMI-ID — Eine Standard-AMI-ID (zum Beispielami-0abcdef1234567890)

  • SSM-Parameter — Ein SSM-Parameter, der eine AMI-ID speichert (z. B.) ssm:/my/ami/parameter

  • ARN der Image Builder-Version — Ein ARN der Image Builder-Image-Version

Versuchen Sie es erneut mit der Verteilung

Wenn eine Bildverteilung fehlschlägt, verwenden Sie die RetryImage API, um die Verteilung erneut zu versuchen. Dadurch wird der Zeitaufwand für die Behebung der Fehlerursache reduziert, da eine vollständige Image-Neuerstellung vermieden wird. Verwenden Sie diese Option, RetryImage nachdem Sie die Ursache des Verteilungsfehlers behoben haben.

Die RetryImage API akzeptiert einen ARN der Image-Build-Version (z. B.arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1). Wenn Sie die API aufrufen, nimmt Image Builder den Verteilungsvorgang automatisch ab dem Zeitpunkt des Fehlers wieder auf und verwendet dabei die ursprüngliche Verteilungskonfiguration und -einstellungen. Die RetryImage API kann Verteilungen, die während der Verteilungsphase, Testphase oder Integrationsphase fehlgeschlagen sind, erneut versuchen. Sie funktioniert mit AMIs in den folgenden Zuständen: ausstehend, fehlgeschlagen, gelöscht oder verfügbar.

Voraussetzungen

Stellen Sie Folgendes sicher, bevor Sie eine Verteilung erneut versuchen:

  • Sie haben die Ursache des Fehlers identifiziert und behoben. Einzelheiten zu den Fehlern finden Sie in den CloudWatch Verteilungsprotokollen in den Protokollen.

  • Sie verfügen über die erforderlichen IAM-Berechtigungen, um den Image-Build erneut zu versuchen.

  • Stellen Sie bei Fehlern bei der kontoübergreifenden Verteilung sicher, dass EC2ImageBuilderDistributionCrossAccountRole dem Zielkonto die Ec2ImageBuilderCrossAccountDistributionAccess Richtlinie zugeordnet ist.

Wichtig: Ein erneuter Versuch, ohne das zugrunde liegende Problem zu beheben, führt zu wiederholten Fehlern.

Workflows zur Verteilung

Verteilungsworkflows sind ein neuer Workflowtyp, der Erstellungs- und Testworkflows ergänzt und es Ihnen ermöglicht, den Verteilungsprozess mit sequentiellen Schritten zu definieren und zu steuern. Mithilfe von Verteilungsworkflows können Sie benutzerdefinierte Verteilungsprozesse erstellen, die AMI-Kopiervorgänge, Prüfpunkte zum Warten auf eine Aktion, Änderungen an Bildattributen und andere Schritte im Zusammenhang mit der Verteilung umfassen. Auf diese Weise haben Sie eine strukturierte Kontrolle darüber, wie Ihre AMIs verteilt werden, und zwar mit schrittweiser Transparenz, Funktionen zur parallelen Verteilung und detaillierten Fehlerberichten.

Weitere Informationen zum Erstellen und Anpassen von Workflows finden Sie unter Image-Workflows verwalten.