CodeDeploy Anwendungsspezifikationsdateien (AppSpec)

Eine Anwendungsspezifikationsdatei (AppSpec Datei), die nur für gilt CodeDeploy, ist eine Datei im YAML- oder JSON-Format. Die AppSpec Datei wird verwendet, um jede Bereitstellung als eine Reihe von Lifecycle-Event-Hooks zu verwalten, die in der Datei definiert sind.

Hinweise zum Erstellen einer wohlgeformten AppSpec Datei finden Sie unterCodeDeploy AppSpec Dateiverweis.

AppSpec Dateien auf einer Amazon ECS Compute Platform

Wenn Ihre Anwendung die Amazon ECS-Rechenplattform verwendet, kann die AppSpec Datei entweder mit YAML oder JSON formatiert werden. Sie kann auch direkt in den Editor der Konsole eingegeben werden. Die AppSpec Datei wird verwendet, um Folgendes anzugeben:

• Der Name des Amazon ECS-Service sowie der Name und der Port des Containers, die für die Weiterleitung des Datenverkehrs an den neuen Tasksatz verwendet werden.

• Die Funktionen können als Validierungstests verwendet werden.

Sie können Lambda-Validierungsfunktionen nach Ereignissen im Bereitstellungslebenszyklus ausführen. Weitere Informationen finden Sie unter AppSpec Abschnitt „Hooks“ für eine Amazon ECS-Bereitstellung, AppSpec Dateistruktur für Amazon ECS-Bereitstellungen und AppSpec Dateibeispiel für eine Amazon ECS-Bereitstellung .

AppSpec Dateien auf einer AWS Lambda Rechenplattform

Wenn Ihre Anwendung die AWS Lambda-Rechenplattform verwendet, kann die AppSpec Datei entweder mit YAML oder JSON formatiert werden. Sie kann auch direkt in den Editor der Konsole eingegeben werden. Die AppSpec Datei wird verwendet, um Folgendes zu spezifizieren:

• Die Version der AWS Lambda Funktion, die bereitgestellt werden soll.

• Die Funktionen können als Validierungstests verwendet werden.

Sie können Lambda-Validierungsfunktionen nach Ereignissen im Bereitstellungslebenszyklus ausführen. Weitere Informationen finden Sie unter AppSpec Abschnitt „Hooks“ für eine AWS Lambda-Bereitstellung.

AppSpec Dateien auf einer EC2/lokalen Rechenplattform

Wenn Ihre Anwendung die EC2/On-Premises-Computerplattform verwendet, ist die Datei immer YAML-formatiert. AppSpec Die Datei wird verwendet, um: AppSpec

• Ordnen Sie die Quelldateien in Ihrer Anwendungsrevision den entsprechenden Zielen auf der Instance zu.

• Geben Sie benutzerdefinierte Berechtigungen für bereitgestellte Dateien an.

• Legen Sie Scripts fest, die auf jeder Instance in verschiedenen Phasen des Bereitstellungsprozesses ausgeführt werden.

Sie können nach vielen einzelnen Ereignissen im Bereitstellungslebenszyklus Skripts auf einer Instanz ausführen. CodeDeploy führt nur die in der Datei angegebenen Skripts aus, aber diese Skripts können andere Skripts auf der Instance aufrufen. Sie können alle Arten von Scripts ausführen, sofern diese vom Betriebssystem auf der jeweiligen Instance unterstützt werden. Weitere Informationen finden Sie unter AppSpec Abschnitt „Hooks“ für eine EC2/On-Premises-Bereitstellung.

Wie der CodeDeploy Agent die AppSpec Datei verwendet

Während der Bereitstellung sucht der CodeDeploy Agent im Abschnitt Hooks der AppSpec Datei nach dem Namen des aktuellen Ereignisses. Wenn das Ereignis nicht gefunden wird, fährt der CodeDeploy Agent mit dem nächsten Schritt fort. Wenn das Ereignis gefunden wird, ruft der CodeDeploy Agent die Liste der auszuführenden Skripts ab. Die Scripts werden sequenziell ausgeführt werden, und zwar in der Reihenfolge, in der sie in der Datei aufgeführt sind. Der Status jedes Skripts wird in der CodeDeploy Agent-Protokolldatei auf der Instanz protokolliert.

Wenn ein Script erfolgreich ausgeführt wird, wird der Beendigungscode 0 (Null) ausgegeben.

Anmerkung

Der CodeDeploy Agent wird nicht in einer AWS Lambda- oder Amazon ECS-Bereitstellung verwendet.

Während des Installationsereignisses bestimmt der CodeDeploy Agent anhand der im Dateiabschnitt der AppSpec Datei definierten Zuordnungen, welche Ordner oder Dateien von der Revision in die Instance kopiert werden sollen.

Wenn der auf dem Betriebssystem installierte CodeDeploy Agent nicht mit den Angaben in der AppSpec Datei übereinstimmt, schlägt die Bereitstellung fehl.

Hinweise zu CodeDeploy Agent-Protokolldateien finden Sie unterMit dem CodeDeploy Agenten arbeiten.