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 benutzerdefinierte Bilder mit Image Builder
Es gibt verschiedene Möglichkeiten, ein neues Image Builder zu erstellen. Sie können beispielsweise eine der folgenden Methoden verwenden, um ein Bild mit dem AWS-Managementkonsole oder zu erstellen AWS CLI. Sie können auch die [CreateImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html)API-Aktion verwenden oder eine Build-Pipeline ausführen, um das Image zu erstellen. Die mit der API-Aktion verknüpfte SDK-Anfrage finden Sie unter dem Link „[Siehe auch](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImage.html#API_CreateImage_SeeAlso)“ für diesen Befehl in der *EC2 Image Builder API-Referenz.*
------
#### [ AWS-Managementkonsole ]
Um ein neues Image aus einer vorhandenen Pipeline zu erstellen, können Sie die Pipeline wie folgt manuell ausführen. Sie können auch den Pipeline-Assistenten verwenden, um ein neues Image von Grund auf neu zu erstellen. Je nach Art des Bilds[Pipeline-Assistent: Container-Image erstellen](start-build-container-pipeline.md), das Sie erstellen möchten, finden Sie unter [Pipeline-Assistent: AMI erstellen](start-build-image-pipeline.md) oder.
1. Öffnen Sie die EC2 Image Builder Builder-Konsole unter [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Wählen Sie im Navigationsbereich **Image-Pipelines** aus.
1. Aktivieren Sie das Kontrollkästchen neben dem **Namen der Pipeline**, die Sie ausführen möchten.
1. Um das Image zu erstellen, wählen Sie im Menü **Aktionen** die Option **Pipeline ausführen** aus. Dadurch wird die Pipeline gestartet.
Sie können auch einen Zeitplan für den Betrieb Ihrer Pipeline angeben oder Amazon verwenden, EventBridge um Ihre Pipeline auf der Grundlage der von Ihnen konfigurierten Regeln auszuführen.
------
#### [ AWS CLI ]
Bevor Sie den **[create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html)** Befehl in der ausführen AWS CLI, müssen Sie die folgenden Ressourcen erstellen, sofern sie noch nicht vorhanden sind:
**Erforderliche -Ressourcen**
+ **Rezept** — Sie müssen genau ein Rezept für Ihr Bild angeben, und zwar wie folgt:
Bildrezept
Geben Sie mit dem `--image-recipe-arn` Parameter den Amazon-Ressourcennamen (ARN) für Ihre Bildrezeptressource an.
Rezept für Container
Geben Sie den ARN für Ihre Container-Rezeptressource mit dem `--container-recipe-arn` Parameter an.
+ **Infrastrukturkonfiguration** — Geben Sie den ARN für Ihre Infrastrukturkonfigurationsressource mit dem `--infrastructure-configuration-arn` Parameter an.
Sie können auch jede der folgenden Ressourcen angeben, die Ihr Image benötigt:
**Optionale Ressourcen und Konfiguration**
+ **Verteilungskonfiguration** — Standardmäßig verteilt Image Builder die Ausgabe-Image-Ressource an Ihr Konto in der Region, in der Sie den **create-image** Befehl ausführen. Um zusätzliche Ziele oder Konfigurationen für Ihre Distribution bereitzustellen, geben Sie den ARN für Ihre Distributionskonfigurationsressource mit dem `--distribution-configuration-arn` Parameter an.
+ **Scannen von Bildern** — Verwenden Sie den `--image-scanning-configuration` Parameter, um Schnappschüsse für Amazon Inspector Inspector-Ergebnisse auf Ihrer Image- oder Container-Testinstanz zu konfigurieren. Für Container-Images geben Sie auch das ECR-Repository an, das Amazon Inspector für seine Scans verwendet.
+ **Image-Tests** — Verwenden Sie den `--image-tests-configuration` Parameter, um die Image Builder Builder-Testphase zu unterdrücken. Alternativ können Sie ein Timeout für die Dauer der Ausführung festlegen.
+ **Bild-Tags** — Verwenden Sie den `--tags` Parameter, um Ihrer Ausgabe-Bildressource Tags hinzuzufügen.
+ **Image-Workflows** — Wenn Sie keine Build- oder Test-Workflows angeben, erstellt Image Builder Ihr Image mit seinem Standard-Image-Workflow. Verwenden Sie den `--workflows` Parameter, um die von Ihnen erstellten Workflows anzugeben.
**Anmerkung**
Wenn Sie Image-Workflows angeben, müssen Sie im `--execution-role` Parameter auch den Namen oder ARN der IAM-Rolle angeben, die Image Builder zur Ausführung Ihrer Workflow-Aktionen verwendet.
Das folgende Beispiel zeigt, wie Sie mit dem Befehl [AWS CLI create-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-image.html) ein Image erstellen. Weitere Informationen finden Sie in der *AWS CLI -Befehlsreferenz*.
**Beispiel: Erstellen Sie ein einfaches Image mit Standardverteilung**
```
aws imagebuilder create-image --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/simple-recipe-linux/1.0.0 --infrastructure-configuration-arn arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/simple-infra-config-linux
```
**Ausgabe:**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0",
"name": "simple-recipe-linux",
...
}
]
}
```
------
## Brechen Sie die Image-Erstellung vom ab AWS CLI
Um einen laufenden Image-Build abzubrechen, verwenden Sie den **cancel-image-creation** Befehl wie folgt:
```
aws imagebuilder cancel-image-creation --image-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/my-example-recipe/2019.12.03/1
```