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. # AppSpec Beispiel für eine Datei Dieses Thema enthält AppSpec Beispieldateien für eine AWS Lambda- und eine EC2/On-Premises-Bereitstellung. **Topics** + [AppSpec Dateibeispiel für eine Amazon ECS-Bereitstellung](#appspec-file-example-ecs) + [AppSpec Dateibeispiel für eine AWS Lambda-Bereitstellung](#appspec-file-example-lambda) + [AppSpec Dateibeispiel für eine EC2/On-Premises-Bereitstellung](#appspec-file-example-server) ## AppSpec Dateibeispiel für eine Amazon ECS-Bereitstellung Hier ist ein Beispiel für eine in YAML geschriebene AppSpec Datei für die Bereitstellung eines Amazon ECS-Service. ``` version: 0.0 Resources: - TargetService: Type: AWS::ECS::Service Properties: TaskDefinition: "arn:aws:ecs:us-east-1:111222333444:task-definition/my-task-definition-family-name:1" LoadBalancerInfo: ContainerName: "SampleApplicationName" ContainerPort: 80 # Optional properties PlatformVersion: "LATEST" NetworkConfiguration: AwsvpcConfiguration: Subnets: ["subnet-1234abcd","subnet-5678abcd"] SecurityGroups: ["sg-12345678"] AssignPublicIp: "ENABLED" CapacityProviderStrategy: - Base: 1 CapacityProvider: "FARGATE_SPOT" Weight: 2 - Base: 0 CapacityProvider: "FARGATE" Weight: 1 Hooks: - BeforeInstall: "LambdaFunctionToValidateBeforeInstall" - AfterInstall: "LambdaFunctionToValidateAfterInstall" - AfterAllowTestTraffic: "LambdaFunctionToValidateAfterTestTrafficStarts" - BeforeAllowTraffic: "LambdaFunctionToValidateBeforeAllowingProductionTraffic" - AfterAllowTraffic: "LambdaFunctionToValidateAfterAllowingProductionTraffic" ``` Hier finden Sie eine Version des obigen Beispiels in JSON. ``` { "version": 0.0, "Resources": [ { "TargetService": { "Type": "AWS::ECS::Service", "Properties": { "TaskDefinition": "arn:aws:ecs:us-east-1:111222333444:task-definition/my-task-definition-family-name:1", "LoadBalancerInfo": { "ContainerName": "SampleApplicationName", "ContainerPort": 80 }, "PlatformVersion": "LATEST", "NetworkConfiguration": { "AwsvpcConfiguration": { "Subnets": [ "subnet-1234abcd", "subnet-5678abcd" ], "SecurityGroups": [ "sg-12345678" ], "AssignPublicIp": "ENABLED" } }, "CapacityProviderStrategy": [ { "Base" : 1, "CapacityProvider" : "FARGATE_SPOT", "Weight" : 2 }, { "Base" : 0, "CapacityProvider" : "FARGATE", "Weight" : 1 } ] } } } ], "Hooks": [ { "BeforeInstall": "LambdaFunctionToValidateBeforeInstall" }, { "AfterInstall": "LambdaFunctionToValidateAfterInstall" }, { "AfterAllowTestTraffic": "LambdaFunctionToValidateAfterTestTrafficStarts" }, { "BeforeAllowTraffic": "LambdaFunctionToValidateBeforeAllowingProductionTraffic" }, { "AfterAllowTraffic": "LambdaFunctionToValidateAfterAllowingProductionTraffic" } ] } ``` Hier finden Sie die Ereignisabfolge während der Bereitstellung: 1. Bevor die aktualisierte Amazon ECS-Anwendung auf dem Ersatz-Tasksatz installiert wird, wird die Lambda-Funktion mit dem Namen `LambdaFunctionToValidateBeforeInstall` ausgeführt. 1. Nachdem die aktualisierte Amazon ECS-Anwendung auf dem Ersatzaufgabensatz installiert wurde, aber bevor sie Datenverkehr empfängt, wird die Lambda-Funktion namens Lambda-Funktion `LambdaFunctionToValidateAfterInstall` ausgeführt. 1. Nachdem die Amazon ECS-Anwendung auf dem Ersatzaufgabensatz anfängt, Datenverkehr vom Test-Listener zu empfangen, wird die Lambda-Funktion namens `LambdaFunctionToValidateAfterTestTrafficStarts` Lambda-Funktion ausgeführt. Diese Funktion führt wahrscheinlich Validierungstests durch, um zu bestimmen, ob die Bereitstellung fortgesetzt wird. Wenn Sie keinen Test-Listener in Ihrer Bereitstellungsgruppe angeben, wird dieser Hook ignoriert. 1. Nachdem alle Validierungstests im `AfterAllowTestTraffic` Hook abgeschlossen sind und bevor der Produktionsdatenverkehr an die aktualisierte Amazon ECS-Anwendung weitergeleitet wird, wird die Lambda-Funktion mit dem Namen `LambdaFunctionToValidateBeforeAllowingProductionTraffic` ausgeführt. 1. Nachdem der Produktionsdatenverkehr für die aktualisierte Amazon ECS-Anwendung auf dem Ersatz-Tasksatz bereitgestellt wurde, wird die Lambda-Funktion namens Lambda-Funktion `LambdaFunctionToValidateAfterAllowingProductionTraffic` ausgeführt. Die Lambda-Funktionen, die während eines beliebigen Hooks ausgeführt werden, können Validierungstests durchführen oder Verkehrsmetriken sammeln. ## AppSpec Dateibeispiel für eine AWS Lambda-Bereitstellung Hier ist ein Beispiel für eine in YAML geschriebene AppSpec Datei für die Bereitstellung einer Lambda-Funktionsversion. ``` version: 0.0 Resources: - myLambdaFunction: Type: AWS::Lambda::Function Properties: Name: "myLambdaFunction" Alias: "myLambdaFunctionAlias" CurrentVersion: "1" TargetVersion: "2" Hooks: - BeforeAllowTraffic: "LambdaFunctionToValidateBeforeTrafficShift" - AfterAllowTraffic: "LambdaFunctionToValidateAfterTrafficShift" ``` Hier finden Sie eine Version des obigen Beispiels in JSON. ``` { "version": 0.0, "Resources": [{ "myLambdaFunction": { "Type": "AWS::Lambda::Function", "Properties": { "Name": "myLambdaFunction", "Alias": "myLambdaFunctionAlias", "CurrentVersion": "1", "TargetVersion": "2" } } }], "Hooks": [{ "BeforeAllowTraffic": "LambdaFunctionToValidateBeforeTrafficShift" }, { "AfterAllowTraffic": "LambdaFunctionToValidateAfterTrafficShift" } ] } ``` Hier finden Sie die Ereignisabfolge während der Bereitstellung: 1. Bevor Sie den Datenverkehr von Version 1 einer aufgerufenen Lambda-Funktion `myLambdaFunction` auf Version 2 verlagern, führen Sie eine Lambda-Funktion namens aus, `LambdaFunctionToValidateBeforeTrafficShift` die bestätigt, dass die Bereitstellung bereit ist, mit der Verkehrsverlagerung zu beginnen. 1. Wenn `LambdaFunctionToValidateBeforeTrafficShift` den Exit-Code 0 (Erfolg) zurückgibt, fangen Sie an, Datenverkehr in Version 2 von `myLambdaFunction` zu verschieben. Die Bereitstellungskonfiguration für diese Bereitstellung bestimmt die Geschwindigkeit, in der der Datenverkehr verschoben wird. 1. Nachdem die Übertragung des Datenverkehrs von Version 1 einer aufgerufenen Lambda-Funktion `myLambdaFunction` auf Version 2 abgeschlossen ist, führen Sie eine aufgerufene Lambda-Funktion aus, `LambdaFunctionToValidateAfterTrafficShift` die bestätigt, dass die Bereitstellung erfolgreich abgeschlossen wurde. ## AppSpec Dateibeispiel für eine EC2/On-Premises-Bereitstellung Hier ist ein Beispiel für eine AppSpec Datei für eine direkte Bereitstellung auf einer Amazon Linux-, Ubuntu Server- oder RHEL-Instance. **Anmerkung** Bereitstellungen auf Windows Server-Instances unterstützen das Element nicht. `runas` Wenn Sie es auf Windows Server-Instanzen bereitstellen, nehmen Sie es nicht in Ihre AppSpec Datei auf. ``` version: 0.0 os: linux files: - source: Config/config.txt destination: /webapps/Config - source: source destination: /webapps/myApp hooks: BeforeInstall: - location: Scripts/UnzipResourceBundle.sh - location: Scripts/UnzipDataBundle.sh AfterInstall: - location: Scripts/RunResourceTests.sh timeout: 180 ApplicationStart: - location: Scripts/RunFunctionalTests.sh timeout: 3600 ValidateService: - location: Scripts/MonitorService.sh timeout: 3600 runas: codedeployuser ``` Wechseln Sie für eine Windows Server-Instanz `os: linux` zu`os: windows`. Außerdem müssen Sie die `destination`-Pfade vollständig qualifizieren (z. B. `c:\temp\webapps\Config` und `c:\temp\webapps\myApp`). Beziehen Sie das Element `runas` nicht mit ein. Hier finden Sie die Ereignisabfolge während der Bereitstellung: 1. Führen Sie das Skript unter `Scripts/UnzipResourceBundle.sh` aus. 1. Wenn das vorherige Skript einen Beendigungscode von 0 (Erfolg) wiedergegeben hat, führen Sie das Skript unter `Scripts/UnzipDataBundle.sh` aus. 1. Kopieren Sie den Dateipfad von `Config/config.txt` zum Pfad `/webapps/Config/config.txt`. 1. Kopieren Sie rekursiv alle Dateien im Verzeichnis `source` in das Verzeichnis `/webapps/myApp`. 1. Führen Sie das Skript unter `Scripts/RunResourceTests.sh` mit einem Timeout von 180 Sekunden (3 Minuten) aus. 1. Führen Sie das Skript unter `Scripts/RunFunctionalTests.sh` mit einem Timeout von 3 600 Sekunden (1 Stunde) aus. 1. Führen Sie das Skript unter `Scripts/MonitorService.sh` als Benutzer `codedeploy` mit einem Timeout von 3 600 Sekunden (1 Stunde) aus.