AWS CodeDeploy
User Guide (API Version 2014-10-06)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

文档历史记录

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

  • API 版本:2014-10-06

  • 文档最新更新时间:2017 年 3 月 29 日

更改 说明 更改日期
对主题进行了更新

AWS CodeDeploy 现在在 中国(北京)区域 (cn-north-1) 中可用。针对这个新的可用区域更新了若干主题。

要在 中国(北京)区域 中使用服务,您必须拥有特定于 中国(北京)区域 的账户和凭证。其他 AWS 区域的账户和凭证不适用于 中国(北京)区域。同样,中国(北京)区域 的账户和凭证也不适用于其他 AWS 区域。有关该区域的信息,请参阅 http://www.amazonaws.cn/en/

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

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

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

2017 年 1 月 25 日
新增和更新的主题 新增主题使用 register-on-premises-instance 命令 (IAM 会话 ARN) 注册本地实例 ,介绍了如何使用通过 AWS Security Token Service 生成的定期刷新的临时凭证对本地实例进行身份验证和注册。相比对每个实例仅使用一个静态 IAM 用户的凭证,此方法能够为大量本地实例提供更好的支持。使用本地实例的内容也已更新,以反映这一新的支持功能。 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 中使用 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 中提供的 Classic Load Balancer 和 Application Load Balancer。 2016 年 8 月 11 日
主题更新 AWS CodeDeploy 现在可在亚太地区(孟买)区域 (ap-south-1) 中使用。有多个主题进行了更新,包括介绍如何设置 AWS CodeDeploy 代理的主题,来说明这一新的可用区域。 2016 年 6 月 27 日
主题更新

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

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

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

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 数据。有关更多信息,请参阅 使用 Amazon SNS 事件通知监控部署

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

故障排除中的如果实例在部署期间终止,在最多 1 小时内部署不会失败。部分已更新。

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

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

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

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

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

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

添加 AppSpec 文件已按照分步说明的方式重新整理。

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: 选项。

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

故障排除主题更新了有关确保实例的时间设置准确无误的信息。

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

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

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

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

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 部署标识符。有关更多信息,请参阅AppSpec 文件参考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 日
主题更新

更新了故障排除

2015 年 4 月 2 日
主题更新

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

故障排除中增加了两个部分:

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

2015 年 2 月 12 日
主题更新

故障排除Auto Scaling 组中的 Amazon EC2 实例无法启动,收到错误“Heartbeat Timeout”中增加了新的部分。

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

2015 年 1 月 28 日
主题更新

故障排除中增加了以下部分:

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

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

2015 年 1 月 20 日
新主题

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

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

第一个公开发行版

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

2014 年 11 月 12 日