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

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

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

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

AppSpec AWS 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 资源名称 (ARNs) 和 AWS 服务命名空间。

    注意

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

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

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

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

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

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

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

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

    注意

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

  • CapacityProviderStrategy：可选。您要用于部署的 Amazon ECS 容量提供商列表。有关更多信息，请参阅《亚马逊弹性ECS容器服务开发者指南》中的亚马逊容量提供商。对于每个容量提供程序，您可以指定以下设置。有关这些设置的详细信息，请参阅《AWS CloudFormation 用户指南》ServiceCapacityProviderStrategyItem中的AWSECS:::

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

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

    • Weight：可选。

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

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

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