Amazon CodeBuild 用户指南文档历史记录 - Amazon CodeBuild
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

Amazon CodeBuild 用户指南文档历史记录

下表列出了自 Amazon CodeBuild 上一次发布以来对文档所做的重要更改。如需对此文档更新的通知,您可以订阅 RSS 源。

  • 最新 API 版本:2016-10-06

  • 最近文档更新时间:2021 年 10 月 4 日

变更说明日期

Amazon ECR 示例:限制映像访问

何时 CodeBuild 凭据用于拉取 Amazon ECR 映像,您可以将图像访问限制为特定 CodeBuild 项目。有关更多信息,请参阅 。Amazon ECR 示例.

2022 年 3 月 10 日

增加了区域支持

这些区域有:ARM_CONTAINER以下其他区域中现在支持计算类型:亚太地区(首尔)、加拿大(中部)、欧洲(伦敦)和欧洲(巴黎)。有关更多信息,请参阅构建环境计算类型

2022 年 3 月 10 日

新 VPC 限制

如果你配置 CodeBuild 要使用 VPC,不支持本地缓存。从 22 年 2 月 28 日开始,您的 VPC 构建将需要更长的时间,因为每次构建都将使用新的 Amazon EC2 实例。

2022 年 2 月 25 日

Batch 报告模式

CodeBuild 现在允许您选择如何将批量构建状态发送给项目的源提供商。有关更多信息,请参阅 。Batch 报告模式.

2021 年 10 月 4 日

新计算类型

CodeBuild 现在支持小型 ARM 计算类型。有关更多信息,请参阅构建环境计算类型

2021 年 9 月 13 日

批量构建的会话调试

CodeBuild 现在支持批量构建的会话调试。有关更多信息,请参阅 。构建图构建列表.

2021 年 3 月 3 日

项目级别的并发构建限制

CodeBuild 现在允许您限制构建项目的并发构建数量。有关更多信息,请参阅 。项目配置ConcurrentBuildLimit.

2021 年 2 月 16 日

新的 buildspec 属性:s3‑prefix

CodeBuild 现在提供s3-prefix构件的 buildspec 属性,允许您为上传到 Amazon S3 的项目指定路径前缀。有关更多信息,请参阅 。s3 前缀.

2021 年 2 月9 日

新的 buildspec 属性:开启失败

CodeBuild 现在提供on-failure构建阶段的 buildspec 属性,允许您确定构建阶段失败时会发生什么。有关更多信息,请参阅 。失败时.

2021 年 2 月9 日

新的 buildspec 属性:排除路径

CodeBuild 现在提供exclude-paths构件的 buildspec 属性,允许您从构建工件中排除路径。有关更多信息,请参阅 。排除路径.

2021 年 2 月9 日

新的 buildspec 属性:启用符号链接

CodeBuild 现在提供enable-symlinks构件的 buildspec 属性,允许您在 ZIP 工件中保留符号链接。有关更多信息,请参阅 。启用符号链接.

2021 年 2 月9 日

buildspec 工件名称增强

CodeBuild 现在允许artifacts/name属性以包含路径信息。有关更多信息,请参阅 。名称.

2021 年 2 月9 日

代码覆盖率报告

CodeBuild 现在提供代码覆盖率报告。有关更多信息,请参阅 。代码覆盖率报告.

2020 年 7 月 30 日

Batch

CodeBuild 现在支持运行项目的并发和协调构建。有关更多信息,请参阅 。在 CodeBuild 中 Batch 构建.

2020 年 7 月 30 日

Windows Server 2019 映像

CodeBuild 现在提供了一个 Windows 服务器核心 2019 年构建映像。有关更多信息,请参阅 。CodeBuild 提供的 Docker 映像.

2020 年 7 月 20 日

会话管理器

CodeBuild 现在允许你暂停正在运行的构建然后使用Amazon Systems Manager会话管理器连接到构建容器并查看容器的状态。有关更多信息,请参阅 。会话管理器.

2020 年 7 月 20 日

对主题进行了更新

CodeBuild 现在支持在 buildspec 文件中指定要在构建环境中使用的 shell。有关更多信息,请参阅 。构建规范参考.

2020 年 6 月 25 日

使用测试框架测试报告

添加了介绍如何生成的几个主题。 CodeBuild 包含多个测试框架的测试报告。有关更多信息,请参阅使用测试框架测试报告

2020 年 5 月 29 日

对主题进行了更新

CodeBuild 现在支持向报告组添加标签。有关更多信息,请参阅报告组

2020 年 5 月 21 日

支持测试报告

对测试报告的 CodeBuild 支持现在已经普遍可用。

2020 年 5 月 21 日

对主题进行了更新

CodeBuild 现在支持为 Github 和 Bitbucket 创建 Webhook 筛选条件,仅当 HEAD 提交消息匹配指定表达式时才触发构建操作。有关详细信息,请参阅 GitHub 拉取请求和 Webhook 筛选条件示例 以及 Bitbucket 拉取请求和 Webhook 筛选条件示例

2020 年 5 月 6 日

新主题

CodeBuild 现在支持共享构建项目和报告组资源。有关更多信息,请参阅使用共享项目使用共享报告组

2019 年 12 月 13 日

新增和更新的主题

CodeBuild 现在支持在构建项目运行期间测试报告。有关更多信息,请参阅使用测试报告创建测试报告使用 Amazon CLI 示例创建测试报告

2019 年 11 月 25 日

对主题进行了更新

CodeBuild 现在支持 Linux GPU 和 Arm 环境类型,2xlarge计算类型。有关更多信息,请参阅构建环境计算类型

2019 年 11 月 19 日

对主题进行了更新

CodeBuild 现在支持所有构建的构建编号、导出环境变量、和Amazon Secrets Manager集成。有关更多信息,请参阅 。导出的变量Secrets Manager构建规范语法.

2019 年 11 月 6 日

新主题

CodeBuild 现在支持通知规则。您可以使用通知规则向用户通知构建项目中的重要更改。有关更多信息,请参阅创建通知规则

2019 年 11 月 5 日

对主题进行了更新

CodeBuild 现在支持安卓版本 29 和 Go 版本 1.13 运行时。有关更多信息,请参阅 。CodeBuild 提供的 Docker 映像构建规范语法.

2019 年 9 月 10 日

对主题进行了更新

在创建项目时,您现在可以选择 Amazon Linux 2 (AL2) 托管映像。有关更多信息,请参阅 。CodeBuild 提供的 Docker 映像的 CodeBuild 建规范文件示例中的运行时版本.

2019 年 8 月 16 日

对主题进行了更新

创建项目时,您现在可以选择禁用 S3 日志的加密,并且如果使用基于 Git 的源存储库,则还可以包括 Git 子模块。有关更多信息,请参阅 。在 CodeBuild 中创建项目.

2019 年 3 月 8 日

新主题

CodeBuild 现在支持本地缓存。创建构建时,可以在四种模式中的一种或多种模式中指定本地缓存。有关更多信息,请参阅 。在 CodeBuild 中构建缓存.

2019 年 2 月 21 日

新主题

CodeBuild 现在支持 Webhook 筛选条件组以指定触发构建的事件。有关更多信息,请参阅 。筛选条件 GitHub Webhook Events筛选 Bitbucket Webhook 事件.

2019 年 2 月 8 日

新主题

这些区域有: CodeBuild 现在,用户指南显示了如何使用 CodeBuild 与代理服务器结合使用。有关更多信息,请参阅 。使用 CodeBuild 与代理服务器.

2019 年 2 月 4 日

对主题进行了更新

CodeBuild 现在支持使用另一映像中的 Amazon ECR 映像。Amazonaccount. 为反映这一变动,更新了若干个主题,其中包括CodeBuild 的亚马逊 ECR 示例创建构建项目, 和创建 CodeBuild 服务角色.

2019 年 1 月 24 日

支持专用 Docker 镜像仓库

CodeBuild 现在支持使用在专用镜像仓库中存储的 Docker 镜像作为您的运行时环境。有关更多信息,请参阅 。私有注册表与Amazon Secrets Manager样本.

2019 年 1 月 24 日

对主题进行了更新

CodeBuild 现在支持使用访问令牌连接到 GitHub (使用个人访问令牌)和 Bitbucket(使用应用程序密码)存储库。有关更多信息,请参阅创建构建项目(控制台)将访问令牌与源提供商结合使用

2018 年 12 月 6 日

对主题进行了更新

CodeBuild 现在支持新的构建指标,这些指标用于衡量构建中每个阶段的持续时间。有关更多信息,请参阅 。 CodeBuild CloudWatch 指标.

2018 年 11 月 15 日

VPC 终端节点策略主题

为的 Amazon VPC 终端节点 CodeBuild 现在支持策略。有关更多信息,请参阅 。为 CodeBuild 创建 VPC 终端节点策略.

2018 年 11 月 9 日

更新的内容

更新了主题以反映新控制台体验。

2018 年 10 月 30 日

Amazon EFS 示例

CodeBuild 可以在构建期间使用项目的构建规范文件中的命令挂载 Amazon EFS 文件系统。有关更多信息,请参阅 。CodeBuild 的亚马逊 EFS 示例.

2018 年 10 月 26 日

Bitbucket Webhook

CodeBuild 在您为存储库使用 BitBucket 时, 现在支持 Webhook。有关更多信息,请参阅 。CodeBuild 的 Bitbucket 拉取请求示例.

2018 年 10 月 2 日

S3 日志

CodeBuild 现在在 S3 存储桶中支持构建日志。以前,您只能使用构建日志 CloudWatch 日志。有关更多信息,请参阅创建项目

2018 年 9 月 17 日

多输入源和多输出构件

CodeBuild 现在支持使用多个输入源和发布多个构件集的项目。有关更多信息,请参阅 。多输入源和输入构件示例CodePipeline 与 CodeBuild 和多输入源和输出构件示例.

2018 年 8 月 30 日

语义版本控制示例

这些区域有: CodeBuild 《用户指南》现在包含一个基于使用案例的示例,演示如何使用语义版本控制在构建时创建构件名称。有关更多信息,请参阅使用语义版本控制指定构建构件示例

2018 年 8 月 14 日

新的静态网站示例

这些区域有: CodeBuild 《用户指南》现在包含一个基于使用案例的示例,演示如何在 S3 存储桶中托管构建输出。此示例利用了对未加密构建构件的最新支持。有关更多信息,请参阅创建将构建输出托管在 S3 存储桶中的静态网站

2018 年 8 月 14 日

支持使用语义版本控制覆盖构件名称

现在,您可以使用语义版本控制指定一种以下格式: CodeBuild 用于为构建项目命名。这很有用,因为具有硬编码名称的构建构件将覆盖之前使用同一硬编码名称的构建构件。例如,如果每天触发一个构建多次,则现在可以为此构建的构件名称添加时间戳。每个构建构件名称是唯一的,不会覆盖之前构建的构件。

2018 年 8 月 7 日

支持未加密的构建构件

CodeBuild 现在支持包含未加密构建构件的构建。有关更多信息,请参阅 。创建构建项目 (控制台).

2018 年 7 月 26 日

Amazon Support CloudWatch 指标和警报

CodeBuild 现在提供与的集成 CloudWatch 指标和警报。您可以使用 CodeBuild 要么 CloudWatch 控制台监控项目级别和账户级别的构建。有关更多信息,请参阅监控构建

2018 年 7 月 19 日

支持报告构建的状态

CodeBuild 现在可以向您的源提供商报告构建的开始和完成状态。有关更多信息,请参阅 。在 CodeBuild 中创建项目.

2018 年 7 月 10 日

添加到的环境变量 CodeBuild 文档

构建环境中的环境变量页面使用 CODEBUILD_BUILD_ID、CODEBUILD_LOG_PATH 和 CODEBUILD_START_TIME 环境变量进行了更新。

2018 年 7 月 9 日

Supportfinally在 buildspec 文件中存储

这些区域有: CodeBuild 文档更新了有关可选的详细信息。finally将存储在 buildspec 文件中。finally 语句块命令总是在其相应的命令语句块命令之后运行。有关更多信息,请参阅构建规范语法

2018 年 6 月 20 日

CodeBuild 代理更新通知

这些区域有: CodeBuild 文档使用您通过 Amazon SNS 获得新版本 CodeBuild 代理已发布。有关更多信息,请参阅 。接收有关新的通知Amazon CodeBuild代理版本.

2018 年 15 月 6 日

早期更新

下表描述了 2018 年 6 月之前每次发布 Amazon CodeBuild 用户指南 时进行的重要更改。

更改 描述 日期
支持 Windows 构建 CodeBuild 现在支持 Microsoft Windows Server 平台的构建,包括 Windows 上 .NET Core 2.0 的预打包构建环境。有关更多信息,请参阅 适用于 CodeBuild 的微软 Windows 示例 2018 年 5 月 25 日
支持构建幂等性 当您使用 Amazon Command Line Interface (Amazon CLI) 运行 start-build 命令时,可以指定构建为幂等性的。有关更多信息,请参阅 运行构建 (Amazon CLI) 2018 年 5 月 15 日
支持覆盖多个构建项目设置 现在,在创建构建时,可以覆盖多个构建项目设置。覆盖仅针对该构建。有关更多信息,请参阅 在 Amazon CodeBuild 中运行构建 2018 年 5 月 15 日
VPC 终端节点支持 现在,您可以使用 VPC 终端节点来提高构建的安全性。有关更多信息,请参阅 使用 VPC 终端节点 2018 年 3 月 18 日
支持触发器 现在,您可以创建触发器,按固定频率安排构建。有关更多信息,请参阅 创建 Amazon CodeBuild 触发器 2018 年 3 月 28 日
FIPS 终端节点文档 现在,您可以了解如何使用Amazon Command Line Interface(Amazon CLI) 或者AmazonSDK 要告诉 CodeBuild 以使用四种联邦信息处理标准 (FIPS) 终端节点之一。有关更多信息,请参阅 指定 Amazon CodeBuild 终端节点 2018 年 3 月 28 日
Amazon CodeBuild在亚太地区(孟买)、欧洲(巴黎)和南美洲(圣保罗)提供。 Amazon CodeBuild现已在亚太地区(孟买)、欧洲(巴黎)和南美洲(圣保罗)区域推出。有关更多信息,请参阅 Amazon Web Services 一般参考 中的 Amazon CodeBuild 2018 年 3 月 28 日
GitHub Enterprise Server 支持 CodeBuild 现在可以从存储在 GitHub 。Enterprise Server 存储库。有关更多信息,请参阅 GitHub Enterprise Server 示例 2018 年 1 月 25 日
Git clone 深度支持 CodeBuild 现已支持创建一个浅克隆,其历史记录会截断至指定数量的提交。有关更多信息,请参阅 创建构建项目 2018 年 1 月 25 日
VPC 支持 支持 VPC 的构建现在能够访问 VPC 内的资源。有关更多信息,请参阅 VPC 支持 2017 年 11 月 27 日
依赖项缓存支持 CodeBuild 现在支持依赖项缓存。这允许 CodeBuild 将构建环境的某些可重用部分保存在缓存中并在各个构建中使用它。 2017 年 11 月 27 日
构建徽章支持 CodeBuild 现在支持使用构建徽章,该徽章提供一个动态生成的可嵌入映像 (徽章),用以显示项目的最新构建状态。有关更多信息,请参阅 构建徽章示例 2017 年 11 月 27 日
Amazon Config 集成 Amazon Config现在支持 CodeBuild 作为Amazon资源,这表示该服务可以跟踪您的 CodeBuild 项目。有关 的更多信息Amazon Config,请参阅Amazon Config 示例. 2017 年 10 月 20 日
在 GitHub 存储库中自动重新构建更新的源代码 如果您的源代码存储在 GitHub 您可以启用存储库Amazon CodeBuild以便在代码更改被推送到存储库时重新构建源代码。有关更多信息,请参阅 GitHub 拉取请求和 Webhook 筛选条件示例 2017 年 9 月 21 日
在 Amazon EC2 Systems Manager Parameter Store 中存储和检索敏感或大型环境变量的新方法 现在,您可以使用Amazon CodeBuild控制台或Amazon CLI检索存储在 Amazon EC2 Systems Manager Parameter Store 中的敏感或大型环境变量。现在,您还可以使用Amazon CodeBuild控制台,将这些类型的环境变量存储在 Amazon EC2 Systems Manager Parameter Store 中。以前,您只能通过将这些类型的环境变量包含在构建规范中或运行构建命令以自动化 Amazon CLI 来检索这些变量。您只能通过使用 Amazon EC2 Systems Manager Parameter Store 控制台来存储这些类型的环境变量。有关更多信息,请参阅 。创建构建项目更改构建项目的设置, 和运行构建. 2017 年 9 月 14 日
构建删除支持 您现在可以在 Amazon CodeBuild 中删除构建。有关更多信息,请参阅 删除构建 2017 年 8 月 31 日
使用构建规范检索存储在 Amazon EC2 Systems Manager Parameter Store 中的敏感或大型环境变量的更新方法 Amazon CodeBuild现在可让您更轻松地使用构建规范来检索存储在 Amazon EC2 Systems Manager Parameter Store 中的敏感或大型环境变量。以前,您只能通过运行构建命令自动化 Amazon CLI 来检索这些类型的环境变量。有关更多信息,请参阅 。parameter-store中映射构建规范语法. 2017 年 8 月 10 日
Amazon CodeBuild 支持 Bitbucket CodeBuild 现在可以从存储在 Bitbucket 存储库中的源代码进行构建。有关更多信息,请参阅 。创建构建项目运行构建. 2017 年 8 月 10 日
Amazon CodeBuild在美国西部(加利福尼亚北部)、欧洲(伦敦)和加拿大(中部)提供。 Amazon CodeBuild现已在美国西部(加利福尼亚北部)、欧洲(伦敦)和加拿大(中部)区域推出。有关更多信息,请参阅 Amazon Web Services 一般参考 中的 Amazon CodeBuild 2017 年 6 月 29 日
已支持其他构建规范文件名称和位置 现在,您可以不为构建项目指定源代码根目录处的名为 buildspec.yml 的默认构建规范文件,而是指定使用文件名称或位置与之不同的构建规范文件。有关更多信息,请参阅 构建规范文件名称和存储位置 2017 年 6 月 27 日
更新了构建通知示例 CodeBuild 现在为通过 Amazon 的构建通知提供内置支持。 CloudWatch Amazon Simple Notification Service (Amazon SNS)。先前的构建通知示例已更新为演示此新行为。 2017 年 6 月 22 日
添加了自定义映像中的 Docker 示例 展示如何使用的示例 CodeBuild 并添加了用于构建和运行 Docker 映像的自定义 Docker 构建映像。有关更多信息,请参见 自定义映像示例中的 Docker 2017 年 6 月 7 日
从中获取源代码 GitHub 拉取请求

当你运行构建时 CodeBuild 这依赖于存储在中的源代码 GitHub 存储库,现在可以指定 GitHub 要构建的拉取请求 ID。您还可以改为指定提交 ID、分支名称或标签名称。有关更多信息,请参阅 。源版本中的值运行构建(控制台)或者sourceVersion中的值运行构建 (Amazon CLI).

2017 年 6 月 6 日
更新了构建规范版本 发布了新版本的构建规范格式。0.2 版解决了 CodeBuild 在默认 Shell 的单独实例中运行每条构建命令。此外,在版本 0.2 中,environment_variables 已重命名为 env,而且 plaintext 已重命名为 variables。有关更多信息,请参阅 适用于 CodeBuild 的构建规范参考 2017 年 5 月 9 日
在 GitHub 中提供构建映像的 Dockerfile Amazon CodeBuild 提供的许多构建映像的定义在 GitHub 中作为 Dockerfile 提供。有关更多信息,请参阅中表的 “定义” 列。CodeBuild 提供的 Docker 映像. 2017 年 5 月 2 日
Amazon CodeBuild在欧洲(法兰克福)、亚太地区(新加坡)、亚太地区(悉尼)和亚太地区(东京)提供。 Amazon CodeBuild现在可在欧洲(法兰克福)、亚太地区(新加坡)、亚太地区(悉尼)和亚太地区(东京)区域推出。有关更多信息,请参阅 Amazon Web Services 一般参考 中的 Amazon CodeBuild 2017 年 3 月 21 日
CodePipeline 对 CodeBuild Peline 的测试操作支持 现在,您可以将添加到中的管道 CodePipeline 使用 CodeBuild 的测试操作。有关更多信息,请参阅 将 CodeBuild 测试操作添加到管道(CodePipeline 控制台) 2017 年 3 月 8 日
构建规范文件支持从选定的顶级目录中获取构建输出 现在,您可以借助构建规范文件来指定单独的顶级目录,并指示其中的内容 CodeBuild 将包含在内部输出构件中。为此,您可以使用 base-directory 映射。有关更多信息,请参阅 构建规范语法 2017 年 2 月 8 日
内置环境变量 Amazon CodeBuild 为您要使用的构建提供了额外的内置环境变量。这些包括描述启动了构建项目的实体的环境变量、指向源代码存储库的 URL 以及源代码的版本 ID 等。有关更多信息,请参阅 构建环境中的环境变量 2017 年 1 月 30 日
Amazon CodeBuild在美国东部(俄亥俄)提供 Amazon CodeBuild现已在美国东部(俄亥俄)区域推出。有关更多信息,请参阅 Amazon Web Services 一般参考 中的 Amazon CodeBuild 2017 年 1 月 19 日
Shell 和命令行为信息 CodeBuild 在构建环境默认 Shell 的单独实例中运行您指定的每个命令。这种默认行为可对您的命令产生一些意想不到的副作用。我们推荐了一些方法,用于在需要时处理这种默认行为。有关更多信息,请参阅 构建环境中的 Shell 和命令 2016 年 12 月 9 日
环境变量信息 CodeBuild 提供了您可以在构建命令中使用的多个环境变量。您也可以定义自己的环境变量。有关更多信息,请参阅 构建环境中的环境变量 2016 年 12 月 7 日
故障排除主题 现已提供故障排除信息。有关更多信息,请参阅 故障排除 Amazon CodeBuild 2016 年 12 月 5 日
Jenkins 插件初始版本 这是的初始版本 CodeBuild Jenkins 插件。有关更多信息,请参阅 将 Amazon CodeBuild 与 Jenkins 结合使用 2016 年 12 月 5 日
用户指南初始版本 这是的初始版本CodeBuild 用户指南. 2016 年 12 月 1 日