AppSpec 的 “资源” 部分（Amazon ECS 和AWS Lambda仅适用于部署)

中的内容'resources'AppSpec 文件的部分会随着部署的计算平台而改变。这些区域有：'resources'Amazon ECS 部署的部分包含 Amazon ECS 任务定义、用于将流量路由到更新的 Amazon ECS 任务集的容器和端口以及其他可选信息。这些区域有：'resources'部分的AWS Lambda部署包含 Lambda 函数的名称、别名、当前版本和目标版本。

适用于的 AppSpec 的 “资源” 部分AWSLambda 部署

这些区域有：'resources'部分指定要部署的 Lambda 函数，并具有以下结构：

YAML:

resources:
  - name-of-function-to-deploy:
      type: "AWS::Lambda::Function"
      properties:
        name: name-of-lambda-function-to-deploy
        alias: alias-of-lambda-function-to-deploy
        currentversion: version-of-the-lambda-function-traffic-currently-points-to
        targetversion: version-of-the-lambda-function-to-shift-traffic-to

JSON:

"resources": [{
    "name-of-function-to-deploy" {
        "type": "AWS::Lambda::Function",
        "properties": {
          "name": "name-of-lambda-function-to-deploy",
          "alias": "alias-of-lambda-function-to-deploy",
          "currentversion": "version-of-the-lambda-function-traffic-currently-points-to",
          "targetversion": "version-of-the-lambda-function-to-shift-traffic-to"
        }
    }
}]

每个属性都是使用字符串指定的。

• name – 必需。这是要部署的 Lambda 函数的名称。

• alias – 必需。这是 Lambda 函数的别名。

• currentversion – 必需。这是流量当前定向到的 Lambda 函数版本。

• targetversion – 必需。这是流量要转移到的 Lambda 函数版本。

用于 Amazon ECS 部署的 AppSpec 的 “资源” 部分

这些区域有：'resources'部分指定要部署的 Amazon ECS 服务，并具有以下结构：

YAML:

Resources:
  - TargetService:
      Type: AWS::ECS::Service
      Properties:
        TaskDefinition: "task-definition-ARN"
        LoadBalancerInfo: 
          ContainerName: "ECS-container-name-for-your-ECS-application" 
          ContainerPort: port-used-by-your-ECS-application
# Optional properties
        PlatformVersion: "ecs-service-platform-version"
        NetworkConfiguration:
          AwsvpcConfiguration:
            Subnets: ["ecs-subnet-1","ecs-subnet-n"] 
            SecurityGroups: ["ecs-security-group-1","ecs-security-group-n"] 
            AssignPublicIp: "ENABLED-or-DISABLED"
        CapacityProviderStrategy:
          - Base: Integer
            CapacityProvider: "capacityProviderA"
            Weight: Integer
          - Base: Integer
            CapacityProvider: "capacityProviderB"
            Weight: Integer

JSON:

"Resources": [
  {
    "TargetService": {
      "Type": "AWS::ECS::Service",
          "Properties": {
              "TaskDefinition": "",
              "LoadBalancerInfo": {
                  "ContainerName": "",
                  "ContainerPort": 
              },
              "PlatformVersion": "",
              "NetworkConfiguration": {
                  "AwsvpcConfiguration": {
                      "Subnets": [
                          "",
                          ""
                      ],
                      "SecurityGroups": [
                          "",
                          ""
                      ],
                      "AssignPublicIp": ""
                  }
              },
             "CapacityProviderStrategy": [
                {
                    "Base" : Integer,
                    "CapacityProvider" : "capacityProviderA",
                    "Weight" : Integer
                },
                {
                    "Base" : Integer,
                    "CapacityProvider" : "capacityProviderB",
                    "Weight" : Integer
                }
            ]
          }             
      }
  }
]

每个属性都是使用字符串指定的，但ContainerPort，这是一个数字。

• TaskDefinition – 必需。这是要部署的 Amazon ECS 服务的任务定义。它是使用任务定义的 ARN 指定的。ARN 格式为 arn:aws:ecs:aws-region:account-id:task-definition/task-definition-family:task-definition-revision。有关更多信息，请参阅 。Amazon 资源名称 (ARN) 和AWS服务命名空间.

• ContainerName – 必需。下面是包含 Amazon ECS 应用程序的 Amazon ECS 容器的名称。它必须是 Amazon ECS 任务定义中指定的容器。

• ContainerPort – 必需。这是集装箱上将流量路由到达的港口。

• PlatformVersion：可选。已部署的 Amazon ECS 服务中 Fargate 任务的平台版本。有关平台版本的更多信息，请参阅 AWS Fargate 平台版本。如果没有指定，LATEST默认使用 。

• NetworkConfiguration：可选。在 AwsvpcConfiguration 下，您可以指定以下设置。有关更多信息，请参阅 。AwsVpcConfiguration中的Amazon ECS 容器服务 API 参考.

  • Subnets：可选。Amazon ECS 服务中一个或多个子网的逗号分隔列表。

  • SecurityGroups：可选。Amazon Elastic 容器服务中一个或多个安全组的逗号分隔列表。

  • AssignPublicIp：可选。一个字符串，它指定您的 Amazon ECS 服务的 elastic network interface 是否接收公有 IP 地址。有效值为 ENABLED 和 DISABLED。

  注意

  必须指定 NetworkConfiguration 下的所有设置或不指定任何设置。例如，如果您要指定 Subnets，那么还必须指定 SecurityGroups 和 AssignPublicIp。如果不指定，则 CodeDeploy 将使用当前网络 Amazon ECS 的设置。

• CapacityProviderStrategy：可选。要用于部署的 Amazon ECS 容量提供商的列表。有关更多信息，请参阅 。Amazon ECS 容量提供程序中的Amazon Elastic Container Server 开发者指南. 对于每个容量提供商，您可以指定以下设置。有关这些设置的信息，请参阅AWS። ECS። Service 容力提供商策略项目中的AWS CloudFormation用户指南

  • Base：可选。基准值指明在指定的容量提供程序上至少运行多少个任务。在一个容量提供程序策略中，只能有一个容量提供程序策略定义了基准。如果未指定值，则使用默认值 0。

  • CapacityProvider：可选。容量提供程序的简称。示例：capacityProviderA

  • Weight：可选。

    权重 值指明应使用指定容量提供程序的已启动任务总数的相对百分比。在满足了 base 值（如果定义）之后，将考虑 weight 值。

    如果未指定 weight 值，则使用默认值 0。如果在容量提供程序策略中指定了多个容量提供程序，则至少有一个容量提供程序的权重值必须大于零，且任何权重为 0 的容量提供程序都不会被用来放置任务。如果您在策略中指定的多个容量提供程序的权重全部为 0，则使用该容量提供程序策略的任何 RunTask 或 CreateService 操作都将失败。

    下面是使用权重的示例情景：定义的策略包含两个容量提供程序，并且两个容量提供程序的权重均为 1，那么当满足 base 时，这些任务将在两个容量提供程序之间均匀分配。按照相同的逻辑，如果您为 capacityProviderA 指定权重 1，并为 capacityProviderB 指定权重 4，那么运行的每一个任务均使用 capacityProviderA，四个任务将使用 capacityProviderB。