AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

AppSpec File 示例

此主题提供用于 AWS Lambda 和 EC2/本地部署的 AppSpec 文件示例。

用于 Amazon ECS 部署的 AppSpec File 示例

下面是使用 YAML 编写的、用于部署 Amazon ECS 服务的 AppSpec file示例。

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"
Hooks:
  - BeforeInstall: "LambdaFunctionToValidateBeforeInstall"
  - AfterInstall: "LambdaFunctionToValidateAfterTraffic"
  - AfterAllowTestTraffic: "LambdaFunctionToValidateAfterTestTrafficStarts"
  - BeforeAllowTraffic: "LambdaFunctionToValidateBeforeAllowingProductionTraffic"
  - AfterAllowTraffic: "LambdaFunctionToValidateAfterAllowingProductionTraffic"

下面是用 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"
						}
					}
				}				
			}
		}
	],
	"Hooks": [
		{
			"BeforeInstall": "LambdaFunctionToValidateBeforeInstall"
		},
		{
			"AfterInstall": "LambdaFunctionToValidateAfterTraffic"
		},
		{
			"AfterAllowTestTraffic": "LambdaFunctionToValidateAfterTestTrafficStarts"
		},
		{
			"BeforeAllowTraffic": "LambdaFunctionToValidateBeforeAllowingProductionTraffic"
		},
		{
			"AfterAllowTraffic": "LambdaFunctionToValidateAfterAllowingProductionTraffic"
		}
	]
}

下面是部署期间的事件序列：

在任何挂钩期间运行的 Lambda 函数都可以执行验证测试或者收集流量指标。

用于 AWS Lambda 部署的 AppSpec File 示例

下面是使用 YAML 编写的、用于部署 Lambda 函数版本的 AppSpec file示例。

version: 0.0
Resources:
  - myLambdaFunction:
      Type: AWS::Lambda::Function
      Properties:
        Name: "myLambdaFunction"
        Alias: "myLambdaFunctionAlias"
        CurrentVersion: "1"
        TargetVersion: "2"
Hooks:
  - BeforeAllowTraffic: "LambdaFunctionToValidateBeforeTrafficShift"
  - AfterAllowTraffic: "LambdaFunctionToValidateAfterTrafficShift"

下面是用 JSON 编写的上述示例的版本。

{
 	"version": 0.0,
 	"Resources": [{
 		"myLambdaFunction": {
 			"Type": "AWS::Lambda::Function",
 			"Properties": {
 				"Name": "myLambdaFunction",
 				"Alias": "myLambdaFunctionAlias",
 				"CurrentVersion": "1",
 				"TargetVersion": "2"
 			}
 		}
 	}],
 	"Hooks": [{
 			"BeforeAllowTraffic": "LambdaFunctionToValidateBeforeTrafficShift"
      },
      {
 			"AfterAllowTraffic": "LambdaFunctionToValidateAfterTrafficShift"
 		}
 	]
 }

下面是部署期间的事件序列：

用于 EC2/本地部署的 AppSpec File 示例

下面是对 Amazon Linux、Ubuntu Server 或 RHEL实例进行就地部署的 AppSpec file的示例。

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

对于 Windows Server 实例，将 os: linux 更改为 os: windows。另外，您还必须完全限定 destination 路径（例如 c:\temp\webapps\Config 和 c:\temp\webapps\myApp）。不包括 runas 元素。

下面是部署期间的事件序列：