上的部署Amazon ECS 计算平台 - AWS CodeDeploy
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

上的部署Amazon ECS 计算平台

本主题提供有关 CodeDeploy 使用 Amazon ECS 计算平台.

在开始 Amazon ECS 部署之前

在开始 Amazon ECS 应用程序部署之前,必须准备好以下事项。创建部署组时指定了一些要求,并且某些要求在 中指定。AppSpec file.

要求 指定的位置
Amazon ECS 集群 部署组
Amazon ECS 服务 部署组
应用程序负载均衡器 或 Network Load Balancer 部署组
生产侦听器 部署组
测试侦听器(可选) 部署组
两个目标组 部署组
Amazon ECS 任务定义 AppSpec file
容器名称 AppSpec file
容器端口 AppSpec file
Amazon ECS 集群

一个 Amazon ECS 群集 是任务或服务的逻辑分组。您指定 Amazon ECS 包含您的 Amazon ECS 创建您的 CodeDeploy 应用程序的部署组。有关详细信息,请参阅 Amazon ECS 群集Amazon Elastic Container Service 用户指南.

Amazon ECS 服务

一个 Amazon ECS 服务 在某个 Amazon ECS 群集。 必须已启用 Amazon ECS 服务。CodeDeploy. 默认情况下, Amazon ECS 已启用服务 Amazon ECS 部署。创建部署组时,您选择部署 Amazon ECS 在您的 Amazon ECS 群集。有关详细信息,请参阅 Amazon ECS 服务Amazon Elastic Container Service 用户指南.

应用程序负载均衡器 或 Network Load Balancer

您必须使用 Elastic Load Balancing 与 Amazon ECS 您希望使用 Amazon ECS 部署。您可以使用 应用程序负载均衡器 或 。Network Load Balancer. 我们建议使用 应用程序负载均衡器,以便您可以利用动态端口映射和基于路径的路由和优先级规则等功能。在创建 CodeDeploy 应用程序的部署组时,您需要指定负载均衡器。有关详细信息,请参阅 设置负载均衡器、目标组和侦听器 CodeDeploy Amazon ECS 部署创建负载均衡器Amazon Elastic Container Service 用户指南.

一个或两个侦听器

A 倾听者 由负载平衡器使用,以直接流量到目标组。必须提供一个生产侦听器。您可以指定可选的第二个测试侦听器,在您运行验证测试时该侦听器可以将流量定向到替换任务集。在创建部署组时,您需要指定一个或两个侦听器。如果您使用 Amazon ECS 创建您的 Amazon ECS 服务,您的倾听者已为您创建。有关详细信息,请参阅 适用于您的应用负载平衡器的听众Elastic Load Balancing 用户指南创建服务Amazon Elastic Container Service 用户指南.

两个 Amazon ECS 目标组

A 目标组 用于将流量路由到已注册目标。一个 Amazon ECS 部署需要两个目标组:一个用于您的 Amazon ECS 应用程序的原始任务集,一个用于其替换任务集。在部署过程中,CodeDeploy 会创建替换任务集,并将流量从原始任务集重新路由到新的任务集。在创建 CodeDeploy 应用程序的部署组时,您需要指定目标组。

在部署期间, CodeDeploy 确定哪个目标组与您的 Amazon ECS 有状态的服务 PRIMARY (这是原始任务集),并将一个目标组与其相关联,然后将其他目标群组与替换任务集合相关联。如果执行其他部署,则与当前部署的原始任务集关联的目标组将与下一个部署的替换任务集关联。有关详细信息,请参阅 用于应用负载平衡器的目标组Elastic Load Balancing 用户指南.

一个 Amazon ECS 任务定义

A 任务定义 需要运行包含 Amazon ECS 应用。您在您的 CodeDeploy 应用程序 AppSpec file. 有关详细信息,请参阅 Amazon ECS 任务定义Amazon Elastic Container Service 用户指南 AppSpec 部署的“resources”部分Amazon ECS .

您的 Amazon ECS 应用程序的容器

靠泊装置 容器 是包装代码及其依赖关系的软件单元,可以运行您的应用程序。容器可以隔离您的应用程序,使其在不同的计算环境中运行。负载均衡器将流量定向到 Amazon ECS 应用程序任务集中的容器。您在您的 CodeDeploy 应用程序 AppSpec file. 在您的 AppSpec file 必须是您的 Amazon ECS 任务定义。有关详细信息,请参阅 什么是 Amazon Elastic Container Service?Amazon Elastic Container Service 用户指南 AppSpec 部署的“resources”部分Amazon ECS .

您的替换任务集的端口

在您的 Amazon ECS 部署,您的负载平衡器将流量指向此 端口 在您的 CodeDeploy 应用程序 AppSpec file. 您在您的 CodeDeploy 应用程序 AppSpec file. 有关更多信息,请参阅 AppSpec 部署的“resources”部分Amazon ECS .

AmazonECS计算平台上的部署组件

下图显示了 CodeDeploy 部署 Amazon ECS 计算平台.

AmazonECS计算平台上的部署工作流程(高级别)

下图显示部署更新的 Amazon ECS 服务的主要步骤。

这些步骤包括:

  1. 通过指定一个唯一表示要部署的内容的名称,创建 AWS CodeDeploy 应用程序。要部署 Amazon ECS 应用程序, AWS CodeDeploy 应用,选择 Amazon ECS 计算平台... CodeDeploy 在部署期间使用应用程序引用正确的部署组件,例如部署组、目标组、侦听器和流量重新路由行为以及应用程序修订版。有关更多信息,请参阅 创建应用程序 CodeDeploy.

  2. 通过指定以下内容设置部署组:

    • 部署组名称。

    • 您的 Amazon ECS 集群和服务名称。TheThethe Amazon ECS 服务的部署控制器必须设置为 CodeDeploy.

    • 生产侦听器、可选的测试侦听器以及在部署期间使用的目标组。

    • 部署设置,例如何时将生产流量重新运送到更换 Amazon ECS 在您的 Amazon ECS 服务以及何时终止原始 Amazon ECS 在您的 Amazon ECS 服务。

    • 可选设置,如触发器、警报和回滚行为。

  3. 指定一个 ()。application specification file (AppSpec file). 您可以将其上传到 Amazon S3,将其输入到YAML或JSON格式的控制台中,或者使用 AWS CLI 或SDK。TheThethe AppSpec file 指定 Amazon ECS 部署的任务定义、用于路由流量的容器名称和端口映射,以及 Lambda 部署生命周期挂钩之后运行的功能。容器名称必须是您的 Amazon ECS 任务定义中的容器。有关更多信息,请参阅 处理应用程序修订版 CodeDeploy.

  4. 部署您的应用程序修订版。 AWS CodeDeploy 从您的 Amazon ECS 服务至新的替换任务集。部署组中指定的目标组用于处理传输到原始和替换任务集的流量。在部署完成后,会终止原始任务集。您可以指定一个可选的测试侦听器,以便在将流量重新路由到替换版本之前为其提供测试流量。有关更多信息,请参阅 使用 CodeDeploy 创建部署.

  5. 检查部署结果。有关更多信息,请参阅 监控部署 CodeDeploy.

在一个 Amazon ECS 部署

在启动具有测试侦听器的 Amazon ECS 部署之前,您必须配置其组件。有关更多信息,请参阅 在开始 Amazon ECS 部署之前.

下图显示了在准备好启动 Amazon ECS 部署时,这些组件之间的关系。

当部署启动时,开始一次执行一个部署生命周期事件。某些生命周期事件是唯一执行的挂钩 Lambda 在 AppSpec file. 下表中的部署生命周期事件按照执行的顺序列出。有关更多信息,请参阅 AppSpec 部署的 Amazon ECS“hooks”部分.

生命周期事件 生命周期事件操作
BeforeInstall (一个挂钩 Lambda 功能) 运行 Lambda 函数。
安装 设置替换任务集。
AfterInstall (一个挂钩 Lambda 功能) 运行 Lambda 函数。
AllowTestTraffic 将流量从测试侦听器路由至目标组 2。
AfterAllowTestTraffic (一个挂钩 Lambda 功能) 运行 Lambda 函数。
BeforeAllowTraffic (一个挂钩 Lambda 功能) 运行 Lambda 函数。
AllowTraffic 将流量从生产侦听器路由至目标组 2。
AfterAllowTraffic 运行 Lambda 函数。

注意

Lambda挂钩中的 函数是可选的。

  1. 执行任何 Lambda 在 BeforeInstall 挂钩 AppSpec file.

  2. Install 生命周期事件期间:

    1. 在您的 Amazon ECS 服务中创建替换任务集。

    2. 更新后的容器化应用程序安装到替换任务集中。

    3. 第二个目标组与替换任务集关联。

    此图显示具有新替换任务集的部署组件。容器化应用程序位于此任务集的内部。任务集包含三个任务。(应用程序可以有任何数量的任务。)第二个目标组现在与替换任务集相关。

  3. 执行任何 Lambda 在 AfterInstall 挂钩 AppSpec file.

  4. 调用了 AllowTestTraffic 事件。在此生命周期事件中,测试侦听器将流量路由到更新后的容器化应用程序中。

  5. 执行任何 Lambda 在 AfterAllowTestTraffic 挂钩 AppSpec file... Lambda 功能可以使用测试流量验证部署。例如,Lambda 函数可以向测试侦听器提供流量,并跟踪替换任务集的指标。如果配置了回滚,可以配置 CloudWatch 在您的 Lambda 功能失败。

    验证测试完成后,将会发生以下情况之一:

    • 如果验证失败并配置了回滚,则部署状态标记为 Failed,组件返回其开始部署时的状态。

    • 如果验证失败但未配置回滚,则部署状态标记为 Failed,并且组件保持其当前状态。

    • 如果验证成功,则部署将继续到 BeforeAllowTraffic 挂钩。

    有关详细信息,请参阅 监控部署 CloudWatch 警报 CodeDeploy自动回滚,和 为部署组配置高级选项.

  6. 执行任何 Lambda 在 BeforeAllowTraffic 挂钩 AppSpec file.

  7. 调用了 AllowTraffic 事件。生产流量从原始任务集重新路由到替换任务集。下图显示了接收生产流量的替换任务集。

  8. 执行任何 Lambda 在 AfterAllowTraffic 挂钩 AppSpec file.

  9. 所有事件成功后,部署状态设置为 Succeeded 并删除原始任务集。

上传您的应用程序修订版

放置 AppSpec file 在 Amazon S3 或者直接将其输入控制台或 AWS CLI. 有关更多信息,请参阅 应用程序规范文件.

创建应用程序和部署组

A CodeDeploy 部署组 Amazon ECS 计算平台 确定倾听者为您更新的流量提供服务 Amazon ECS 部署期间使用的应用程序和两个目标组。部署组还定义一组配置选项,例如警报和回滚配置。

部署您的应用程序修订版

现在,您已准备好部署在部署组中指定的更新的 Amazon ECS 服务。您可以使用 CodeDeploy 控制台或 create-deployment 命令。可以指定一些参数(包括修订和部署组)来控制部署。

更新您的应用程序

您可以对应用程序进行更新,然后使用 CodeDeploy 控制台或呼叫 create-deployment 命令以推送修订版。

已停止和故障部署

您可以使用 CodeDeploy 控制台或 stop-deployment 命令停止部署。当您尝试停止部署时,将发生下面三种情况之一:

  • 部署将停止,并且操作将返回成功状态。在这种情况下,没有更多的部署生命周期事件将在已停止部署的部署组上运行。

  • 部署将不会立即停止,并且操作将返回挂起状态。在这种情况下,一些部署生命周期事件可能仍在部署组上运行。在挂起的操作完成后,停止部署的后续调用将返回成功状态。

  • 部署无法停止,并且操作将返回错误。有关详细信息,请参阅 错误信息常见错误 在 AWS CodeDeploy API Reference.

重新部署和部署回滚

CodeDeploy 通过将流量从替换任务集重新路由到原始任务集来实现回滚。

您可以对部署组进行配置,使之在满足特定条件(例如部署失败或达到警报监控阈值)时自动回滚部署。您还可以在单个部署中覆盖为部署组指定的回滚设置。

另外,也可以选择通过手动重新部署以前部署的版本回滚失败的部署。

在所有情况下,新的或回滚的部署都分配有自己的部署 ID。TheThethe CodeDeploy 控制台显示自动部署结果的部署列表。

如果进行重新部署,则与当前部署的原始任务集关联的目标组将与重新部署的替换任务集关联。

有关更多信息,请参阅 使用 CodeDeploy 重新部署和回滚部署.

Amazon ECS 蓝色/绿色部署 AWS CloudFormation

您可以使用 AWS CloudFormation 管理 Amazon ECS 蓝色/绿色部署 CodeDeploy. 有关更多信息,请参阅 通过 Amazon ECS 创建 AWS CloudFormation 蓝/绿部署.

注意

管理 Amazon ECS 蓝色/绿色部署 AWS CloudFormation 不适用于非洲(开普敦)、亚太地区(大阪本地人)、中国(北京/宁夏)或欧洲(米兰)地区。