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.
# Konfiguration der AMI-Verteilung mit einer EC2-Startvorlage
Um ein einheitliches Starterlebnis für Ihr Image Builder Builder-AMI in Zielkonten und Regionen zu gewährleisten, können Sie in Ihren Vertriebseinstellungen eine Amazon EC2 EC2-Startvorlage angeben, indem `launchTemplateConfigurations` Sie. Wenn sie während des Verteilungsprozesses vorhanden `launchTemplateConfigurations` sind, erstellt Image Builder eine neue Version der Startvorlage, die alle ursprünglichen Einstellungen aus der Vorlage und die neue AMI-ID aus dem Build enthält. Weitere Informationen zum Starten einer EC2-Instance mithilfe einer Startvorlage finden Sie je nach Zielbetriebssystem unter einem der folgenden Links.
+ [Starten Sie eine Linux-Instance über eine Startvorlage](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
+ [Starten Sie eine Windows-Instanz über eine Startvorlage](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
**Anmerkung**
Wenn Sie Ihrem Image eine Startvorlage hinzufügen, um Windows Fast Launch zu aktivieren, muss die Startvorlage das folgende Tag enthalten, damit Image Builder Windows Fast Launch in Ihrem Namen aktivieren kann.
`CreatedBy: EC2 Image Builder`
## Fügen Sie über die Konsole eine EC2-Startvorlage zu den AMI-Verteilungseinstellungen hinzu
Gehen Sie in der Konsole wie folgt vor, um eine Startvorlage mit Ihrem Ausgabe-AMI bereitzustellen:
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 **Verteilungseinstellungen** aus. Daraufhin wird eine Liste der Verteilungseinstellungen angezeigt, die unter Ihrem Konto erstellt wurden.
1. Wählen Sie oben auf der Seite mit den **Verteilungseinstellungen** die Option **Verteilungseinstellungen erstellen** aus. Dadurch wird die Seite **Verteilungseinstellungen erstellen** geöffnet.
1. Wählen Sie im Abschnitt **Image-Typ** den **Ausgabetyp** **Amazon Machine Image (AMI)** aus. Dies ist die Standardeinstellung.
1. Geben Sie im Abschnitt **Allgemein** den **Namen** der Ressource für die Verteilungseinstellungen ein, die Sie erstellen möchten (*erforderlich*).
1. Wählen Sie im Abschnitt **Regionseinstellungen** den Namen einer EC2-Startvorlage aus der Liste aus. Wenn Ihr Konto keine Startvorlagen enthält, wählen Sie **Neue Startvorlage erstellen** aus, wodurch die **Startvorlagen** im **EC2-Dashboard** geöffnet werden.
Aktivieren Sie das Kontrollkästchen **Standardversion festlegen**, um die Standardversion der Startvorlage auf die neue Version zu aktualisieren, die Image Builder mit Ihrem Ausgabe-AMI erstellt.
Um der ausgewählten Region eine weitere Startvorlage hinzuzufügen, wählen Sie **Startvorlagenkonfiguration hinzufügen**.
Um eine Startvorlage zu entfernen, wählen Sie **Entfernen**.
1. Geben Sie weitere Einstellungen an, die Sie benötigen, und wählen Sie **Einstellungen erstellen**, um Ihre neue Ressource für Verteilungseinstellungen zu erstellen.
## Fügen Sie eine EC2-Startvorlage zu den AMI-Verteilungseinstellungen hinzu aus dem AWS CLI
In diesem Abschnitt wird beschrieben, wie Sie eine Datei mit Verteilungseinstellungen mit einer Startvorlage konfigurieren und den **create-image** Befehl in verwenden, AWS CLI um ein Image Builder Builder-AMI und eine neue Version der Startvorlage, die es verwendet, zu erstellen und zu verteilen.
1.
**Konfigurieren Sie eine Datei mit den Verteilungseinstellungen**
Bevor Sie mithilfe von ein Image Builder Builder-AMI mit einer Startvorlage erstellen können, müssen Sie eine JSON-Struktur für die AWS CLI Verteilungskonfiguration erstellen, die die `launchTemplateConfigurations` Einstellungen spezifiziert. Sie müssen mindestens einen `launchTemplateConfigurations` Eintrag in der Quellregion angeben.
Die folgende Beispieldatei mit dem Namen `create-distribution-config-launch-template.json` zeigt einige mögliche Szenarien für die Konfiguration der Startvorlage in der Quellregion.
```
{
"name": "NewDistributionConfiguration",
"description": "This is just a test",
"distributions": [
{
"region": "us-west-2",
"amiDistributionConfiguration": {
"name": "test-{{imagebuilder:buildDate}}-{{imagebuilder:buildVersion}}",
"description": "description"
},
"launchTemplateConfigurations": [
{
"launchTemplateId": "lt-0a1bcde2fgh34567",
"accountId": "935302948087",
"setDefaultVersion": true
},
{
"launchTemplateId": "lt-0aaa1bcde2ff3456"
},
{
"launchTemplateId": "lt-12345678901234567",
"accountId": "123456789012"
}
]
}
],
"clientToken": "clientToken1"
}
```
1.
**Erstellen Sie die Verteilungseinstellungen**
Um eine Image Builder Builder-Verteilungseinstellungsressource mit dem [create-distribution-configuration](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-distribution-configuration.html)Befehl in zu erstellen AWS CLI, geben Sie die folgenden Parameter im Befehl an:
+ Geben Sie den Namen der Verteilung in den `--name` Parameter ein.
+ Hängen Sie die JSON-Datei für die Verteilungskonfiguration an, die Sie im `--cli-input-json` Parameter erstellt haben.
```
aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.json
```
**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 (\$1), um auf den Verzeichnispfad zu verweisen, während Linux und macOS den Schrägstrich (/) verwenden.
*Mithilfe des Parameters können Sie JSON auch direkt im Befehl angeben. `--distributions`*