AWS CodeDeploy
User Guide (API 版本 2014-10-06)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

AWS CodeDeploy 部署

本主题提供 AWS CodeDeploy 中部署的组件和工作流的相关信息。部署过程因您用于部署的 计算平台 (EC2/本地或 Lambda) 而异。

AWS Lambda 计算平台 上的部署

本主题提供了有关使用 AWS Lambda 计算平台 的 AWS CodeDeploy 部署的组件和工作流程的信息。

AWS Lambda 计算平台上的部署组件

下图显示了 AWS Lambda 计算平台 上的 AWS CodeDeploy 部署中的组件。

AWS Lambda 计算平台上的部署工作流程

下图显示了部署新增和更新 AWS Lambda 函数的主要步骤。

这些步骤包括:

  1. 通过指定一个唯一表示要部署的应用程序修订的名称,创建应用程序。要部署 Lambda 函数,您需要在创建应用程序时指定 AWS Lambda 计算平台。AWS CodeDeploy 在部署期间使用此名称以确保它引用正确的部署组件,例如,部署组、部署配置和应用程序修订。有关更多信息,请参阅 使用 AWS CodeDeploy 创建应用程序

  2. 通过指定部署组的名称设置部署组。

  3. 选择部署配置以指定如何将流量从原始 AWS Lambda 函数版本转移到新的 Lambda 函数版本。有关更多信息,请参阅 View Deployment Configuration Details

  4. application specification file (AppSpec file) 上传到 Amazon S3。 AppSpec file 指定 Lambda 函数版本和用于验证部署的 Lambda 函数。如果您不想创建 AppSpec file,则可以使用 JSON 或 YAML 直接在控制台中指定 Lambda 函数版本和 Lambda 部署验证函数。有关更多信息,请参阅 使用 AWS CodeDeploy 的应用程序修订

  5. 将应用程序修订部署到部署组。AWS CodeDeploy 部署您指定的 Lambda 函数修订。流量使用您在创建应用程序时选择的部署 AppSpec 文件转移到您的 Lambda 函数修订。有关更多信息,请参阅 使用 AWS CodeDeploy 创建部署

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

  7. 重新部署修订。如果需要在部署中修复 Lambda 函数中的错误或解决部署失败的问题,您可能希望这样做。如果您重新部署相同 Lambda 函数版本,则仅需将新部署执行到具有相同 AppSpec file 的部署组。如果您在重新部署之前重命名、添加或删除一个 Lambda 函数,则必须更新您的 AppSpec file。有关更多信息,请参阅 使用 AWS CodeDeploy 创建部署

上传应用程序修订

将 AppSpec file 放入 Amazon S3 中或将其直接输入到控制台或 AWS CLI 中。有关更多信息,请参阅 Application Specification Files

创建应用程序和部署组

AWS Lambda 计算平台 上的 AWS CodeDeploy 部署组标识一个或多个 AppSpec file。每个 AppSpec file 可以部署一个 Lambda 函数版本。部署组还定义一些用于未来部署的配置选项,例如警报和回滚配置。

部署应用程序修订

现在您已做好准备,可将 AppSpec file 中指定的函数修订部署到部署组。可以使用 AWS CodeDeploy 控制台或 create-deployment 命令。可以指定一些参数(包括修订、部署组和部署配置)来控制部署。

更新应用程序

您可以更新应用程序,然后使用 AWS CodeDeploy 控制台或调用 create-deployment 命令推送修订。

停止和失败的部署

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

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

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

  • 部署无法停止,并且操作将返回错误。有关更多信息,请参阅 AWS CodeDeploy API Reference中的错误信息常见错误

与停止的部署一样,失败的部署可能导致某些部署生命周期事件已在运行。要查明部署失败的原因,可以使用 AWS CodeDeploy 控制台或分析失败部署中的日志文件数据。有关更多信息,请参阅 应用程序修订和日志文件清理查看 AWS CodeDeploy 部署日志数据

重新部署和部署回滚

AWS CodeDeploy 实现回滚的方式是将以前部署的版本重新部署为新的部署。

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

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

在所有情况下,新的或回滚的部署都分配有自己的部署 ID。您可以在 AWS CodeDeploy 控制台中查看的部署列表显示哪些部署是自动部署的结果。

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

EC2/本地 计算平台 上的部署

本主题提供了有关使用 EC2/本地 计算平台 的 AWS CodeDeploy 部署的组件和工作流程的信息。有关蓝/绿部署的信息,请参阅蓝/绿部署概述

EC2/本地计算平台上的部署组件

下图显示了 EC2/本地计算平台上的 AWS CodeDeploy 部署中的组件。

EC2/本地计算平台上的部署工作流程

下图显示部署应用程序修订的主要步骤:

这些步骤包括:

  1. 通过指定唯一地表示要部署的应用程序修订的名称以及应用程序的计算平台,来创建应用程序。AWS CodeDeploy 在部署期间使用此名称以确保它引用正确的部署组件,例如,部署组、部署配置和应用程序修订。有关更多信息,请参阅 使用 AWS CodeDeploy 创建应用程序

  2. 设置部署组时,要指定部署类型和要部署应用程序修订的实例。就地部署将使用最新的应用程序修订更新实例。蓝/绿部署向负载均衡器注册部署组的一组替换实例并取消注册原始实例。

    可以指定应用于实例的标签和/或 Auto Scaling 组名称。

    如果在部署组中指定一组标签,AWS CodeDeploy 将部署到至少应用了一个指定标签的实例。如果您指定两个或多个标签组,AWS CodeDeploy 将只部署到满足每个标签组条件的实例。有关更多信息,请参阅 Tagging Instances for AWS CodeDeploy Deployments

    在所有情况下,实例必须配置为在部署中使用 (即,它们必须已标记或属于 Auto Scaling 组),并且已安装并运行 AWS CodeDeploy 代理。

    我们提供一个 AWS CloudFormation 模板,您可使用该模板基于 Amazon Linux 或 Windows Server 快速设置 Amazon EC2 实例。我们还提供独立的 AWS CodeDeploy 代理,以便您可以将其安装在 Amazon Linux、Ubuntu Server、Red Hat Enterprise Linux (RHEL) 或 Windows Server 实例上。有关更多信息,请参阅 使用 AWS CodeDeploy 创建部署组

    您还可以指定以下选项:

    • Amazon SNS 通知 — 创建触发器,以便在部署和实例中发生指定的事件(例如,成功或失败事件)时,向 Amazon SNS 主题的订阅者发送通知。有关更多信息,请参阅 Monitoring Deployments with Amazon SNS Event Notifications

    • 基于警报的部署管理 — 实现 Amazon CloudWatch 警报监控,以在指标超出或低于 CloudWatch 中设置的阈值时停止部署。

    • 自动部署回滚 — 配置部署,使之在部署失败或达到警报阈值时自动回滚到已知良好的版本。

  3. 指定部署配置,以指明多少实例要同时部署应用程序修订并描述部署的成功和失败条件。有关更多信息,请参阅 View Deployment Configuration Details

  4. 将应用程序修订上传到 Amazon S3 或 GitHub。除了要部署的文件和要在部署期间运行的所有脚本外,您还必须包括application specification file(AppSpec file)。该文件包含部署说明,例如,要将文件复制到的每个实例上的位置,以及运行部署脚本的时间。有关更多信息,请参阅 使用 AWS CodeDeploy 的应用程序修订

  5. 将应用程序修订部署到部署组。部署组中每个实例的 AWS CodeDeploy 代理将您的应用程序修订从 Amazon S3 或 GitHub 复制到该实例。然后,AWS CodeDeploy 代理将取消捆绑修订,使用 AppSpec file将相应文件复制到指定的位置并执行任何部署脚本。有关更多信息,请参阅 使用 AWS CodeDeploy 创建部署

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

  7. 重新部署修订。如果您需要修复源内容中的错误,或以不同顺序运行部署脚本,或处理失败的部署,则可能需要重新部署。为此,可将修订后的源内容、所有部署脚本和 AppSpec file重新捆绑成一个新修订,然后将该修订上传到 Amazon S3 存储桶或 GitHub 存储库。然后,使用新修订执行到同一部署组的新部署。有关更多信息,请参阅 使用 AWS CodeDeploy 创建部署

设置实例

您需要先设置实例,然后才能首次部署应用程序修订。如果一个应用程序修订需要三个生产服务器和两个备份服务器,您将启动或使用五个实例。

要手动预配实例,请执行以下操作:

  1. 在实例上安装 AWS CodeDeploy 代理。AWS CodeDeploy 代理可安装在 Amazon Linux、Ubuntu Server、RHEL 和 Windows Server 实例上。

  2. 如果要使用标签来标识部署组中的实例,请启用标记。AWS CodeDeploy 依赖标签来标识实例并将其分组到 AWS CodeDeploy 部署组。尽管入门教程同时使用了键和值,但是您可以只使用键或值为部署组定义标签。

  3. 启动附加有 IAM 实例配置文件的 Amazon EC2 实例。IAM 实例配置文件必须附加到启动的 Amazon EC2 实例,以便 AWS CodeDeploy 代理验证该实例的身份。

  4. 创建服务角色。提供服务访问权,以便 AWS CodeDeploy 可以展开您的 AWS 账户中的标签。

对于初始部署,AWS CloudFormation 模板将为您完成所有这些操作。它基于已安装 AWS CodeDeploy 代理的 Amazon Linux 或 Windows Server 创建并配置单个新 Amazon EC2 实例。有关更多信息,请参阅 使用适用于 AWS CodeDeploy 的实例

注意

对于蓝/绿部署,您可以选择使用您已有的用于替换环境的实例,或者也可以选择让 AWS CodeDeploy 在部署过程中为您预置新实例。

上传应用程序修订

将 AppSpec file放在应用程序源内容文件夹结构中的根文件夹下。有关更多信息,请参阅 Application Specification Files

将应用程序源内容文件夹结构捆绑成存档文件格式,例如 zip、tar 或压缩的 tar。将该存档文件(修订)上传到 Amazon S3 存储桶或 GitHub 存储库。

注意

The tar and compressed tar archive file formats (.tar and .tar.gz) are not supported for Windows Server instances.

创建应用程序和部署组

AWS CodeDeploy 部署组基于实例的标签和/或 Auto Scaling 组名称标识实例集合。多个应用程序修订可部署到同一个实例。一个应用程序修订可部署到多个实例。

例如,可以为三个生产服务器添加标签“Prod”,为两个备份服务器添加标签“Backup”。这两个标签可用于在 AWS CodeDeploy 应用程序中创建两种不同的部署组,从而使您能够选择应参与部署的一组或两组服务器。

您可以在部署组中使用多个标签组,将部署限制到一组较少的实例。有关信息,请参阅 Tagging Instances for AWS CodeDeploy Deployments

部署应用程序修订

现在,您可以开始将您的应用程序修订从 Amazon S3 或 GitHub 部署到部署组。可以使用 AWS CodeDeploy 控制台或 create-deployment 命令。可以指定一些参数(包括修订、部署组和部署配置)来控制部署。

更新应用程序

您可以更新应用程序,然后使用 AWS CodeDeploy 控制台或调用 create-deployment 命令推送修订。

停止和失败的部署

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

  • 部署将停止,并且操作将返回成功状态。在这种情况下,没有更多的部署生命周期事件将在已停止部署的部署组上运行。一些文件可能已复制到部署组中的一个或多个实例,并且一些脚本可能已在一个或多个实例上运行。

  • 部署将不会立即停止,并且操作将返回挂起状态。在这种情况下,一些部署生命周期事件可能仍在部署组上运行。一些文件可能已复制到部署组中的一个或多个实例,并且一些脚本可能已在一个或多个实例上运行。在挂起的操作完成后,停止部署的后续调用将返回成功状态。

  • 部署无法停止,并且操作将返回错误。有关更多信息,请参阅 AWS CodeDeploy API Reference中的错误信息常见错误

与停止的部署一样,失败的部署可能导致一些部署生命周期事件已在部署组中的一个或多个实例上运行。要找出部署失败的原因,您可以使用 AWS CodeDeploy 控制台调用 get-deployment-instance 命令或分析失败部署的日志文件数据。有关更多信息,请参阅 应用程序修订和日志文件清理查看 AWS CodeDeploy 部署日志数据

重新部署和部署回滚

AWS CodeDeploy 实现回滚的方式是将以前部署的版本重新部署为新的部署。

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

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

在所有情况下,新的或回滚的部署都分配有自己的部署 ID。您可以在 AWS CodeDeploy 控制台中查看的部署列表显示哪些部署是自动部署的结果。

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