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.
# AWS ParallelCluster AMI-Anpassung
Es gibt Szenarien, in denen die Erstellung eines benutzerdefinierten AMI für erforderlich AWS ParallelCluster ist. In diesem Abschnitt wird beschrieben, was beim Erstellen eines benutzerdefinierten AWS ParallelCluster AMI zu beachten ist.
Sie können ein benutzerdefiniertes AWS ParallelCluster AMI mit einer der folgenden Methoden erstellen:
1. Erstellen Sie eine [Build-Image-Konfigurationsdatei](image-builder-configuration-file-v3.md) und verwenden Sie dann die `pcluster` CLI, um das Image mit EC2 Image Builder zu erstellen. Dieser Prozess ist automatisiert, wiederholbar und unterstützt die Überwachung. Weitere Informationen finden Sie in den [`pcluster`](pcluster-v3.md)Bildbefehlen.
1. Erstellen Sie eine Instanz aus einem AWS ParallelCluster AMI, melden Sie sich dann bei ihr an und nehmen Sie manuelle Änderungen vor. Verwenden Sie zuletzt Amazon EC2, um ein neues AMI aus der geänderten Instance zu erstellen. Dieser Vorgang benötigt weniger Zeit. Es ist jedoch nicht automatisiert oder wiederholbar und unterstützt die Verwendung der `pcluster` CLI-Bildüberwachungsbefehle nicht.
Weitere Informationen zu diesen Methoden finden Sie unter[Ein benutzerdefiniertes AWS ParallelCluster AMI erstellen](building-custom-ami-v3.md).
## AWS ParallelCluster Überlegungen zur AMI-Anpassung
Unabhängig davon, wie Sie Ihr benutzerdefiniertes Image erstellen, empfehlen wir Ihnen, vorläufige Validierungstests durchzuführen und Vorkehrungen zur Überwachung des Status des erstellten Images zu treffen.
Um ein benutzerdefiniertes AMI zu erstellen`pcluster`, erstellen Sie eine [Build-Image-Konfigurationsdatei](image-builder-configuration-file-v3.md) mit einem [`Build`[`Image`](Image-v3.md#Image-v3.properties)](Build-v3.md)UND-Abschnitt, den [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html) verwendet, um Ihr benutzerdefiniertes Image zu erstellen. In `Build` diesem Abschnitt wird angegeben, was Image Builder zum Erstellen des Images benötigt. Dazu gehören das [`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage)(Basis-Image) und [`Components`](Build-v3.md#Build-v3-Components). Eine [Image Builder Builder-Komponente](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-component-manager.html) definiert eine Abfolge von Schritten, die erforderlich sind, um eine Instanz anzupassen, bevor ein Image erstellt wird, oder um eine Instanz zu testen, die mit dem erstellten Image gestartet wurde. Weitere Informationen finden Sie unter [Erstellen einer benutzerdefinierten Komponente mit Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component.html) im *EC2 Image Builder Builder-Benutzerhandbuch*.
Wenn Image Builder von pcluster aus aufgerufen wird, [`build-image`](pcluster.build-image-v3.md)um ein benutzerdefiniertes Image zu erstellen, verwendet es die Build-Image-Konfiguration mit dem AWS ParallelCluster Cookbook, um Ihr Image zu booten. AWS ParallelCluster [`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage) Image Builder lädt Komponenten herunter, führt Build- und Validierungsphasen aus, erstellt das AMI, startet eine Instance aus dem AMI und führt Tests durch. Wenn der Vorgang abgeschlossen ist, erzeugt Image Builder ein neues Image oder eine Stoppnachricht.
## Führen Sie Validierungstests für benutzerdefinierte Komponenten durch
Bevor Sie eine Image Builder Builder-Komponente in eine Konfiguration aufnehmen, testen und validieren Sie sie mit einer der folgenden Methoden. Da der Image Builder Builder-Vorgang bis zu 1 Stunde dauern kann, empfehlen wir, die Komponenten vorher zu testen. Dadurch können Sie viel Zeit sparen.
**Skriptkoffer**
Testen Sie das Skript in einer laufenden Instanz außerhalb des Build-Image-Prozesses und stellen Sie sicher, dass das Skript mit dem Exit-Code 0 beendet wird.
**Fall Amazon Resource Name (ARN)**
Testen Sie das Komponentendokument in einer laufenden Instance außerhalb des Build-Image-Prozesses. Eine Liste der Anforderungen finden Sie unter [Component Manager](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-component-manager.html) im *Image Builder Builder-Benutzerhandbuch*.
**Fügen Sie die Komponente nach erfolgreicher Überprüfung zu Ihrer Build-Image-Konfiguration hinzu**
Nachdem Sie überprüft haben, ob die benutzerdefinierte Komponente funktioniert, fügen Sie sie der [Build-Image-Konfigurationsdatei](image-builder-configuration-file-v3.md) hinzu.
## Überwachen Sie den Image Builder Builder-Prozess mit `pcluster` Befehlen, die beim Debuggen helfen
[`describe-image`](pcluster.describe-image-v3.md)
Verwenden Sie diesen Befehl, um den Status des Build-Images zu überwachen.
[`list-image-log-streams`](pcluster.list-image-log-streams-v3.md)
Verwenden Sie diesen Befehl, um die IDs Protokolldatenströme abzurufen, mit denen Sie Protokollereignisse abrufen können [`get-image-log-events`](pcluster.get-image-log-events-v3.md).
[`get-image-log-events`](pcluster.get-image-log-events-v3.md)
Verwenden Sie diesen Befehl, um den Protokollstream der Build-Image-Prozessereignisse abzurufen.
Mit dem folgenden Befehl können Sie beispielsweise Build-Image-Ereignisse nachverfolgen.
```
$ watch -n 1 'pcluster get-image-log-events -i {{}} \
--log-stream-name/1 {{}} \
--query "events[*].message" | tail -n 50'
```
[`get-image-stack-events`](pcluster.get-image-stack-events-v3.md)
Verwenden Sie diesen Befehl, um Image-Stack-Ereignisse für den Stapel abzurufen, den Image Builder erstellt.
[`export-image-logs`](pcluster.export-image-logs-v3.md)
Verwenden Sie diesen Befehl, um Image-Logs zu speichern.
Weitere Informationen zu AWS ParallelCluster Logs und Amazon CloudWatch finden Sie unter [Amazon CloudWatch Logs erstellt Image-Logs](cloudwatch-logs-v3.md#cloudwatch-logs-build-images) und[CloudWatch Amazon-Dashboard](cloudwatch-dashboard-v3.md).
## Weitere Überlegungen
**Neue AWS ParallelCluster Versionen und benutzerdefinierte Versionen AMIs**
Wenn Sie ein benutzerdefiniertes AMI erstellen und verwenden, müssen Sie die Schritte, die Sie zur Erstellung Ihres benutzerdefinierten AMI verwendet haben, mit jeder neuen AWS ParallelCluster Version wiederholen.
**Benutzerdefinierte Bootstrap-Aktionen**
Lesen Sie den [Benutzerdefinierte Bootstrap-Aktionen](custom-bootstrap-actions-v3.md) Abschnitt, um festzustellen, ob die Änderungen, die Sie vornehmen möchten, skriptgesteuert werden können und in future AWS ParallelCluster Versionen unterstützt werden können.
**Benutzerdefiniert verwenden AMIs**
Sie können AMIs in der Cluster-Konfiguration in den [`CustomAmi`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Image-CustomAmi)Abschnitten [`Image`](Image-v3.md)/[`CustomAmi`](Image-v3.md#yaml-Image-CustomAmi)und/[`Scheduling`](Scheduling-v3.md)//[`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/[`Name`[`Image`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Image)](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Name)/die Option custom angeben.
Informationen zur Fehlerbehebung bei benutzerdefinierten AMI-Validierungswarnungen finden Sie unter[Behebung von Problemen mit benutzerdefinierten AMIs](troubleshooting-v3-custom-amis.md).