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.
# AMI \$1 Erstellen
Erstellen Sie ein Amazon Machine Image (AMI), das auf einer vorhandenen eigenständigen EC2-Instance in Ihrem AMS-Konto basiert. Die Instance muss sich im gestoppten Zustand befinden, bevor dieser Änderungstyp ausgeführt werden kann.
**Vollständige Klassifizierung:** Bereitstellung \$1 Erweiterte Stack-Komponenten \$1 AMI \$1 Erstellen
## Typdetails ändern
****
| | |
| --- |--- |
| Typ-ID ändern | ct-3rqqu43krekby |
| Aktuelle Version | 2.0 |
| Erwartete Ausführungsdauer | 360 Minuten |
| AWS-Zulassung | Erforderlich |
| Zustimmung durch den Kunden | Nicht erforderlich |
| Ausführungsmodus | Automatisiert |
## Zusätzliche Informationen
### Erstellen eines AMI
#### Ein AMI mit der Konsole erstellen
Im Folgenden wird dieser Änderungstyp in der AMS-Konsole dargestellt.
![\[Änderung type details for creating an Amazon Machine Image (AMI) from an EC2 instance.\]](http://docs.aws.amazon.com/de_de/managedservices/latest/ctref/images/guiAmiCreateCT.png)
**Wichtig**
Bevor Sie beginnen, bereiten Sie die EC2-Instance vor, mit der Sie das AMI erstellen werden. Ohne angemessene Vorbereitung wird der Create AMI RFC wahrscheinlich abgelehnt oder schlägt fehl. Informationen zur Vorbereitung Ihrer Instance für die erfolgreiche Erstellung eines AMI finden Sie in den Anweisungen in diesem Tutorial.
Funktionsweise
1. Navigieren Sie zur Seite „**RFC erstellen**“: Klicken Sie im linken Navigationsbereich der AMS-Konsole, um die RFCs Listenseite **RFCs**zu öffnen, und klicken Sie dann auf **Create RFC**.
1. Wählen Sie in der Standardansicht „**Änderungstypen durchsuchen“ einen beliebten Änderungstyp** (CT) oder wählen Sie in der Ansicht „**Nach Kategorie auswählen**“ einen CT aus.
+ **Nach Änderungstyp suchen**: Sie können im Bereich **Schnellerstellung** auf ein beliebtes CT klicken, um sofort die Seite **RFC ausführen** zu öffnen. Beachten Sie, dass Sie mit Quick Create keine ältere CT-Version auswählen können.
Verwenden Sie zum Sortieren CTs den Bereich **Alle Änderungstypen** in der **Karten** - oder **Tabellenansicht**. Wählen Sie in einer der Ansichten einen CT aus und klicken Sie dann auf **RFC erstellen**, um die Seite **RFC ausführen** zu öffnen. Falls zutreffend, wird neben der Schaltfläche „**RFC **erstellen“ die Option Mit älterer Version** erstellen** angezeigt.
+ **Nach Kategorie auswählen**: Wählen Sie eine Kategorie, eine Unterkategorie, einen Artikel und einen Vorgang aus. Daraufhin wird das Feld mit den CT-Details geöffnet. Dort können Sie gegebenenfalls die Option „**Mit älterer Version erstellen**“ auswählen. Klicken Sie auf **RFC erstellen**, um die Seite **RFC ausführen** zu öffnen.
1. Öffnen Sie auf der Seite **RFC ausführen** den Bereich CT-Name, um das Feld mit den CT-Details zu sehen. Ein **Betreff** ist erforderlich (dieser wird für Sie ausgefüllt, wenn Sie Ihr CT in der Ansicht „**Änderungstypen durchsuchen**“ auswählen). Öffnen Sie den Bereich **Zusätzliche Konfiguration**, um Informationen zum RFC hinzuzufügen.
Verwenden Sie im Bereich **Ausführungskonfiguration** die verfügbaren Dropdownlisten oder geben Sie Werte für die erforderlichen Parameter ein. Um optionale Ausführungsparameter zu konfigurieren, öffnen Sie den Bereich **Zusätzliche Konfiguration**.
1. Wenn Sie fertig sind, klicken Sie auf **Ausführen**. Wenn keine Fehler vorliegen, wird die Seite mit dem **RFC erfolgreich erstellt** mit den übermittelten RFC-Details und der ersten **Run-Ausgabe** angezeigt.
1. Öffnen Sie den Bereich **Run-Parameter**, um die von Ihnen eingereichten Konfigurationen zu sehen. Aktualisieren Sie die Seite, um den RFC-Ausführungsstatus zu aktualisieren. Brechen Sie optional den RFC ab oder erstellen Sie eine Kopie davon mit den Optionen oben auf der Seite.
#### Erstellen eines AMI mit der CLI
Funktionsweise
1. Verwenden Sie entweder Inline Create (Sie geben einen `create-rfc` Befehl mit allen RFC- und Ausführungsparametern aus) oder Template Create (Sie erstellen zwei JSON-Dateien, eine für die RFC-Parameter und eine für die Ausführungsparameter) und geben Sie den `create-rfc` Befehl mit den beiden Dateien als Eingabe aus. Beide Methoden werden hier beschrieben.
1. Reichen Sie den `aws amscm submit-rfc --rfc-id ID` Befehl RFC: mit der zurückgegebenen RFC-ID ein.
Überwachen Sie den RFC: -Befehl. `aws amscm get-rfc --rfc-id ID`
Verwenden Sie diesen Befehl, um die Version des Änderungstyps zu überprüfen:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**Anmerkung**
Sie können alle `CreateRfc` Parameter mit jedem RFC verwenden, unabhängig davon, ob sie Teil des Schemas für den Änderungstyp sind oder nicht. Um beispielsweise Benachrichtigungen zu erhalten, wenn sich der RFC-Status ändert, fügen Sie diese Zeile dem RFC-Parameter-Teil der Anfrage hinzu (nicht den Ausführungsparametern). `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` Eine Liste aller CreateRfc Parameter finden Sie in der [AMS Change Management API-Referenz](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
*INLINE-ERSTELLUNG*:
Geben Sie den Befehl create RFC mit den direkt angegebenen Ausführungsparametern aus (vermeiden Sie Anführungszeichen, wenn Sie die Ausführungsparameter inline angeben), und senden Sie dann die zurückgegebene RFC-ID. Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:
```
aws --profile saml --region us-east-1 amscm create-rfc --change-type-id "ct-3rqqu43krekby" --change-type-version "2.0" --title "AMI-Create-IC" --execution-parameters "{\"AMIName\":\"MyAmi\",\"VpcId\":\"VPC_ID\",\"EC2InstanceId\":\"INSTANCE_ID\"}"
```
*VORLAGE ERSTELLEN*:
1. Gibt das JSON-Schema der Ausführungsparameter für diesen Änderungstyp in eine Datei aus. In diesem Beispiel wird sie „ CreateAmiParams.json“ genannt:
```
aws amscm get-change-type-version --change-type-id "ct-3rqqu43krekby" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateAmiParams.json
```
1. Ändern und speichern Sie die Ausführungsparameter in der CreateAmiParams JSON-Datei. Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:
```
{
"AMIName": "My-AMI",
"InstanceId": "EC2_INSTANCE_ID"
}
```
1. Geben Sie die JSON-Datei mit der RFC-Vorlage in eine Datei in Ihrem aktuellen Ordner aus. In diesem Beispiel wird sie „ CreateAmiRfc.json“ genannt:
```
aws amscm create-rfc --generate-cli-skeleton > CreateAmiRfc.json
```
1. Ändern und speichern Sie die CreateAmiRfc JSON-Datei. Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:
```
{
"ChangeTypeId": "ct-3rqqu43krekby",
"ChangeTypeVersion": "2.0",
"Title": "AMI-Create-RFC"
}
```
1. Erstellen Sie den RFC und geben Sie die CreateAmiRfc Datei und die CreateAmiParams Datei an:
```
aws amscm create-rfc --cli-input-json file://CreateAmiRfc.json --execution-parameters file://CreateAmiParams.json
```
Sie erhalten die ID des neuen RFC in der Antwort und können sie verwenden, um den RFC zu senden und zu überwachen. Bis Sie ihn abschicken, verbleibt der RFC im Bearbeitungszustand und startet nicht.
#### Tipps
**Anmerkung**
Nachdem Sie ein benutzerdefiniertes AMI erstellt haben, können Sie eine Serviceanfrage an AMS senden, damit Ihre bestehende EC2 Auto Scaling Scaling-Gruppe das neue AMI verwendet. Informationen zum Erstellen einer Serviceanfrage finden Sie unter [Beispiele für Serviceanfragen](https://docs.aws.amazon.com/managedservices/latest/userguide/serv-req-mgmt-examples.html).
**Wichtig**
Bevor Sie beginnen, bereiten Sie die EC2-Instance vor, mit der Sie das AMI erstellen werden. Ohne angemessene Vorbereitung wird der Create AMI RFC wahrscheinlich abgelehnt oder schlägt fehl.
Um Authentifizierungsprobleme bei Instances zu vermeiden, die mit dem neuen AMI erstellt wurden, führen Sie diese Systembefehle auf der Instance aus, nachdem Sie benutzerdefinierte Änderungen vorgenommen haben und bevor Sie Create AMI CT aufrufen.
**Wichtig**
Wenn die angegebene Instance nicht gestoppt und von ihrer aktuellen Domäne getrennt wird, schlägt der RFC zur AMI-Erstellung fehl. Bereiten Sie die Instanz wie beschrieben vor.
Weitere Informationen finden Sie unter [Erstellen eines standardmäßigen Amazon-Computerabbilds mithilfe von Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
Sie können ein AMS SNS-AMI-Benachrichtigungsthema abonnieren, um eine Benachrichtigung zu erhalten, wenn neue AMS, die für Sie AMIs von Interesse sind, bereitgestellt werden. Weitere Informationen finden Sie unter [AMS AMI Notification Service](https://docs.aws.amazon.com/managedservices/latest/userguide/ams-ami-notify.html).
##### Linux-Vorbereitung für AMI Create
Laden Sie das folgende Skript herunter und führen Sie es aus, um Ihre Instance für die AMI-Erstellung vorzubereiten. Sie müssen dieses Skript als Root-Benutzer ausführen.
```
curl https://amazon-ams-us-east-1.s3.amazonaws.com/latest/linux/prepare_instance_for_ami_and_shutdown.sh -o ./prepare_instance_for_ami_and_shutdown.sh
chmod 744 prepare_instance_for_ami_and_shutdown.sh
./prepare_instance_for_ami_and_shutdown.sh
```
Hinweis: Das vorherige Skript führt ein Herunterfahren der Instanz durch und verbundene Benutzer werden von der Sitzung abgemeldet.
##### Windows-Vorbereitung für AMI Create
Windows Powershell (als Administrator ausführen):
```
Invoke-AMSSysprep
```
Die Instanz wird gestoppt und alle verbundenen Benutzer werden von der aktuellen Windows RDP-Sitzung abgemeldet.
Weitere Informationen zur Erstellung von AWS Windows AMIs finden Sie unter [Erstellen eines benutzerdefinierten Windows-AMI](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
##### UserData für AMI Create
Wenn Benutzerdaten beim nächsten Start von Ihrem AMI ausgeführt werden müssen, stellen Sie Folgendes sicher:
+ Der Registrierungsschlüssel `HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\ManagedServices\RunUserDataViaAMSBootModule` ist vorhanden. Wenn dieser Schlüssel nicht vorhanden ist, werden die Benutzerdaten beim nächsten Mal nicht ausgeführt.
+ Gehen Sie wie folgt vor, um zu aktivieren, dass Benutzerdaten beim nächsten Start ausgeführt werden:
1. Starten Sie ein PowerShell Windows mit Administratorrechten (als Administrator ausführen)
1. Führen Sie den folgenden Befehl aus:
```
Install-AMSDependencies
```
Informationen zum fehlgeschlagenen AMI Create RFCs finden Sie unter [RFC-Fehlerbehandlung](https://docs.aws.amazon.com/managedservices/latest/userguide/rfc-failures.html).
## Eingabeparameter für die Ausführung
Ausführliche Informationen zu den Eingabeparametern der Ausführung finden Sie unter[Schema für den Änderungstyp ct-3rqqu43krekby](schemas.md#ct-3rqqu43krekby-schema-section).
## Beispiel: Erforderliche Parameter
```
{
"InstanceId": "i-01234567890abcdef",
"AmiName": "MyAMI"
}
```
## Beispiel: Alle Parameter
```
{
"InstanceId": "i-12345678",
"AmiName": "MyAMI",
"AmiTags": [
{
"Key": "foo",
"Value": "bar"
},
{
"Key": "testkey",
"Value": "testvalue"
}
]
}
```