Erstellen Sie eine AMI-Image-Pipeline aus dem AWS CLI - EC2 Image Builder

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.

Erstellen Sie eine AMI-Image-Pipeline aus dem AWS CLI

Um aus dem eine Image-Pipeline zu erstellen AWS CLI, führen Sie den create-image-pipeline Befehl mit den Konfigurationsoptionen aus, die für Ihre Pipeline gelten. Sie haben die Möglichkeit, eine JSON-Datei zu erstellen, die Ihre gesamte Pipeline-Konfiguration enthält, oder die Konfiguration zur Laufzeit anzugeben. In diesem Abschnitt wird die JSON-Konfigurationsdateimethode verwendet, um den Befehl zu vereinfachen.

Wie oft Ihre Pipeline ein neues Image erstellt, um ausstehende Updates aus Ihrem Basis-Image und Ihren Komponenten zu integrieren, hängt davon abschedule, welche Sie konfiguriert haben. A schedule hat die folgenden Attribute:

  • scheduleExpression— Legt den Zeitplan fest, wann Ihre Pipeline ausgeführt wird, um das auszuwerten pipelineExecutionStartCondition und festzustellen, ob ein Build gestartet werden soll. Der Zeitplan ist mit Cron-Ausdrücken konfiguriert. Weitere Informationen zum Formatieren eines Cron-Ausdrucks in Image Builder finden Sie unterVerwenden Sie Cron-Ausdrücke in Image Builder.

  • pipelineExecutionStartCondition— Legt fest, ob Ihre Pipeline den Build starten soll. Gültige Werte sind:

    • EXPRESSION_MATCH_ONLY— Ihre Pipeline erstellt jedes Mal ein neues Image, wenn der Cron-Ausdruck mit der aktuellen Uhrzeit übereinstimmt.

    • EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE— Ihre Pipeline wird keinen neuen Image-Build starten, es sei denn, es stehen noch Änderungen an Ihrem Basis-Image oder Ihren Komponenten aus.

Wenn Sie den create-image-pipeline Befehl in ausführen AWS CLI, sind viele der Konfigurationsressourcen optional. Für einige Ressourcen gelten jedoch bedingte Anforderungen, die davon abhängen, welchen Image-Typ die Pipeline erstellt. Die folgenden Ressourcen-IDs sind für AMI-Image-Pipelines erforderlich:

  • Bildrezept ARN

  • Konfiguration der Infrastruktur ARN

 

Beispiel: Erstellen Sie ein Windows 2019-Image

In diesem Beispiel wird eine Pipeline konfiguriert, die so geplant ist, dass sie einmal pro Woche am Sonntag ausgeführt wird. Die im ersten Schritt gezeigte Konfigurationsdatei verwendet vorhandene Ressourcen für die Image-Rezeptur-, Infrastruktur- und Verteilungskonfiguration sowie andere Einstellungen, um ein Windows 2019-Image zu erstellen.

  1. Erstellen Sie eine Konfigurationsdatei (optional)

    In diesem Beispiel wird eine Konfigurationsdatei mit dem Namen verwendetcreate-image-pipeline.json, um die Einstellungen an einem Ort zu konfigurieren. Alternativ können Sie bei der Ausführung des Befehls Befehlszeilenoptionen verwenden, um alle Details anzugeben, die hier in der Konfigurationsdatei angezeigt werden.

    {
	"name": "ExampleWindows2019Pipeline",
	"description": "Builds Windows 2019 Images",
	"enhancedImageMetadataEnabled": true,
	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-recipe/2020.12.03",
	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/my-example-distribution-configuration",
	"imageTestsConfiguration": {
		"imageTestsEnabled": true,
		"timeoutMinutes": 60
	},
	"schedule": {
		"scheduleExpression": "cron(0 0 * * SUN *)",
		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
	},
	"status": "ENABLED"
}
    Anmerkung

    • Sie müssen diefile://-Notation am Anfang des JSON-Dateipfades.

    • Der Pfad für die JSON-Datei sollte der entsprechenden Konvention für das Basisbetriebssystem folgen, auf dem Sie den Befehl ausführen. Windows verwendet beispielsweise den umgekehrten Schrägstrich (\), um auf den Verzeichnispfad zu verweisen, während Linux und macOS den Schrägstrich (/) verwenden.

  2. Führen Sie den Befehl aus, um ein Bild zu erstellen

    In diesem Beispiel wird die im ersten Schritt erstellte Konfigurationsdatei als Eingabe für den create-image-pipeline Befehl verwendet. Alternativ können Sie die Einstellungen und Ressourcen für Ihre Pipeline direkt angeben, wenn Sie den Befehl ausführen. Weitere Informationen finden Sie unter create-image-pipeline in der AWS CLI -Referenz.

    aws imagebuilder create-image-pipeline --cli-input-json file://create-image-pipeline.json