更新 Amazon ECS 服务参数

指示是否对服务使用可用区域重新平衡。

您可以更改此参数以进行滚动部署。

容量提供程序策略的详细信息。您可以在创建集群、运行任务或更新服务时设置容量提供程序。

使用 Fargate 时，容量提供程序为 FARGATE 或 FARGATE_SPOT。

当您使用 Amazon EC2 时，容量提供程序为自动扩缩组。

您可以更改容量提供程序以进行滚动部署和蓝绿部署。

以下列表提供了有效的转换：

您无法更改集群名称。

部署配置包括 CloudWatch 警报、用于检测故障的断路器以及所需的配置。

部署断路器属性确定如果服务无法达到稳定状态，服务部署是否会失败。如果使用部署断路器，服务部署将转变为失败状态并停止启动新任务。如果使用回滚选项，当服务部署失败时，服务将回滚到成功完成的最后一个部署。

当您更新使用 Amazon ECS 断路器的服务时，Amazon ECS 会创建服务部署和服务修订。这些资源允许您查看有关服务历史记录的详细信息。有关更多信息，请参阅 使用 Amazon ECS 服务部署查看服务历史记录。

服务计划程序将使用最小正常百分比和最大百分比参数（在服务的部署配置中）确定部署策略。

如果服务使用滚动更新（ECS）部署类型，最小正常百分比以预期任务数的百分比形式表示部署期间必须保持在 RUNNING 状态的服务中的任务数的下限（向上取整到最近的整数）。如果服务包含使用 EC2 启动类型的任务，则在任何容器实例处于 DRAINING 状态时，此参数也适用。可以使用此参数进行部署，而无需使用额外的集群容量。例如，如果您的服务的预期任务数为 4，最小正常百分比为 50%，则计划程序可能在开始两个新任务之前停止两个现有任务以释放集群容量。如果未使用负载均衡器的服务状态为 RUNNING，则服务认为任务正常运行。如果使用负载均衡器的服务任务处于 RUNNING 状态，并且该负载均衡器将其报告为正常，则服务认为这些任务正常运行。最小正常百分比的默认值为 100%。

如果服务使用滚动更新（ECS）部署类型，则最大百分比参数将以预期任务数的百分比形式表示部署期间允许处于 PENDING、RUNNING 或 STOPPING 状态的服务中任务数的上限（向下取整到最近的整数）。如果服务包含使用 EC2 启动类型的任务，则在任何容器实例处于 DRAINING 状态时，此参数也适用。可以使用此参数定义部署批次大小。例如，如果您的服务的预期任务数为 4，最大百分比值为 200%，则计划程序可能在停止 4 个旧任务之前开始 4 个新任务。这样做的前提是具有执行此操作所需的集群资源。最大百分比的默认值为 200%。

当服务计划程序在更新期间替换某个任务时，服务首先会从负载均衡器（如果使用了）中删除此任务并等待连接耗尽。然后，将向此任务中运行的容器发出 docker stop 的等效项。这将产生 SIGTERM 信号和 30 秒的超时，此后，将发送 SIGKILL 并强制停止容器。如果容器正常处理了 SIGTERM 信号并在收到信号后的 30 秒内退出，则不会发送任何 SIGKILL 信号。服务计划程序将启动并停止您的最小正常百分比和最大百分比设置定义的任务。

在容器运行状况检查或负载均衡器目标组运行状况检查失败后，服务计划程序还会替换被确定为运行状况不佳的任务。此替换取决于 maximumPercent 和 desiredCount 服务定义参数。如果任务被标记为运行状况不佳，则服务计划程序将首先启动替换任务。然后会发生以下情况。

如果 maximumPercent 参数限制计划程序先启动替换任务，则计划程序将一次随机停止一个运行状况不佳的任务以释放容量，然后启动替换任务。启动和停止过程将继续，直到所有运行状况不佳的任务都被运行状况正常的任务所替换。替换了所有运行状况不佳的任务并且只有运行正常的任务后，如果任务总数超过 desiredCount，则会随机停止运行状况正常的任务，直到任务总数等于 desiredCount。有关 maximumPercent 和 desiredCount 的更多信息，请参阅服务定义参数。

在您的服务中置放并保持运行的实例化任务数量。

如果要暂时停止服务，请将该值设置为 0。然后，当您准备好启动服务时，请使用原始值更新该服务。

您可以更改此参数以进行滚动部署和蓝绿部署。

确定是否要为该服务中的任务启用 Amazon ECS 托管标签。

只有在更新后启动的任务才会反映更新。要更新所有任务的标签，请使用强制部署选项。

您可以更改此参数以进行滚动部署和蓝绿部署。

确定是否使用 Amazon ECS Exec。

如果您不想覆盖创建服务时设置的值，则可以在执行此操作时将其设置为空。

您可以更改此参数以进行滚动部署。

任务首次启动后的一段时间（以秒为单位），在此段时间内，Amazon ECS 服务计划程序将忽略未正常运行的 Elastic Load Balancing、VPC Lattice 和容器运行状况检查。如果没有指定运行状况检查宽限期值，则使用默认值 0。如果不使用任何运行状况检查，则未使用 healthCheckGracePeriodSeconds。

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

您可以更改此参数以进行滚动部署和蓝绿部署。

更新负载均衡器时，必须使用服务相关角色。

Elastic Load Balancing 负载均衡器对象列表。它包含负载均衡器名称、容器名称和要从负载均衡器访问的容器端口。容器名称与在容器定义中显示的名称相同。

Amazon ECS 不会自动更新与 Elastic Load Balancing 负载均衡器或 Amazon ECS 容器实例关联的安全组。

当您添加、更新或删除负载均衡器配置时，Amazon ECS 会使用更新后的 Elastic Load Balancing 配置启动新任务，然后在新任务运行时停止旧任务。

对于使用滚动更新的服务，您可以添加、更新或删除 Elastic Load Balancing 目标组。您可以从单个目标组更新为多个目标组，也可以从多个目标组更新为单个目标组。

对于使用蓝绿部署的服务，您可以通过 CodeDeploy 使用 CreateDeployment 更新 Elastic Load Balancing 目标组。请注意，蓝绿部署不支持多个目标组。有关详细信息，请参阅向服务注册多个目标组。

对于使用外部部署控制器的服务，您可以使用 CreateTaskSet 添加、更新或删除负载均衡器。请注意，外部部署不支持多个目标组。有关详细信息，请参阅向服务注册多个目标组。

传递一个空列表以删除负载均衡器。

您可以更改此参数以进行滚动部署。

服务网络配置。

您可以更改此参数以进行滚动部署。

用于更新要使用的服务的任务置放约束对象数组。如果未指定任何值，则服务的现有置放约束将保持不变。如果指定了该值，它将覆盖为服务定义的所有现有置放约束。要删除所有现有置放约束，请指定空数组。

您可以为每个任务指定最多 10 个约束。此限制包括任务定义中的约束以及在运行时指定的约束。

您可以更改此参数以进行滚动部署和蓝绿部署。

用于更新要使用的服务的任务置放策略对象。如果未指定任何值，则服务的现有置放策略将保持不变。如果指定了该值，则它将覆盖为服务定义的现有置放策略。要删除现有的置放策略，请指定一个空对象。

您可以更改此参数以进行滚动部署和蓝绿部署。

运行您的服务的 Fargate 平台版本。

使用 Linux 平台版本的服务无法更新为使用 Windows 平台版本，反之亦然。

您可以更改此参数以进行滚动部署。

确定是否要将标签从任务定义或服务传播到任务。如果未指定任何值，则不会传播标签。

只有在更新后启动的任务才会反映更新。要更新所有任务的标签，请将 forceNewDeployment 设置为 true，以便 Amazon ECS 使用更新的标签启动新任务。

您可以更改此参数以进行滚动部署和蓝绿部署。

Amazon ECS Service Connect 的配置。此参数决定服务如何连接到应用程序中的其他服务。

您可以更改此参数以进行滚动部署。

更新服务注册表时，必须使用服务相关角色。

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

当您添加、更新或删除服务注册表配置时，Amazon ECS 会使用更新后的服务注册表配置启动新任务，然后在新任务运行时停止旧任务。

传递一个空列表以删除服务注册表。

您可以更改此参数以进行滚动部署。

用于服务的任务定义和修订。

如果要在任务定义中更改容器使用的端口，您可能需要更新容器实例的安全组以使用更新后的端口。

如果您更新服务的任务定义，则在负载均衡器中指定的容器名称和容器端口必须保留在任务定义中。

容器映像拉取行为因启动类型而异。有关更多信息，请参阅以下章节之一：

您可以更改此参数以进行滚动部署。

为 configuredAtLaunch 的卷的详细信息。设置为 true 时，此参数将在部署期间配置 Amazon EBS 任务附件。您可以在 ServiceManagedEBSVolumeConfiguration 中配置大小、卷类型、IOPS、吞吐量、快照和加密。卷的 name 必须与任务定义中的 name 相匹配。如果设置为空，则不会触发任何新部署。否则，如果此配置与现有配置不同，则会触发新的部署。

您可以更改此参数以进行滚动部署。

服务的 VPC Lattice 配置。这定义了您的服务如何与 VPC Lattice 集成以进行服务间通信。

您可以更改此参数以进行滚动部署。