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
<a name="cli-create-image-pipeline"></a>

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 ab`schedule`, 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 unter[Verwenden Sie Cron-Ausdrücke in Image Builder](cron-expressions.md).
+ `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 der 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 verwendet`create-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 die`file://`-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.

1. 

**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](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-image-pipeline.html) in der *AWS CLI -Referenz*.

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