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

文档历史记录

下表描述了对此用户指南进行的重大更改,以阐明自上次发布 AWS CodeDeploy 用户指南以来的新增及增强功能。

  • API 版本:2014-10-06

  • 最近文档更新时间:2018 年 8 月 7 日

更改 描述 日期

AWS CodeDeploy 代理最新的最低支持版本

当前所支持的 AWS CodeDeploy 代理的最低版本为 。有关更多信息,请参阅 AWS CodeDeploy 代理的版本历史纪录

August 7, 2018

早期更新

下表描述了 2018 年 6 月之前的每个 AWS CodeDeploy 用户指南版本中的重要更改。

更改 描述 更改日期
主题更新 AWS CodeDeploy 现在可在 (eu-west-3) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2017 年 12 月 19 日
对主题进行了更新

AWS CodeDeploy 目前在中国 (宁夏) 区域中可用。

要在 中国(北京)区域 或 中国 (宁夏) 区域 中使用服务,您必须拥有这些区域的账户和凭据。其他 AWS 区域的账户和凭证不适用于 北京和宁夏区域,反之亦然。

有关 中国区域 的一些资源的信息 (例如 AWS CodeDeploy 资源工具包存储桶名称和 AWS CodeDeploy 代理安装过程) 不包含在此版本的 AWS CodeDeploy 用户指南 中。

有关更多信息:

2017 年 12 月 11 日
对主题进行了更新 AWS CodeDeploy 现已支持部署 Lambda 函数。AWS Lambda 部署可将传入流量从现有 Lambda 函数转移到更新的 Lambda 函数版本。您选择或创建部署配置,用于指定部署中的流量转移间隔数以及每个间隔转移的流量百分比。AWS 无服务器应用程序模型 (AWS SAM) 支持 AWS Lambda 部署,以便您可以使用 AWS SAM 部署首选项来管理 AWS Lambda 部署期间流量转移的方式。为反映这一变动,新增和更新了若干个主题,其中包括AWS CodeDeploy 计算平台概览AWS Lambda 计算平台 上的部署创建 AWS Lambda 计算平台 部署 (控制台) 为 AWS Lambda 函数部署创建应用程序 (控制台)为 AWS Lambda 部署添加 AppSpec 文件

2017 年 11 月 28 日

新主题

AWS CodeDeploy 现已支持直接部署到本地计算机或安装了 AWS CodeDeploy 代理的实例。您可以在本地测试部署,如果有错误,请使用 AWS CodeDeploy 代理错误日志来进行调试。您还可以使用本地部署测试应用程序修订的完整性,测试 AppSpec file 的内容以及更多内容。有关更多信息,请参阅 使用 AWS CodeDeploy 代理验证本地机器上的部署程序包

2017 年 11 月 16 日

对主题进行了更新

AWS CodeDeploy 对部署组中 Elastic Load Balancing 负载均衡器的支持已扩展,以便蓝/绿部署和就地部署均包括 Network Load Balancer。现在,可以为您的部署组选择 应用程序负载均衡器、传统负载均衡器 或 Network Load Balancer。负载均衡器在蓝/绿部署中为必备项,在就地部署中为可选项。为反映此支持,大量主题已更新,包括 Integrating AWS CodeDeploy with Elastic Load Balancing为就地部署创建应用程序 (控制台)部署先决条件Integrating AWS CodeDeploy with Elastic Load Balancing为就地部署创建应用程序 (控制台)

2017 年 9 月 12 日

对主题进行了更新

AWS CodeDeploy 对部署组中 Elastic Load Balancing 负载均衡器的支持已扩展到蓝/绿部署和就地部署均包括 Application Load Balancer。现在,可以为您的部署组选择 应用程序负载均衡器 或 传统负载均衡器。负载均衡器在蓝/绿部署中为必备项,在就地部署中为可选项。Integrating AWS CodeDeploy with Elastic Load Balancing使用 AWS CodeDeploy 创建应用程序使用 AWS CodeDeploy 创建部署组 等主题已更新,以反映这一新增支持。

2017 年 8 月 10 日

新增和更新的主题 AWS CodeDeploy 现已支持使用多个标签组来标记部署组中所包含实例的组合与交叉。如果使用唯一标签组,该组中至少一个标签标记的实例即会包括在部署组中。如果使用多个标签组,只有由每个标签组中至少一个标签标记的实例才会包括在内。有关在部署组中添加实例的新方法,请参阅Tagging Instances for AWS CodeDeploy Deployments。经过更新以反映此项支持的其他主题包括 为就地部署创建应用程序 (控制台)为蓝/绿部署创建应用程序 (控制台)为就地部署创建部署组 (控制台)为蓝/绿部署创建部署组 (控制台)Deployments,和 教程:使用 AWS CodeDeploy 从 GitHub 部署应用程序 中的 步骤 5:创建应用程序和部署组 2017 年 31 月 7 日
对主题进行了更新 用于在 Windows Server 实例上安装 AWS CodeDeploy 代理的另外两个方法已添加到安装或重新安装适用于 Windows Server 的 AWS CodeDeploy 代理中。除了 Windows PowerShell 命令之外,还提供了使用直接 HTTPS 链接和使用 Amazon S3 复制命令下载安装文件的说明。在将文件下载或复制到实例后,可手动运行安装。 2017 年 12 月 7 日
对主题进行了更新

AWS CodeDeploy 改进了管理与 GitHub 账户和存储库的连接的方法。现在,您可以创建和存储最多 25 个与 GitHub 账户的连接以便将 AWS CodeDeploy 应用程序与 GitHub 存储库关联。每个连接均可支持多个存储库。您可以创建与最多 25 个不同的 GitHub 账户的连接,或创建与单个账户的多个连接。在将应用程序连接到 GitHub 账户后,AWS CodeDeploy 管理所需的访问权限,而无需您执行任何进一步的操作。已对指定有关存储在 GitHub 存储库中修订的信息将 AWS CodeDeploy 与 GitHub 集成教程:使用 AWS CodeDeploy 从 GitHub 部署应用程序进行更新以反映此支持。

2017 年 5 月 30 日
对主题进行了更新

过去,如果 AWS CodeDeploy 代理在目标位置检测到的文件不是来自最新的成功部署的应用程序修订的一部分,则默认情况下,将无法进行当前部署。AWS CodeDeploy 现在提供了针对代理处理这些文件的方式的选项:使部署失败,保留内容或覆盖内容。使用 AWS CodeDeploy 创建部署已更新以反映此支持,并且新的回滚行为与现有内容部分已添加到使用 AWS CodeDeploy 重新部署和回滚部署

2017 年 5 月 16 日
对主题进行了更新

现在可以使用 AWS CodeDeploy 控制台或 AWS CLI 将 Elastic Load Balancing 中的 传统负载均衡器 分配给部署组。在就地部署期间,负载均衡器阻止将 Internet 流量路由到正在部署到的实例,然后在该实例上的部署完成时使实例可供流量使用。已更新多个主题来反映此新的支持,包括与其他 AWS 服务集成Integrating AWS CodeDeploy with Elastic Load Balancing为就地部署创建应用程序 (控制台)为就地部署创建部署组 (控制台)AppSpec 的“hooks”部分。已向故障排除指南添加一个新的部分:对失败的 ApplicationStop、BeforeBlockTraffic 和 AfterBlockTraffic 部署生命周期事件进行故障排除

2017 年 4 月 27 日
对主题进行了更新

现在可以使用 AWS CodeDeploy 控制台或 AWS CLI 将 Elastic Load Balancing 中的 传统负载均衡器 分配给部署组。在就地部署期间,负载均衡器阻止将 Internet 流量路由到正在部署到的实例,然后在该实例上的部署完成时使实例可供流量使用。已更新多个主题来反映此新的支持,包括与其他 AWS 服务集成Integrating AWS CodeDeploy with Elastic Load Balancing为就地部署创建应用程序 (控制台)为就地部署创建部署组 (控制台)AppSpec 的“hooks”部分。已向故障排除指南添加一个新的部分:对失败的 ApplicationStop、BeforeBlockTraffic 和 AfterBlockTraffic 部署生命周期事件进行故障排除

2017 年 5 月 1 日
对主题进行了更新

AWS CodeDeploy 目前在中国(北京)区域中可用。

要在 中国(北京)区域 或 中国 (宁夏) 区域 中使用服务,您必须拥有这些区域的账户和凭据。其他 AWS 区域的账户和凭证不适用于 北京和宁夏区域,反之亦然。

有关 中国区域 的一些资源的信息 (例如 AWS CodeDeploy 资源工具包存储桶名称和 AWS CodeDeploy 代理安装过程) 不包含在此版本的 AWS CodeDeploy 用户指南 中。

有关更多信息:

2017 年 3 月 29 日
新增和更新的主题

推出了若干新主题以反映对蓝/绿部署的新增 AWS CodeDeploy 支持。蓝/绿部署是一种部署方法,在此方法中,部署组 (原始环境) 中的实例将由一组不同的实例 (替换环境) 替代。蓝/绿部署概述 提供了对 AWS CodeDeploy 使用的蓝/绿方法的概要说明。在 AWS CodeDeploy 中尝试使用示例蓝/绿部署 提供了对蓝/绿部署使用新的 Sample deployment wizard 的指南。其他新主题包括 为蓝/绿部署创建应用程序 (控制台)为蓝/绿部署创建部署组 (控制台), 和 在 Elastic Load Balancing 中为 AWS CodeDeploy 部署设置 Load Balancer.

还更新了许多主题,其中包括 使用 AWS CodeDeploy 创建部署在 AWS CodeDeploy 中使用部署配置使用 AWS CodeDeploy 创建应用程序在 AWS CodeDeploy 中使用部署组在 AWS CodeDeploy 中使用部署AppSpec 的“hooks”部分

2017 年 1 月 25 日
新增和更新的主题 新增主题使用 register-on-premises-instance 命令 (IAM 会话 ARN) 注册本地实例 ,介绍了如何使用通过 AWS Security Token Service 生成的定期刷新的临时凭证对本地实例进行身份验证和注册。相比对每个实例仅使用一个静态 IAM 用户的凭证,此方法能够为大量本地实例提供更好的支持。Working with On-Premises Instances的内容也已更新,以反映这一新的支持功能。 2016 年 12 月 28 日
对主题进行了更新 AWS CodeDeploy 现在可在 欧洲 (伦敦) 区域 (eu-west-2) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2016 年 12 月 13 日
对主题进行了更新 AWS CodeDeploy 现在可在 加拿大 (中部) 区域 (ca-central-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2016 年 12 月 8 日
对主题进行了更新 AWS CodeDeploy 现在可在 美国东部(俄亥俄)区域 (us-east-2) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2016 年 10 月 17 日
新主题 新的章节 AWS CodeDeploy 的身份验证和访问控制提供了有关使用 AWS Identity and Access Management (IAM) 和 AWS CodeDeploy 通过使用凭据帮助保护对您的资源的访问的全面地信息。这些凭据提供访问 AWS 资源所需的权限,如从 Amazon S3 存储桶检索应用程序修订和读取 Amazon EC2 实例上的标签。 2016 年 10 月 11 日
对主题进行了更新

更新 Windows Server 上的 AWS CodeDeploy 代理 进行了更新,以说明 Windows Server 的新 AWS CodeDeploy 代理更新程序的可用性。在 Windows Server 实例上安装后,更新程序将定期检查新版本。当检测到新版本时,更新程序将在安装最新版本之前,卸载当前版本的代理(如果已安装)。

2016 年 10 月 4 日
对主题进行了更新

AWS CodeDeploy 现已与 Amazon CloudWatch 警报集成,使您能够在指定警报状态在多个持续时间段发生更改时停止部署,如警报阈值所指定。

AWS CodeDeploy 现在还支持在满足特定条件(例如,部署失败或激活警报)时自动回滚部署。

已更新了大量主题来反映这些更改,包括使用 AWS CodeDeploy 创建应用程序使用 AWS CodeDeploy 创建部署组使用 AWS CodeDeploy 更改部署组设置Deployments使用 AWS CodeDeploy 重新部署和回滚部署AWS CodeDeploy 产品和服务集成,此外新增了主题在 AWS CodeDeploy 中使用 CloudWatch 警报监控部署

2016 年 9 月 15 日
新增和更新的主题

AWS CodeDeploy 现在提供与 Amazon CloudWatch Events 的集成。现在,当检测到 AWS CodeDeploy 部署组下的部署状态或实例状态发生更改时,您可以使用 CloudWatch Events 启动一个或多个操作。您可以在操作中调用 AWS Lambda 函数,向 Kinesis 流或 Amazon SNS 主题发布内容,向 Amazon SQS 队列推送消息,或者反过来触发 CloudWatch 警报操作。有关更多信息,请参阅 使用 Amazon CloudWatch Events 监控部署

2016 年 9 月 9 日
主题更新 更新了Integrating AWS CodeDeploy with Elastic Load Balancing与其他 AWS 服务集成主题,以反映另增的一个负载均衡选项。AWS CodeDeploy 现在支持 Elastic Load Balancing 中可用的 传统负载均衡器 和 应用程序负载均衡器。 2016 年 8 月 11 日
主题更新 AWS CodeDeploy 现在可在亚太地区(孟买)区域 (ap-south-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2016 年 6 月 27 日
主题更新

AWS CodeDeploy 现在可在 亚太区域(首尔) (ap-northeast-2) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。

已重新组织内容表,来包含针对实例、部署配置、应用程序、部署组、修订和部署的各个部分。已为 AWS CodeDeploy 教程添加新的部分。为了提高可用性,已将几个较长的主题(包括 AWS CodeDeploy AppSpec File参考AWS CodeDeploy 问题排查)划分为多个较短的主题。AWS CodeDeploy 代理的配置信息已移至新主题AWS CodeDeploy 代理配置参考

2016 年 6 月 15 日
新增和更新的主题

AWS CodeDeploy 的错误代码提供了 AWS CodeDeploy 部署失败时可能显示的一些错误消息的相关信息。

AWS CodeDeploy 问题排查中的下列部分已更新,现在能够更好地帮助解决部署问题:
2016 年 4 月 20 日
主题更新

AWS CodeDeploy 现在可在 南美洲(圣保罗)区域 (sa-east-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。

使用 AWS CodeDeploy 代理进行了更新,用于说明新的 :max_revisions: 配置选项,您可以使用此选项来指定希望 AWS CodeDeploy 代理对一个部署组进行归档的应用程序修订数。

2016 年 3 月 10 日
新增和更新的主题

AWS CodeDeploy 现在支持将触发器添加到部署组中,以接收与该部署组中的部署或实例相关的事件的通知。对于您加入到该触发器操作中的 Amazon Simple Notification Service 主题,通知将发送到已订阅该主题的接收人。您也可以使用当触发器在您自己的自定义通知工作流中触发时创建的 JSON 数据。有关更多信息,请参阅 Monitoring Deployments with Amazon SNS Event Notifications

对过程进行了更新,来说明重新设计的应用程序详细信息页面。

AWS CodeDeploy 问题排查中的如果实例在部署期间终止,在最多 1 小时内部署不会失败。部分已更新。

AWS CodeDeploy 限制进行了更新,来说明可与单个应用程序关联的部署组数量的修订后限制、正常运行的最少实例数设置所允许的值、以及 AWS SDK for Ruby (aws-sdk-core) 要求的版本。

2016 年 2 月 17 日
新增和更新的主题

AWS CodeDeploy 现在可在 美国西部(加利福尼亚北部) 区域 (us-west-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新增的区域。

选择 AWS CodeDeploy 存储库类型列出并描述了 AWS CodeDeploy 目前支持的存储库类型。在引入对其他存储库的支持时,这一新主题将会进行更新。

管理 AWS CodeDeploy 代理操作 中更新了有关新 .version 文件的信息,该文件添加到实例中以报告当前 AWS CodeDeploy 代理的版本;此外还更新了有关所支持代理版本的信息。

用户指南中增加了代码示例的语法突出显示,包括 JSON 和 YAML 示例。

将应用程序规范文件添加到 AWS CodeDeploy 的修订已按照分步说明的方式重新整理。

2016 年 1 月 20 日
新主题 在其他 AWS 账户中部署应用程序描述了在不需要其他账户的完整凭证集的情况下,用于启动属于您组织中其他账户的部署时的设置要求和过程。这对于将多个账户用于不同用途的组织尤为有用,例如一个账户与开发和测试环境关联,另一个账户与生产环境关联。 2015 年 12 月 30 日
主题更新 AWS CodeDeploy 产品和服务集成主题进行了重新设计。该主题现在包括来自社区的集成示例部分,并提供与 AWS CodeDeploy 集成相关的博客文章和视频示例列表。 2015 年 12 月 16 日
主题更新 AWS CodeDeploy 现在可在 亚太区域(新加坡) (ap-southeast-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2015 年 12 月 9 日
主题更新

使用 AWS CodeDeploy 代理进行了更新,以说明 AWS CodeDeploy 代理配置文件中的新 :proxy_uri: 选项。

AWS CodeDeploy AppSpec File参考中更新了有关使用新环境变量 DEPLOYMENT_GROUP_ID 的信息;在部署生命周期事件期间,挂钩脚本可以访问该变量。
2015 年 12 月 1 日
主题更新 步骤 3:为 AWS CodeDeploy 创建服务角色进行了更新,以说明为 AWS CodeDeploy 创建服务角色的新过程并介绍其他一些改进。 2015 年 11 月 13 日
主题更新 AWS CodeDeploy 现在可在 欧洲(法兰克福)区域 (eu-central-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。

AWS CodeDeploy 问题排查主题更新了有关确保实例的时间设置准确无误的信息。

2015 年 10 月 19 日
新主题 发布了适用于 AWS CodeDeploy 的 AWS CloudFormation 模板参考,用于说明 AWS CloudFormation 对 AWS CodeDeploy 操作的新增支持。

创建了Primary Components主题,并引入了目标修订的定义。

2015 年 10 月 1 日
主题更新 使用 AWS CodeDeploy 创建部署组进行了更新,以说明使用通配符搜索为部署组查找实例的功能。

Instance Health进行了更新,以澄清正常运行的最少实例数概念。

2015 年 8 月 31 日
主题更新 AWS CodeDeploy 现在可在 亚太区域(东京) (ap-northeast-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2015 年 8 月 19 日
主题更新

AWS CodeDeploy 现在支持部署到 Red Hat Enterprise Linux (RHEL) 本地实例和 Amazon EC2 实例。有关更多信息,请参阅以下主题:

2015 年 6 月 23 日
主题更新

AWS CodeDeploy 现在提供了一组环境变量,在部署期间您的部署脚本可以使用这些变量。这些环境变量包括多种信息,例如当前 AWS CodeDeploy 应用程序、部署组和部署生命周期事件的名称,以及当前 AWS CodeDeploy 部署标识符。有关更多信息,请参阅AWS CodeDeploy AppSpec File参考AppSpec 的“hooks”部分部分的结尾。

2015 年 5 月 29 日
主题更新

AWS CodeDeploy 现在提供了 IAM 中的一组 AWS 托管策略,您可以使用这些策略而无需自行手动创建等同策略。包括:

  • 一个用于允许 IAM 用户仅将修订注册到 AWS CodeDeploy 并随后通过 AWS CodeDeploy 进行部署的策略。

  • 一个用于向 IAM 用户提供对 AWS CodeDeploy 资源的完整访问权限的策略。

  • 一个用于向 IAM 用户提供对 AWS CodeDeploy 资源的只读访问权限的策略。

  • 一个用于附加服务角色的策略,这样 AWS CodeDeploy 可以通过实例的 Amazon EC2 标签、本地实例标签或 Auto Scaling 组名来识别 Amazon EC2 实例,并相应对其部署应用程序修订。

有关更多信息,请参阅AWS CodeDeploy 的身份验证和访问控制中的客户托管策略示例部分。

2015 年 5 月 29 日
主题更新 AWS CodeDeploy 现在可在 欧洲(爱尔兰)区域 (eu-west-1) 和 亚太区域(悉尼) (ap-southeast-2) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这些新的可用区域。 2015 年 5 月 7 日
新主题

AWS CodeDeploy 现在支持部署到本地实例和 Amazon EC2 实例。增加了以下主题来描述这一新的支持:

2015 年 4 月 2 日
新主题

增加了AWS CodeDeploy 资源

2015 年 4 月 2 日
主题更新

更新了AWS CodeDeploy 问题排查

2015 年 4 月 2 日
主题更新

下列主题进行了更新,以提供创建您自己的自定义策略并将其附加到 IAM 中的用户和角色的新建议:

AWS CodeDeploy 问题排查中增加了两个部分:

AWS CodeDeploy AppSpec File参考中的AppSpec 的“hooks”部分部分进行了更新,更加准确地描述了可用的部署生命周期事件。

2015 年 2 月 12 日
主题更新

AWS CodeDeploy 问题排查Auto Scaling 组中的 Amazon EC2 实例无法启动,收到错误“Heartbeat Timeout”中增加了新的部分。

AWS CodeDeploy 产品和服务集成中增加了 CloudBees 部分。

2015 年 1 月 28 日
主题更新

AWS CodeDeploy 问题排查中增加了以下部分:

步骤 5:尝试使用 AWS CodeDeploy 示例部署向导中增加了相关信息,来澄清发出调用的 IAM 用户所需的特定权限,具体而言:

有关所需权限的信息,请参阅先决条件

2015 年 1 月 20 日
新主题

AWS CodeDeploy 产品和服务集成部分进行了更新,现在包括下列主题::

2015 年 1 月 9 日
主题更新
2015 年 1 月 8 日
新主题 增加了Monitoring Deployments with AWS CloudTrail。AWS CodeDeploy 与 AWS CloudTrail 相集成,后者是一种服务,可在 AWS 账户中捕获由 AWS CodeDeploy 自身或代表其发出的 API 调用,并将日志文件传输到您指定的 Amazon S3 存储桶。 2014 年 12 月 17 日
主题更新 更新了步骤 5:尝试使用 AWS CodeDeploy 示例部署向导中的步骤 3:配置实例部分。 2014 年 12 月 3 日

第一个公开发行版

这是 AWS CodeDeploy 用户指南的第一个公开发行版。

2014 年 11 月 12 日

本页内容: