本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# CodeDeploy 部署
本主题提供 CodeDeploy 中部署的组件和工作流的相关信息。部署过程会有所不同，具体取决于您用于部署的计算平台或部署方法（Lambda、Amazon ECS、EC2/本地或通过 AWS CloudFormation）。
**Topics**
+ [在 AWS Lambda 计算平台上部署](deployment-steps-lambda.md)
+ [Amazon ECS 计算平台上的部署](deployment-steps-ecs.md)
+ [EC2/本地计算平台上的部署](deployment-steps-server.md)
# 在 AWS Lambda 计算平台上部署
本主题提供有关使用 AWS Lambda 计算平台的 CodeDeploy 部署的组件和工作流程的信息。
**Topics**
+ [AWS Lambda 计算平台上的部署工作流程](#deployment-process-workflow-lambda)
+ [上传应用程序修订](#deployment-steps-uploading-your-app-lambda)
+ [创建应用程序和部署组](#deployment-steps-registering-app-deployment-groups-lambda)
+ [部署应用程序修订](#deployment-steps-deploy-lambda)
+ [更新 应用程序](#deployment-steps-updating-your-app-lambda)
+ [停止和失败的部署](#deployment-stop-fail-lambda)
+ [重新部署和部署回滚](#deployment-rollback-lambda)
## AWS Lambda 计算平台上的部署工作流程
下图显示了部署新增和更新 AWS Lambda 函数的主要步骤。
![\[如何 CodeDeploy 部署新的或更新的 AWS Lambda 函数。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/deployment-process-lambda.png)
这些步骤包括：
1. 创建应用程序并为其指定唯一标识要部署的应用程序修订的名称。要部署 Lambda 函数，请在创建应用程序时 AWS 选择 Lambda 计算平台。 CodeDeploy 在部署期间使用此名称来确保它引用了正确的部署组件，例如部署组、部署配置和应用程序修订。有关更多信息，请参阅 [使用创建应用程序 CodeDeploy](applications-create.md)。
1. 通过指定部署组的名称设置部署组。
1. 选择部署配置以指定流量如何从原始 AWS Lambda 函数版本转移到新 Lambda 函数版本。有关更多信息，请参阅 [使用查看部署配置详细信息 CodeDeploy](deployment-configurations-view-details.md)。
1. 将*应用程序规范文件（AppSpec 文件*）上传到 Amazon S3。该 AppSpec 文件指定了 Lambda 函数版本和用于验证部署的 Lambda 函数。如果您不想创建 AppSpec 文件，则可以使用 YAML 或 JSON 直接在控制台中指定 Lambda 函数版本和 Lambda 部署验证函数。有关更多信息，请参阅 [正在处理的应用程序修订版 CodeDeploy](application-revisions.md)。
1. 将您的应用程序修订部署到部署组。 AWS CodeDeploy 将部署您指定的 Lambda 函数修订版。流量将使用您在创建应用程序时选择的部署 AppSpec 文件转移到您的 Lambda 函数修订版。有关更多信息，请参阅 [使用创建部署 CodeDeploy](deployments-create.md)。
1. 检查部署结果。有关更多信息，请参阅 [监控中的部署 CodeDeploy](monitoring.md)。
## 上传应用程序修订
将 AppSpec 文件放入 Amazon S3 或将其直接输入控制台或 AWS CLI。有关更多信息，请参阅 [CodeDeploy 应用程序规范 (AppSpec) 文件](application-specification-files.md)。
## 创建应用程序和部署组
AWS Lambda 计算平台上的 CodeDeploy 部署组可识别一个或多个 AppSpec 文件的集合。每个 AppSpec 文件可以部署一个 Lambda 函数版本。部署组还定义一些用于未来部署的配置选项，例如警报和回滚配置。
## 部署应用程序修订
现在，您可以将 AppSpec 文件中指定的函数修订版部署到部署组了。您可以使用 CodeDeploy 控制台或[创建部署命令](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html)。可以指定一些参数（包括修订、部署组和部署配置）来控制部署。
## 更新 应用程序
您可以对应用程序进行更新，然后使用 CodeDeploy 控制台或调用 [create-](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) deployment 命令来推送修订。
## 停止和失败的部署
您可以使用 CodeDeploy 控制台或[停止部署](https://docs.aws.amazon.com/cli/latest/reference/deploy/stop-deployment.html)命令来停止部署。当您尝试停止部署时，将发生下面三种情况之一：
+ 部署将停止，并且操作将返回成功状态。在这种情况下，没有更多的部署生命周期事件将在已停止部署的部署组上运行。
+ 部署将不会立即停止，并且操作将返回挂起状态。在这种情况下，一些部署生命周期事件可能仍在部署组上运行。在挂起的操作完成后，停止部署的后续调用将返回成功状态。
+ 部署无法停止，并且操作将返回错误。有关更多信息 [ErrorInformation](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ErrorInformation.html)，请参阅 AWS CodeDeploy API 参考中的[常见错误](https://docs.aws.amazon.com/codedeploy/latest/APIReference/CommonErrors.html)。
与停止的部署一样，失败的部署可能导致某些部署生命周期事件已在运行。要查明部署失败的原因，可以使用 CodeDeploy 控制台或分析失败部署中的日志文件数据。有关更多信息，请参阅[应用程序修订和日志文件清理](codedeploy-agent.md#codedeploy-agent-revisions-logs-cleanup)和[查看 CodeDeploy EC2/本地部署的日志数据](deployments-view-logs.md)。
## 重新部署和部署回滚
CodeDeploy 通过将先前部署的修订版作为新部署重新部署来实现回滚。
您可以对部署组进行配置，使之在满足特定条件（例如部署失败或达到警报监控阈值）时自动回滚部署。您还可以在单个部署中覆盖为部署组指定的回滚设置。
另外，也可以选择通过手动重新部署以前部署的版本回滚失败的部署。
在所有情况下，新的或回滚的部署都分配有自己的部署 ID。您可以在 CodeDeploy 控制台中查看的部署列表显示了哪些部署是自动部署的结果。
有关更多信息，请参阅 [使用重新部署和回滚部署 CodeDeploy](deployments-rollback-and-redeploy.md)。
# Amazon ECS 计算平台上的部署
本主题提供有关使用 Amazon ECS 计算平台的 CodeDeploy 部署组件和工作流程的信息。
**Topics**
+ [在开始 Amazon ECS 部署之前](#deployment-steps-prerequisites-ecs)
+ [Amazon ECS 计算平台上的部署工作流（高级）](#deployment-process-workflow-ecs)
+ [在 Amazon ECS 部署过程中发生的事件](#deployment-steps-what-happens)
+ [上传应用程序修订](#deployment-steps-uploading-your-app-ecs)
+ [创建应用程序和部署组](#deployment-steps-registering-app-deployment-groups-ecs)
+ [部署应用程序修订](#deployment-steps-deploy-ecs)
+ [更新应用程序](#deployment-steps-updating-your-app-ecs)
+ [停止和失败的部署](#deployment-stop-fail-ecs)
+ [重新部署和部署回滚](#deployment-rollback-ecs)
+ [通过 Amazon ECS blue/green 部署 AWS CloudFormation](#deployment-steps-ecs-cf)
## 在开始 Amazon ECS 部署之前
在开始 Amazon ECS 应用程序部署之前，必须准备好以下事项。有些要求是在创建部署组时指定的，有些则在 AppSpec 文件中指定。
****
| 要求 | 指定的位置 |
| --- | --- |
| Amazon ECS 集群 | 部署组 |
| Amazon ECS 服务 | 部署组 |
| 应用程序负载均衡器和网络负载均衡器 | 部署组 |
| 生产侦听器 | 部署组 |
| 测试侦听器（可选） | 部署组 |
| 两个目标组 | 部署组 |
| Amazon ECS 任务定义 | AppSpec 文件 |
| 容器名称 | AppSpec 文件 |
| 容器端口 | AppSpec 文件 |
**Amazon ECS 集群**
Amazon ECS *集群*是任务或服务的逻辑分组。在创建 CodeDeploy 应用程序的部署组时，您可以指定包含您的 Amazon ECS 服务的 Amazon ECS 集群。有关更多信息，请参阅《Amazon Elastic Container Service 用户指南》**中的 [Amazon ECS 集群](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_clusters.html)。
**Amazon ECS 服务**
Amazon ECS *服务* 维护并运行 Amazon ECS 集群中任务定义的指定实例。必须启用您的 Amazon ECS 服务 CodeDeploy。默认情况下，Amazon ECS 部署已启用 Amazon ECS 服务。当您创建部署组时，您需要选择部署 Amazon ECS 集群中的 Amazon ECS 服务。有关更多信息，请参阅《Amazon Elastic Container Service 用户指南》**中的 [Amazon ECS 服务](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html)。
**应用程序负载均衡器和网络负载均衡器**
您必须将 Elastic Load Balancing 与要通过部署 Amazon ECS 进行更新的 Amazon ECS 服务一起使用。您可以使用应用程序负载均衡器或网络负载均衡器。我们建议使用应用程序负载均衡器，以便您可以利用动态端口映射和基于路径的路由和优先级规则等功能。您可以在创建 CodeDeploy 应用程序的部署组时指定负载均衡器。有关更多信息，请参阅《Amazon Elastic Container Service 用户指南》**中的[为 A CodeDeploy mazon ECS 部署设置负载均衡器、目标组和侦听器](deployment-groups-create-load-balancer-for-ecs.md)和[创建负载均衡器](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-load-balancer.html)。
**一个或两个侦听器**
*侦听器* 由负载均衡器用于将流量定向到目标组。必须提供一个生产侦听器。您可以指定可选的第二个测试侦听器，在您运行验证测试时该侦听器可以将流量定向到替换任务集。在创建部署组时，您需要指定一个或两个侦听器。如果您使用 Amazon ECS 控制台创建 Amazon ECS 服务，系统会为您创建侦听器。有关更多信息，请参阅《Elastic Load Balancing 用户指南》**中的[应用程序负载均衡器的侦听器](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listener.html)和《Amazon Elastic Container Service 用户指南》**中的[创建服务](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-service.html)。
**两个 Amazon ECS 目标群体**
*目标组* 用于将流量路由到一个注册目标。一个 Amazon ECS 部署需要两个目标组：一个用于 Amazon ECS 应用程序的原始任务集，另一个用于其替换任务集。在部署期间， CodeDeploy 创建替换任务集并将流量从原始任务集重新路由到新任务集。在创建 CodeDeploy 应用程序的部署组时，您需要指定目标组。
在部署过程中， CodeDeploy 确定哪个目标组与您的 Amazon ECS 服务中具有状态的任务集相关联`PRIMARY`（这是原始任务集），并将一个目标组与该任务集相关联，然后将另一个目标组与替换任务集相关联。如果执行其他部署，则与当前部署的原始任务集关联的目标组将与下一个部署的替换任务集关联。有关更多信息，请参阅《Elastic Load Balancing 用户指南》**中的[应用程序负载均衡器的目标组](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html)。
**Amazon ECS 任务定义**
需要*任务定义* 才能运行包含 Amazon ECS 应用程序的 Docker 容器。您可以在 CodeDeploy 应用程序文件中指定任务定义的 AppSpec ARN。有关更多信息，请参阅《Amazon Elastic Container Service 开发人员指南》**中的 [Amazon ECS 任务定义](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html)和[AppSpec Amazon ECS 部署的 “资源” 部分](reference-appspec-file-structure-resources.md#reference-appspec-file-structure-resources-ecs)。
**您的 Amazon ECS 应用程序的容器**
Docker *容器* 是一套打包代码及其依赖项以便应用程序运行的软件。容器可以隔离您的应用程序，使其在不同的计算环境中运行。负载均衡器将流量定向到 Amazon ECS 应用程序任务集中的容器。你可以在 CodeDeploy 应用程序 AppSpec 的文件中指定容器的名称。 AppSpec 文件中指定的容器必须是 Amazon ECS 任务定义中指定的容器之一。有关更多信息，请参阅《Amazon Elastic Container Service 用户指南》**中的[什么是 Amazon Elastic Container Service？](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html)和[AppSpec Amazon ECS 部署的 “资源” 部分](reference-appspec-file-structure-resources.md#reference-appspec-file-structure-resources-ecs)。
**您的替换任务集的端口**
在 Amazon ECS 部署期间，您的负载均衡器会将流量引导到 CodeDeploy应用程序 AppSpec 文件中指定的容器上的此*端口*。你可以在 CodeDeploy 应用程序 AppSpec 的文件中指定端口。有关更多信息，请参阅 [AppSpec Amazon ECS 部署的 “资源” 部分](reference-appspec-file-structure-resources.md#reference-appspec-file-structure-resources-ecs)。
## Amazon ECS 计算平台上的部署工作流（高级）
下图显示部署更新的 Amazon ECS 服务的主要步骤。
![\[如何将应用程序作为任务集 CodeDeploy 部署到 Amazon ECS 中。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/deployment-process-ecs.png)
这些步骤包括：
1. 通过指定一个唯一代表您要部署的内容的名称来创建 AWS CodeDeploy 应用程序。要部署 Amazon ECS 应用程序，请在您的 AWS CodeDeploy 应用程序中选择 Amazon ECS 计算平台。 CodeDeploy 在部署期间使用应用程序来引用正确的部署组件，例如部署组、目标组、侦听器、流量重新路由行为以及应用程序修订。有关更多信息，请参阅 [使用创建应用程序 CodeDeploy](applications-create.md)。
1. 通过指定以下内容设置部署组：
+ 部署组名称。
+ Amazon ECS 集群和服务名称。Amazon ECS 服务的部署控制器必须设置为 CodeDeploy。
+ 生产侦听器、可选的测试侦听器以及在部署期间使用的目标组。
+ 部署设置，例如何时将生产流量重新路由到 Amazon ECS 服务中的替换 Amazon ECS 任务集以及何时终止 Amazon ECS 服务中的原始Amazon ECS任务集。
+ 可选设置，如触发器、警报和回滚行为。
1. 指定*应用程序规范文件*（AppSpec 文件）。您可以将其上传到 Amazon S3，以 YAML 或 JSON 格式将其输入控制台，或者使用 AWS CLI 或软件开发工具包进行指定。该 AppSpec 文件指定了部署的 Amazon ECS 任务定义、用于路由流量的容器名称和端口映射，以及在部署生命周期挂钩之后运行的 Lambda 函数。容器名称必须是您的 Amazon ECS 任务定义中的容器。有关更多信息，请参阅 [正在处理的应用程序修订版 CodeDeploy](application-revisions.md)。
1. 部署您的应用程序修订版。 AWS CodeDeploy 将流量从 Amazon ECS 服务中任务集的原始版本重新路由到新的替代任务集。部署组中指定的目标组用于处理传输到原始和替换任务集的流量。在部署完成后，会终止原始任务集。您可以指定一个可选的测试侦听器，以便在将流量重新路由到替换版本之前为其提供测试流量。有关更多信息，请参阅 [使用创建部署 CodeDeploy](deployments-create.md)。
1. 检查部署结果。有关更多信息，请参阅 [监控中的部署 CodeDeploy](monitoring.md)。
## 在 Amazon ECS 部署过程中发生的事件
在启动具有测试侦听器的 Amazon ECS 部署之前，您必须配置其组件。有关更多信息，请参阅 [在开始 Amazon ECS 部署之前](#deployment-steps-prerequisites-ecs)。
下图显示了在准备好启动 Amazon ECS 部署时，这些组件之间的关系。
![\[在准备好开始 Amazon ECS 部署时，负载均衡器、侦听器、目标组和任务集之间的关系。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/codedeploy-ecs-deployment-step-1.png)
当部署启动时，开始一次执行一个部署生命周期事件。某些生命周期事件是仅执行文件中指定的 Lambda 函数的 AppSpec 挂钩。下表中的部署生命周期事件按照执行的顺序列出。有关更多信息，请参阅 [AppSpec 亚马逊 ECS 部署的 “挂钩” 部分](reference-appspec-file-structure-hooks.md#appspec-hooks-ecs)。
| 生命周期事件 | 生命周期事件操作 |
| --- | --- |
| BeforeInstall（Lambda 函数的挂钩） | 运行 Lambda 函数。 |
| 安装 | 设置替换任务集。 |
| AfterInstall（Lambda 函数的挂钩） | 运行 Lambda 函数。 |
| AllowTestTraffic | 将流量从测试侦听器路由至目标组 2。 |
| AfterAllowTestTraffic（Lambda 函数的挂钩） | 运行 Lambda 函数。 |
| BeforeAllowTraffic（Lambda 函数的挂钩） | 运行 Lambda 函数。 |
| AllowTraffic | 将流量从生产侦听器路由至目标组 2。 |
| AfterAllowTraffic | 运行 Lambda 函数。 |
**注意**
挂钩中的 Lambda 函数是可选的。
1.
****
在文件中执行`BeforeInstall`挂钩中指定的任何 Lambda 函数。 AppSpec
1.
****
在 `Install` 生命周期事件期间：
1. 在您的 Amazon ECS 服务中创建替换任务集。
1. 更新后的容器化应用程序安装到替换任务集中。
1. 第二个目标组与替换任务集关联。
此图显示具有新替换任务集的部署组件。容器化应用程序位于此任务集的内部。任务集包含三个任务。（应用程序可以具有任意数量的任务。） 第二个目标组现与替换任务集关联。
![\[具有新的替换任务集的部署组件。容器化应用程序位于此任务集的内部。任务集包含三个任务。第二个目标组现与替换任务集关联。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/codedeploy-ecs-deployment-step-2.png)
1.
****
在文件中执行`AfterInstall`挂钩中指定的任何 Lambda 函数。 AppSpec
1.
****
调用了 `AllowTestTraffic` 事件。在此生命周期事件中，测试侦听器将流量路由到更新后的容器化应用程序中。
![\[测试侦听器将流量路由到更新后的容器化应用程序中。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/codedeploy-ecs-deployment-step-3.png)
1.
****
在文件中执行`AfterAllowTestTraffic`挂钩中指定的任何 Lambda 函数。 AppSpec Lambda 函数可以使用测试流量来验证部署。例如，Lambda 函数可以向测试侦听器提供流量，并跟踪替换任务集的指标。如果配置了回滚，则可以配置 CloudWatch 警报，在 Lambda 函数中的验证测试失败时触发回滚。
验证测试完成后，将会发生以下情况之一：
+ 如果验证失败并配置了回滚，则部署状态标记为 `Failed`，组件返回其开始部署时的状态。
+ 如果验证失败但未配置回滚，则部署状态标记为 `Failed`，并且组件保持其当前状态。
+ 如果验证成功，则部署将继续到 `BeforeAllowTraffic` 挂钩。
有关更多信息，请参阅 [使用 CloudWatch 警报监控部署 CodeDeploy](monitoring-create-alarms.md)、[自动回滚](deployments-rollback-and-redeploy.md#deployments-rollback-and-redeploy-automatic-rollbacks) 和 [为部署组配置高级选项](deployment-groups-configure-advanced-options.md)。
1.
****
在文件中执行`BeforeAllowTraffic`挂钩中指定的任何 Lambda 函数。 AppSpec
1.
****
调用了 `AllowTraffic` 事件。生产流量从原始任务集重新路由到替换任务集。下图显示了接收生产流量的替换任务集。
![\[替换任务集接收生产流量。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/codedeploy-ecs-deployment-step-4.png)
1.
****
在文件中执行`AfterAllowTraffic`挂钩中指定的任何 Lambda 函数。 AppSpec
1.
****
所有事件成功后，部署状态设置为 `Succeeded` 并删除原始任务集。
![\[所有事件均成功完成。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/codedeploy-ecs-deployment-step-6.png)
## 上传应用程序修订
将 AppSpec 文件放入 Amazon S3 或将其直接输入控制台或 AWS CLI。有关更多信息，请参阅 [CodeDeploy 应用程序规范 (AppSpec) 文件](application-specification-files.md)。
## 创建应用程序和部署组
Amazon ECS 计算平台上的 CodeDeploy 部署组可识别向更新后的 Amazon ECS 应用程序提供流量的侦听器和部署期间使用的两个目标组。部署组还定义一组配置选项，例如警报和回滚配置。
## 部署应用程序修订
现在，您已准备好部署在部署组中指定的更新的 Amazon ECS 服务。您可以使用 CodeDeploy 控制台或[创建部署命令](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html)。可以指定一些参数（包括修订和部署组）来控制部署。
## 更新应用程序
您可以对应用程序进行更新，然后使用 CodeDeploy 控制台或调用 [create-](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) deployment 命令来推送修订。
## 停止和失败的部署
您可以使用 CodeDeploy 控制台或[停止部署](https://docs.aws.amazon.com/cli/latest/reference/deploy/stop-deployment.html)命令来停止部署。当您尝试停止部署时，将发生下面三种情况之一：
+ 部署将停止，并且操作将返回成功状态。在这种情况下，没有更多的部署生命周期事件将在已停止部署的部署组上运行。
+ 部署将不会立即停止，并且操作将返回挂起状态。在这种情况下，一些部署生命周期事件可能仍在部署组上运行。在挂起的操作完成后，停止部署的后续调用将返回成功状态。
+ 部署无法停止，并且操作将返回错误。有关更多信息，请参阅 AWS CodeDeploy API 参考中的[错误信息和](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ErrorInformation.html)[常见错误](https://docs.aws.amazon.com/codedeploy/latest/APIReference/CommonErrors.html)。
## 重新部署和部署回滚
CodeDeploy 通过将流量从替换任务集重新路由到原始任务集来实现回滚。
您可以对部署组进行配置，使之在满足特定条件（例如部署失败或达到警报监控阈值）时自动回滚部署。您还可以在单个部署中覆盖为部署组指定的回滚设置。
另外，也可以选择通过手动重新部署以前部署的版本回滚失败的部署。
在所有情况下，新的或回滚的部署都分配有自己的部署 ID。 CodeDeploy 控制台显示列出自动部署结果的部署列表。
如果进行重新部署，则与当前部署的原始任务集关联的目标组将与重新部署的替换任务集关联。
有关更多信息，请参阅 [使用重新部署和回滚部署 CodeDeploy](deployments-rollback-and-redeploy.md)。
## 通过 Amazon ECS blue/green 部署 AWS CloudFormation
您可以使用 AWS CloudFormation 通过管理 Amazon ECS blue/green 部署 CodeDeploy。有关更多信息，请参阅 [通过创建 Amazon ECS blue/green 部署 CloudFormation](deployments-create-ecs-cfn.md)。
**注意**
亚太地区（大阪）区域 CloudFormation 不支持使用管理 Amazon ECS blue/green 部署。
# EC2/本地计算平台上的部署
本主题提供有关使用 EC2/本地计算平台的 CodeDeploy 部署的组件和工作流程的信息。有关 blue/green 部署的信息，请参阅[blue/green 部署概述](welcome.md#welcome-deployment-overview-blue-green)。
**Topics**
+ [EC2/本地计算平台上的部署组件](#deployment-steps-components-server)
+ [EC2/本地计算平台上的部署工作流程](#deployment-steps-workflow)
+ [设置实例](#deployment-steps-setting-up-instances)
+ [上传应用程序修订](#deployment-steps-uploading-your-app)
+ [创建应用程序和部署组](#deployment-steps-registering-app-deployment-groups)
+ [部署应用程序修订](#deployment-steps-deploy)
+ [更新 应用程序](#deployment-steps-updating-your-app)
+ [停止和失败的部署](#deployment-stop-fail)
+ [重新部署和部署回滚](#deployment-rollback)
## EC2/本地计算平台上的部署组件
下图显示了 EC2/本地计算平台上 CodeDeploy 部署的组件。
![\[在 EC2/本地计算平台上 CodeDeploy 部署的组件。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/deployment-components-workflow.png)
## EC2/本地计算平台上的部署工作流程
下图显示部署应用程序修订的主要步骤：
![\[部署应用程序修订的主要步骤。\]](http://docs.aws.amazon.com/zh_cn/codedeploy/latest/userguide/images/deployment-process.png)
这些步骤包括：
1. 创建应用程序并为其命名，以唯一标识要部署的应用程序修订版和应用程序的计算平台。 CodeDeploy 在部署期间使用此名称来确保它引用了正确的部署组件，例如部署组、部署配置和应用程序修订。有关更多信息，请参阅 [使用创建应用程序 CodeDeploy](applications-create.md)。
1. 指定部署类型以及要将应用程序修订部署到的实例，以此来设置部署组。就地部署将使用最新的应用程序修订更新实例。 blue/green 部署使用负载均衡器为部署组注册一组替换实例，并注销原始实例。
可以指定应用于实例的标签和/或 Amazon EC2 Auto Scaling 组名称。
如果您在部署组中指定了一组标签，则会 CodeDeploy 部署到至少应用了其中一个指定标签的实例。如果您指定两个或更多标签组，则仅 CodeDeploy 部署到符合每个标签组标准的实例。有关更多信息，请参阅 [为部署组的实例添加标签 CodeDeploy](instances-tagging.md)。
在所有情况下，都必须将实例配置为在部署中使用（也就是说，它们必须被标记或属于 Amazon EC2 Auto Scaling 组），并且必须安装并运行 CodeDeploy 代理。
我们为您提供一个 CloudFormation 模板，您可以使用该模板快速设置基于亚马逊 Linux 或 Windows 服务器的 Amazon EC2 实例。我们还为您提供独立 CodeDeploy 代理，以便您可以将其安装在亚马逊 Linux、Ubuntu 服务器、红帽企业 Linux (RHEL) 或 Windows 服务器实例上。有关更多信息，请参阅 [使用创建部署组 CodeDeploy](deployment-groups-create.md)。
您还可以指定以下选项：
+ **Amazon SNS 通知**。创建触发器，以便在部署和实例中发生指定的事件（例如，成功或失败事件）时，向 Amazon SNS 主题的订阅者发送通知。有关更多信息，请参阅 [使用 Amazon SNS 事件通知监控部署](monitoring-sns-event-notifications.md)。
+ **基于警报的部署管理**。实施 Amazon CloudWatch 警报监控，以便在您的指标超过或低于中设定的阈值时停止部署 CloudWatch。
+ **自动部署回滚**。配置部署，使之在部署失败或达到警报阈值时自动回滚到已知良好的版本。
1. 指定部署配置，以指示您的应用程序修订需要同时部署多少个实例，以及说明部署到成功和失败条件。有关更多信息，请参阅 [使用查看部署配置详细信息 CodeDeploy](deployment-configurations-view-details.md)。
1. 将应用程序修订版上传到 Amazon S3 或 GitHub。除了要部署的文件和要在部署期间运行的任何脚本外，还必须包括*应用程序规范文件*（AppSpec 文件）。该文件包含部署说明，例如，要将文件复制到的每个实例上的位置，以及运行部署脚本的时间。有关更多信息，请参阅 [正在处理的应用程序修订版 CodeDeploy](application-revisions.md)。
1. 将应用程序修订部署到部署组。部署组中每个实例上的 CodeDeploy 代理会将您的应用程序修订从 Amazon S3 复制 GitHub 到该实例。然后， CodeDeploy 代理解绑修订版，并使用该 AppSpec 文件将文件复制到指定位置并执行所有部署脚本。有关更多信息，请参阅 [使用创建部署 CodeDeploy](deployments-create.md)。
1. 检查部署结果。有关更多信息，请参阅 [监控中的部署 CodeDeploy](monitoring.md)。
1. 部署修订。如果您需要修复源内容中的错误，或以不同顺序运行部署脚本，或处理失败的部署，则可能需要重新部署。为此，请将修改后的源内容、所有部署脚本和 AppSpec 文件重新捆绑到新的修订版中，然后将修订版上传到 Amazon S3 存储桶或存储 GitHub 库。然后，使用新修订执行到同一部署组的新部署。有关更多信息，请参阅 [使用创建部署 CodeDeploy](deployments-create.md)。
## 设置实例
您必须先设置实例，然后才能首次部署应用程序修订。如果一个应用程序修订需要三个生产服务器和两个备份服务器，您将启动或使用五个实例。
要手动预配置实例，请执行以下操作：
1. 在实例上安装 CodeDeploy 代理。该 CodeDeploy 代理可以安装在亚马逊 Linux、Ubuntu Server、RHEL 和 Windows 服务器实例上。
1. 如果您使用标签来识别部署组中的实例，请启用标记。 CodeDeploy 依靠标签来识别实例并将其分组到 CodeDeploy 部署组中。尽管入门教程同时使用了键和值，但是您可以只使用键或值为部署组定义标签。
1. 启动附加有 IAM 实例配置文件的 Amazon EC2 实例。IAM 实例配置文件必须在 Amazon EC2 实例启动时附加到该实例， CodeDeploy 代理才能验证该实例的身份。
1. 创建服务角色。提供服务访问权限，以便 CodeDeploy 可以扩展您 AWS 账户中的标签。
对于初始部署， CloudFormation 模板会为您完成所有这些操作。它基于已安装 CodeDeploy 代理的亚马逊 Linux 或 Windows 服务器创建和配置新的单个 Amazon EC2 实例。有关更多信息，请参阅 [使用以下实例 CodeDeploy](instances.md)。
**注意**
对于 blue/green 部署，您可以选择使用已有的替换环境实例，也可以让您在部署过程中 CodeDeploy 配置新实例。
## 上传应用程序修订
将 AppSpec 文件放在应用程序源内容文件夹结构中的根文件夹下。有关更多信息，请参阅 [CodeDeploy 应用程序规范 (AppSpec) 文件](application-specification-files.md)。
将应用程序源内容文件夹结构捆绑成存档文件格式，例如 zip、tar 或压缩的 tar。将存档文件（*修订版*）上传到 Amazon S3 存储桶或 GitHub 存储库。
**注意**
Windows Server 实例不支持 tar 和压缩的 tar 存档文件格式（.tar 和.tar.gz）。
## 创建应用程序和部署组
CodeDeploy 部署组根据实例的标签、Amazon EC2 Auto Scaling 组名称或两者来识别一组实例。可以向同一实例部署多个应用程序修订。可以向多个实例部署一个应用程序修订。
例如，可以为三个生产服务器添加标签“Prod”，为两个备份服务器添加标签“Backup”。这两个标签可用于在 CodeDeploy 应用程序中创建两个不同的部署组，从而允许您选择哪组（或两者）应参与部署。
您可以在部署组中使用多个标签组，将部署限制到一组较少的实例。有关信息，请参阅[为部署组的实例添加标签 CodeDeploy](instances-tagging.md)。
## 部署应用程序修订
现在，您可以从 Amazon S3 或 GitHub 部署组部署您的应用程序修订了。您可以使用 CodeDeploy 控制台或[创建部署命令](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html)。可以指定一些参数（包括修订、部署组和部署配置）来控制部署。
## 更新 应用程序
您可以对应用程序进行更新，然后使用 CodeDeploy 控制台或调用 [create-](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) deployment 命令来推送修订。
## 停止和失败的部署
您可以使用 CodeDeploy 控制台或[停止部署](https://docs.aws.amazon.com/cli/latest/reference/deploy/stop-deployment.html)命令来停止部署。当您尝试停止部署时，将发生下面三种情况之一：
+ 部署将停止，并且操作将返回成功状态。在这种情况下，没有更多的部署生命周期事件将在已停止部署的部署组上运行。一些文件可能已复制到部署组中的一个或多个实例，并且一些脚本可能已在一个或多个实例上运行。
+ 部署将不会立即停止，并且操作将返回挂起状态。在这种情况下，一些部署生命周期事件可能仍在部署组上运行。一些文件可能已复制到部署组中的一个或多个实例，并且一些脚本可能已在一个或多个实例上运行。在挂起的操作完成后，停止部署的后续调用将返回成功状态。
+ 部署无法停止，并且操作将返回错误。有关更多信息 [ErrorInformation](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ErrorInformation.html)，请参阅 AWS CodeDeploy API 参考中的[常见错误](https://docs.aws.amazon.com/codedeploy/latest/APIReference/CommonErrors.html)。
与停止的部署一样，失败的部署可能导致一些部署生命周期事件已在部署组中的一个或多个实例上运行。要找出部署失败的原因，您可以使用 CodeDeploy 控制台、调用[get-deployment-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment-instance.html)命令或分析失败部署的日志文件数据。有关更多信息，请参阅[应用程序修订和日志文件清理](codedeploy-agent.md#codedeploy-agent-revisions-logs-cleanup)和[查看 CodeDeploy EC2/本地部署的日志数据](deployments-view-logs.md)。
## 重新部署和部署回滚
CodeDeploy 通过将先前部署的修订版作为新部署重新部署来实现回滚。
您可以对部署组进行配置，使之在满足特定条件（例如部署失败或达到警报监控阈值）时自动回滚部署。您还可以在单个部署中覆盖为部署组指定的回滚设置。
另外，也可以选择通过手动重新部署以前部署的版本回滚失败的部署。
在所有情况下，新的或回滚的部署都分配有自己的部署 ID。您可以在 CodeDeploy 控制台中查看的部署列表显示了哪些部署是自动部署的结果。
有关更多信息，请参阅 [使用重新部署和回滚部署 CodeDeploy](deployments-rollback-and-redeploy.md)。