AppSpec “资源” 部分（仅限 Amazon ECS 和 Amazon Lambda 部署） - Amazon CodeDeploy
AppSpec Amazon Lambda 部署的 “资源” 部分 AppSpec Amazon ECS 部署的 “资源” 部分
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AppSpec “资源” 部分（仅限 Amazon ECS 和 Amazon Lambda 部署）

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

AppSpec Amazon Lambda 部署的 “资源” 部分

'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 函数版本。此值必须为有效的正整数。

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

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

YAML：

Resources:
  - TargetService:
      Type: AWS::ECS::Service
      Properties:
        TaskDefinition: "task-definition-arn"
        LoadBalancerInfo: 
          ContainerName: "ecs-container-name" 
          ContainerPort: "ecs-application-port"
# 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 | DISABLED"
        CapacityProviderStrategy:
          - Base: integer
            CapacityProvider: "capacityProviderA"
            Weight: integer
          - Base: integer
            CapacityProvider: "capacityProviderB"
            Weight: integer

JSON:

"Resources": [
    {
        "TargetService": {
            "Type": "AWS::ECS::Service",
            "Properties": {
                "TaskDefinition": "task-definition-arn",
                "LoadBalancerInfo": {
                    "ContainerName": "ecs-container-name",
                    "ContainerPort": "ecs-application-port"
                },
                "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 | DISABLED"
                    }
                },
                "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) 和 Amazon 服务命名空间。

    注意

    ARN 的 :task-definition-revision 部分是可选的。如果省略该部分，则 Amazon ECS 将使用任务定义的最新 ACTIVE 修订。

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

  • ContainerPort – 必需。这是流量将被路由到的容器上的端口。

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

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

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

    • SecurityGroups：可选。Amazon Elastic Container Service 中一个或多个安全组的逗号分隔列表。

    • AssignPublicIp：可选。一个字符串，它指定 Amazon ECS 服务的弹性网络接口是否接收公有 IP 地址。有效值为 ENABLED 和 DISABLED。

    注意

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

  • CapacityProviderStrategy：可选。您要用于部署的 Amazon ECS 容量提供程序的列表。有关更多信息，请参阅《Amazon Elastic Container Service 开发人员指南》中的 Amazon ECS 容量提供程序。对于每个容量提供程序，您可以指定以下设置。有关这些设置的详细信息，请参阅AWS::ECS::ServiceCapacityProviderStrategyItem《Amazon CloudFormation 用户指南》

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

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

    • Weight：可选。

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

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

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