为 Amazon ECS 外部部署使用第三方控制器

外部部署类型允许您使用任何第三方部署控制器，以完全控制 Amazon ECS 服务的部署过程。服务的详细信息由服务管理 API 操作（CreateService、UpdateService 和 DeleteService）或任务集管理 API 操作（CreateTaskSet、UpdateTaskSet、UpdateServicePrimaryTaskSet 和 DeleteTaskSet）管理。每个 API 操作都会管理服务定义参数的一个子集。

UpdateService API 操作更新服务的预期数量和运行状况检查宽限期参数。如果需要更新启动类型、平台版本、负载均衡器详细信息、网络配置或任务定义，您必须创建一个新任务集。

UpdateTaskSet API 操作仅更新任务集的扩展参数。

UpdateServicePrimaryTaskSet API 操作修改服务中的哪个任务集是主要任务集。当您调用 DescribeServices API 操作时，它将返回为主要任务集指定的所有字段。如果更新服务的主要任务集，新的主要任务集上现有的任何任务集参数值若不同于服务中旧的主要任务集的参数，则在定义新的主要任务集时，这些参数将会更新为新值。如果没有为服务定义任何主要任务集，则在描述服务时，任务集字段将为 null。

外部部署注意事项

在使用外部部署类型时，请考虑以下内容：

支持的负载均衡器类型是应用程序负载均衡器或网络负载均衡器。
Fargate 启动类型或 EXTERNAL 部署控制器类型均不支持 DAEMON 计划策略。

外部部署工作流

以下是在 Amazon ECS 上管理外部部署的基本工作流程。

使用外部部署控制器管理 Amazon ECS 服务

创建 Amazon ECS 服务唯一必需的参数是服务名称。您可以在使用外部部署控制器创建服务时指定以下参数。在服务内创建任务集时将指定所有其他服务参数。

serviceName

类型：字符串

必需：是

您的服务的名称。最多能包含 255 个字母 (大写和小写字母)、数字、连字符和下划线。一个集群中的服务名称必须唯一，但是您可以为一个区域或多个区域中多个集群中的服务提供相似的名称。

desiredCount

要在该服务内放置并保持运行的指定任务集任务定义的实例化数量。

deploymentConfiguration

可选部署参数，用于控制部署期间运行的任务数以及停止和开始任务的顺序。有关更多信息，请参阅 deploymentConfiguration。

tags

类型：对象数组

必需：否

您应用于服务以帮助您对其进行分类和组织的元数据。每个标签都包含您定义的一个键和一个可选值。在服务被删除时，标签也会随之被删除。该服务最多可应用 50 个标签。有关更多信息，请参阅 Amazon ECS 资源标记。

key

类型：字符串

长度限制：长度下限为 1。长度上限为 128。

必需：否

构成标签的键-值对的一个部分。键是一种常见的标签，行为类似于更具体的标签值的类别。

value

类型：字符串

长度约束：最小长度为 0。长度上限为 256。

必需：否

构成标签的键-值对的可选部分。值充当标签类别（键）中的描述符。

enableECSManagedTags

指定是否要为该服务内的任务使用 Amazon ECS 托管标签。有关更多信息，请参阅标记资源以便于计费。

propagateTags

类型：字符串

有效值：TASK_DEFINITION | SERVICE

必需：否

指定是否要将标签从任务定义或服务复制到服务中的任务。如果未指定值，则不会复制标签。只能在创建服务的过程中将标签复制到服务中的任务。要在创建服务或任务以后将标签添加到任务，请使用 TagResource API 操作。

healthCheckGracePeriodSeconds

类型：整数

必需：否

在任务进入 RUNNING 状态后， Amazon ECS 服务计划程序应忽略不正常的 Elastic Load Balancing 目标运行状况检查、容器运行状况检查以及 Route 53 运行状况检查的时间段（以秒为单位）。您的服务只有配置为使用负载均衡器时此设置才适用。如果您的服务定义了负载均衡器，并且您没有指定运行状况检查宽限期值，则使用默认值 0。

如果您的服务的任务需要一段时间才能启动和响应运行状况检查，则您最长可以指定 2,147,483,647 秒的运行状况检查宽限期，在此期间，ECS 服务计划程序将忽略运行状况检查状态。此宽限期可防止 ECS 服务计划程序将由于时间不足尚未启动的任务标记为不正常并停止它们。

如果您不使用 Elastic Load Balancing，我们建议您在任务定义运行状况检查参数中使用 startPeriod。有关更多信息，请参阅运行状况检查。

schedulingStrategy

要使用的计划策略。使用外部部署控制器的服务仅支持 REPLICA 计划策略。有关更多信息，请参阅服务计划程序概念。

placementConstraints

您的服务中的任务使用的一组放置约束对象。对于每个任务，您可以指定多达 10 种约束（此限制包括任务定义中的约束和这些在运行时指定的约束）。如果您使用的是 Fargate 启动类型，则不支持任务放置约束。

placementStrategy

您的服务中的任务所用的放置策略对象。对于每项服务，您最多可以指定 4 种策略。

下面是使用外部部署控制器创建服务的示例服务定义。
```
{
    "cluster": "",
    "serviceName": "",
    "desiredCount": 0,
    "role": "",
    "deploymentConfiguration": {
        "maximumPercent": 0,
        "minimumHealthyPercent": 0
    },
    "placementConstraints": [
        {
            "type": "distinctInstance",
            "expression": ""
        }
    ],
    "placementStrategy": [
        {
            "type": "binpack",
            "field": ""
        }
    ],
    "healthCheckGracePeriodSeconds": 0,
    "schedulingStrategy": "REPLICA",
    "deploymentController": {
        "type": "EXTERNAL"
    },
    "tags": [
        {
            "key": "",
            "value": ""
        }
    ],
    "enableECSManagedTags": true,
    "propagateTags": "TASK_DEFINITION"
}
```
创建初始任务集。任务集包含有关您的服务的以下详细信息：
taskDefinition

要使用的任务集中的任务的任务定义。

launchType

类型：字符串

有效值：EC2 |FARGATE |EXTERNAL

必需：否

运行您的服务的启动类型。如果没有指定启动类型，将默认使用默认的 capacityProviderStrategy。有关更多信息，请参阅 Amazon ECS 启动类型。

如果指定 launchType，必须省略 capacityProviderStrategy 参数。

platformVersion

类型：字符串

必需：否

正在运行服务中任务的平台版本。仅为使用 Fargate 启动类型的任务指定平台版本。如果没有指定任何版本，将默认使用最新版本 (LATEST)。

Amazon Fargate 平台版本用于指代任务基础设施的特定运行时环境。在运行任务或创建服务的过程中指定 LATEST 平台版本时，您将获得可用于任务的最新平台版本。当您扩展服务时，这些任务将收到在服务的当前部署中指定的平台版本。有关更多信息，请参阅 Fargate Linux 平台版本。

注意
不会使用 EC2 启动类型为任务指定平台版本。

loadBalancers
表示要用于您的服务的负载均衡器的负载均衡器对象。使用外部部署控制器时，仅支持 Application Load Balancer 和 Network Load Balancer。如果您使用 Application Load Balancer，每个任务集仅允许一个 Application Load Balancer 目标组。

以下代码段显示要使用的示例 loadBalancer 对象。
```
"loadBalancers": [
        {
            "targetGroupArn": "",
            "containerName": "",
            "containerPort": 0
        }
]
```
注意
指定 loadBalancer 对象时，必须指定 targetGroupArn 并忽略 loadBalancerName 参数。
networkConfiguration

服务的网络配置。对于使用 awsvpc 网络模式接收其自己的弹性网络接口的任务定义，该参数是必需的，其他网络模式不支持该参数。有关 Amazon EC2 启动类型联网的更多信息，请参阅 Fargate 任务联网。有关 Fargate 启动类型联网的更多信息，请参阅 Fargate 上的任务的任务联网。

serviceRegistries

要分配给此服务的服务发现注册表的详细信息。有关更多信息，请参阅服务发现。

scale

要在任务集中放置并保持运行的任务的预期数量的浮点百分比。该值以服务的 desiredCount 的总数的百分比的形式指定。接受的值为 0 到 100 之间的数字。
以下是为外部部署控制器创建任务集的 JSON 示例。
```
{
    "service": "",
    "cluster": "",
    "externalId": "",
    "taskDefinition": "",
    "networkConfiguration": {
        "awsvpcConfiguration": {
            "subnets": [
                ""
            ],
            "securityGroups": [
                ""
            ],
            "assignPublicIp": "DISABLED"
        }
    },
    "loadBalancers": [
        {
            "targetGroupArn": "",
            "containerName": "",
            "containerPort": 0
        }
    ],
    "serviceRegistries": [
        {
            "registryArn": "",
            "port": 0,
            "containerName": "",
            "containerPort": 0
        }
    ],
    "launchType": "EC2",
    "capacityProviderStrategy": [
        {
            "capacityProvider": "",
            "weight": 0,
            "base": 0
        }
    ],
    "platformVersion": "",
    "scale": {
        "value": null,
        "unit": "PERCENT"
    },
    "clientToken": ""
}
```
需要服务更改时，请使用 UpdateService、UpdateTaskSet 或 CreateTaskSet API 操作，具体取决于您要更新的参数。如果创建了任务集，请使用服务中每个任务集的 scale 参数以确定要在服务中保持运行的任务数量。例如，如果您有一个包含 tasksetA 的服务并且创建一个 tasksetB，则您可能在希望向其过渡生产流量之前测试 tasksetB 的有效性。您可以将两个任务集的 scale 设置为 100，并且在您已准备好将所有生产流量过渡到 tasksetB 时，您可以将 tasksetA 的 scale 更新为 0 以缩小规模。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

通过 CodeDeploy 进行蓝/绿部署

使用负载均衡分配 Amazon ECS 服务流量