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

排查 Amazon ECS 部署问题

等待替换任务集时出现超时

问题：在使用以下方式部署 Amazon ECS 应用程序时，您会看到以下错误消息 CodeDeploy：

The deployment timed out while waiting for the replacement task set to become healthy. This time out period is 60 minutes.

可能的原因：如果您的任务定义文件或其他与部署相关的文件中存在错误，则可能会出现此错误。例如，如果您的任务定义文件中的 image 字段中有拼写错误，Amazon ECS 将尝试提取错误的容器映像并持续失败，从而导致此错误。

可能的解决方法和后续步骤：

等待通知继续时出现超时

问题：在使用以下方式部署 Amazon ECS 应用程序时，您会看到以下错误消息 CodeDeploy：

The deployment timed out while waiting for a notification to continue. This time out period is n minutes.

可能的原因：如果您在创建部署组时在指定重新路由流量的时间字段中指定了等待时间，但是在等待时间结束之前部署未能完成，则可能会发生此错误。

可能的解决方法和后续步骤：

IAM 角色没有足够的权限

问题：在使用以下方式部署 Amazon ECS 应用程序时，您会看到以下错误消息 CodeDeploy：

The IAM role role-arn does not give you permission to perform operations in the following AWS service: AWSLambda.

可能的原因：如果您在AppSpec 文件Hooks部分指定了 Lambda 函数，但未 CodeDeploy 授予 Lambda 服务的权限，则可能会发生此错误。

可能的解决方法：为 CodeDeploy 服务角色添加lambda:InvokeFunction权限。要添加此权限，请向该角色添加以下 AWS托管策略之一：AWSCodeDeployRoleForECS 或 AWSCodeDeployRoleForECSLimited。有关这些策略以及如何将其添加到 CodeDeploy 服务角色的信息，请参阅步骤 2：为创建服务角色 CodeDeploy。

等待状态回调时部署超时

问题：在使用以下方式部署 Amazon ECS 应用程序时，您会看到以下错误消息 CodeDeploy：

The deployment timed out while waiting for a status callback. CodeDeploy expects a status callback within one hour after a deployment hook is invoked.

可能的原因：如果您在AppSpec 文件Hooks部分指定了 Lambda 函数，但是 Lambda Succeeded 函数无法调用必要的 PutLifecycleEventHookExecutionStatus API 来返回或状态，则可能会发生此错误。Failed CodeDeploy

可能的解决方法和后续步骤：

由于一个或多个生命周期事件验证函数失败，部署失败

问题：在使用以下方式部署 Amazon ECS 应用程序时，您会看到以下错误消息 CodeDeploy：

The deployment failed because one or more of the lifecycle event validation functions failed.

可能的原因：如果您在AppSpec 文件Hooks部分中指定了 Lambda 函数，但是 Lambda 函数在调用时返回Failed到 CodeDeploy ，则可能会发生此错误。PutLifecycleEventHookExecutionStatus此失败 CodeDeploy 表示生命周期验证测试失败。

下一步可能采取的措施：检查您的 Lambda 执行日志，了解验证测试代码失败的原因。有关 Lambda 执行日志的信息，请参阅访问亚马逊 CloudWatch 日志。 AWS Lambda

由于以下错误，ELB 无法更新：主任务集目标组必须位于监听器之后

问题：在使用以下方式部署 Amazon ECS 应用程序时，您会看到以下错误消息 CodeDeploy：

The ELB could not be updated due to the following error: Primary taskset target group must be behind listener

可能的原因：如果您配置了可选的测试侦听器，并且配置了错误的目标组，则可能会出现此错误。有关中测试侦听器的更多信息 CodeDeploy，请参见在您开始ECS部署 Amazon 之前和Amazon ECS 部署期间会发生什么。有关任务集的更多信息，请参阅TaskSet《亚马逊弹性容器服务 API 参考》和describe-task-set《AWS CLI 命令参考》的 Amazon ECS 部分。

可能的解决方法：确保 Elastic Load Balancing 的生产侦听器和测试侦听器都指向当前为您的工作负载提供服务的目标组。有三个地方需要检查：

使用 Auto Scaling 时，我的部署有时会失败

问题：您正在将 Auto Scaling CodeDeploy 与一起使用，但发现部署偶尔会失败。有关此问题症状的详细信息，请参阅《Amazon Elastic Container Service 开发人员指南》中的主题对于配置为使用服务自动扩缩和蓝绿部署类型的服务，在部署期间不会阻止自动扩缩，但在某些情况下部署可能会失败。

可能的原因：如果 CodeDeploy 和 Auto Scaling 进程发生冲突，则可能会出现此问题。

可能的解决方法：在 CodeDeploy 部署期间使用 RegisterScalableTarget API（或相应的register-scalable-target AWS CLI 命令）暂停和恢复 Auto Scaling 进程。有关更多信息，请参阅《Application Auto Scaling 用户指南》中的暂停和恢复 Application Auto Scaling 扩缩。

只有 ALB 支持渐进式流量路由，创建/更新部署组时请改用 AllAtOnce 流量路由

问题：在中创建或更新部署组时，您会看到以下错误消息 CodeDeploy：

Only ALB supports gradual traffic routing, use AllAtOnce Traffic routing instead when you create/update Deployment group.

可能的原因：如果您使用的是网络负载均衡器并尝试使用除 CodeDeployDefault.ECSAllAtOnce 之外的预定义部署配置，则可能会发生此错误。

可能的修复措施：

尽管我的部署成功了，但替换任务集未通过 Elastic Load Balancing 运行状况检查，而且我的应用程序已关闭

问题：尽管 CodeDeploy 表明我的部署成功，但替换任务集未通过 Elastic Load Balancing 的运行状况检查，并且我的应用程序已关闭。

可能的原因：如果您执行了 CodeDeploy all-at-once 部署，并且您的替换（绿色）任务集包含导致 Elastic Load Balancing 运行状况检查失败的错误代码，则可能会出现此问题。使用 all-at-once 部署配置，在流量转移到替换任务集之后（也就是说，AllowTraffic生命周期事件发生之后），负载均衡器的运行状况检查就会开始 CodeDeploy对替换任务集运行。这就是为什么在流量转移之后，替换任务集的运行状况检查会失败，而在流量转移前却没有。有关 CodeDeploy 生成的生命周期事件的信息，请参阅Amazon ECS 部署期间会发生什么。

可能的修复措施：

我能否将多个负载均衡器连接到一个部署组？

不是。 如果您想使用多个应用程序负载均衡器或网络负载均衡器，请使用 Amazon ECS 滚动更新而不是 CodeDeploy 蓝/绿部署。有关滚动更新的更多信息，请参阅《Amazon Elastic Container Service 开发人员指南》中的滚动更新。有关对 Amazon ECS 使用多个负载均衡器的更多信息，请参阅《Amazon Elastic Container Service 开发人员指南》中的向服务注册多个目标组。

我能否在没有负载均衡器的情况下执行 CodeDeploy 蓝/绿部署？

不，如果没有负载均衡器，则无法执行 CodeDeploy 蓝/绿部署。如果您无法使用负载均衡器，请改用 Amazon ECS 的滚动更新功能。有关 Amazon ECS 滚动更新的更多信息，请参阅《Amazon Elastic Container Service 开发人员指南》中的滚动更新。

在部署过程中，如何使用新信息更新我的 Amazon ECS 服务？

要在您的 Amazon ECS 服务进行部署时使用新参数对其进行 CodeDeploy 更新，请在 AppSpec 文件resources部分中指定该参数。仅支持少数 Amazon ECS 参数 CodeDeploy，例如任务定义文件和容器名称参数。有关 CodeDeploy 可以更新的 Amazon ECS 参数的完整列表，请参阅 AppSpec Amazon ECS 部署的 “资源” 部分。