本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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:
。有关更多信息,请参阅 Amazon 资源名称 (ARNs) 和 Amazon 服务命名空间。aws-region
:account-id
:task-definition/task-definition-family
:task-definition-revision
注意
的
:
部分ARN是可选的。如果省略该字段,Amazon 将ECS使用任务定义的最新ACTIVE版本。task-definition-revision
-
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 地址。有效值为ENABLED
和DISABLED
。
注意
必须指定
NetworkConfiguration
下的所有设置或不指定任何设置。例如,如果您要指定Subnets
,那么还必须指定SecurityGroups
和AssignPublicIp
。如果未指定,则 CodeDeploy 使用当前的 Amazon 网络ECS设置。 -
-
CapacityProviderStrategy
:可选。您要用于部署的 Amazon ECS 容量提供商列表。有关更多信息,请参阅《亚马逊弹性ECS容器服务开发者指南》中的亚马逊容量提供商。对于每个容量提供程序,您可以指定以下设置。有关这些设置的详细信息,请参阅《Amazon 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
-