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

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

AppSpec “资源” 部分(仅限 Amazon ECS 和 Amazon Lambda 部署)

AppSpec 文件'resources'部分的内容因部署的计算平台而异。亚马逊ECS部署'resources'部分包含您的亚马逊ECS任务定义、用于将流量路由到更新的亚马逊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 资源名称 (ARNs) 和 Amazon 服务命名空间

    注意

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

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

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

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

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

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

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

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

    注意

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

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

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

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

    • Weight:可选。

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

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

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