本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Amazon CodeBuild 用户指南文档历史记录
下表列出了自 Amazon CodeBuild 上一次发布以来对文档所做的重要更改。如需对此文档更新的通知，您可以订阅 RSS 源。
-
最新 API 版本：2016-10-06
-
最近文档更新时间：2021 年 10 月 4 日
| 变更 | 说明 | 日期 |
|---|---|---|
CodeBuild 现在允许您选择如何将批量构建状态发送给项目的源提供商。有关更多信息，请参阅 。Batch 报告模式. | 2021 年 10 月 4 日 | |
CodeBuild 现在支持小型 ARM 计算类型。有关更多信息，请参阅构建环境计算类型。 | 2021 年 9 月 13 日 | |
批量构建的会话调试 | 2021 年 3 月 3 日 | |
项目级别的并发构建限制 | CodeBuild 现在允许您限制构建项目的并发构建数量。有关更多信息，请参阅 。项目配置和并发 BuildLimit. | 2021 年 2 月 16 日 |
新的 buildspec 属性：s3‑prefix | CodeBuild 现在提供 | 2021 年 2 月9 日 |
新的 buildspec 属性：开启失败 | CodeBuild 现在提供 | 2021 年 2 月9 日 |
新的 buildspec 属性：排除路径 | CodeBuild 现在提供 | 2021 年 2 月9 日 |
新的 buildspec 属性：启用符号链接 | CodeBuild 现在提供 | 2021 年 2 月9 日 |
buildspec 工件名称增强 | CodeBuild 现在允许 | 2021 年 2 月9 日 |
代码覆盖率报告 | CodeBuild 现在提供代码覆盖率报告。有关更多信息，请参阅 。代码覆盖率报告. | 2020 年 7 月 30 日 |
Batch 构建 | CodeBuild 现在支持运行项目的并发和协调构建。有关更多信息，请参阅 。在 CodeBuild 中 Batch 构建. | 2020 年 7 月 30 日 |
Windows Server 2019 映像 | CodeBuild 现在提供了一个 Windows 服务器核心 2019 年构建映像。有关更多信息，请参阅 。提供的 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 日 |
新主题 | 2019 年 12 月 13 日 | |
新增和更新的主题 | CodeBuild 现在支持在构建项目运行期间测试报告。有关更多信息，请参阅使用测试报告、创建测试报告和使用 Amazon CLI 示例创建测试报告。 | 2019 年 11 月 25 日 |
对主题进行了更新 | CodeBuild 现在支持 Linux GPU 和 Arm 环境类型， | 2019 年 11 月 19 日 |
对主题进行了更新 | CodeBuild 现在支持所有构建的构建编号、导出环境变量和Amazon Secrets Manager集成。有关更多信息，请参阅 。导出的变量和Secrets Manager在构建规范语法. | 2019 年 11 月 6 日 |
新主题 | CodeBuild 现在支持通知规则。您可以使用通知规则向用户通知构建项目中的重要更改。有关更多信息，请参阅创建通知规则。 | 2019 年 11 月 5 日 |
对主题进行了更新 | CodeBuild 现在支持安卓版本 29 和 Go 版本 1.13 运行时。有关更多信息，请参阅 。提供的 Docker 映像和构建规范语法. | 2019 年 9 月 10 日 |
对主题进行了更新 | 在创建项目时，您现在可以选择 Amazon Linux 2 (AL2) 托管映像。有关更多信息，请参阅 。提供的 Docker 映像和的 CodeBuild 建规范文件示例中的运行时版本. | 2019 年 8 月 16 日 |
对主题进行了更新 | 创建项目时，您现在可以选择禁用 S3 日志的加密，并且如果使用基于 Git 的源存储库，则还可以包括 Git 子模块。有关更多信息，请参阅 。在 Code构建中创建构建项目. | 2019 年 3 月 8 日 |
新主题 | CodeBuild 现在支持本地缓存。创建构建时，可以在四种模式中的一种或多种模式中指定本地缓存。有关更多信息，请参阅 。在 CodeBuild 中构建缓存. | 2019 年 2 月 21 日 |
新主题 | CodeBuild 现在支持 Webhook 筛选条件组以指定触发构建的事件。有关更多信息，请参阅筛选 GitHub Webhook 事件和筛选 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 现在支持用于衡量构建中每个阶段持续时间的新构建指标。有关更多信息，请参阅 。CodeBuildCloudWatch 指标. | 2018 年 11 月 15 日 |
VPC 终端节点策略主题 | 的 CodeBuild Amazon VPC 终端节点现在支持策略。有关更多信息，请参阅 。为 CodeBuild 建创 VPC 终端节点策略. | 2018 年 11 月 9 日 |
更新的内容 | 更新了主题以反映新控制台体验。 | 2018 年 10 月 30 日 |
Amazon EFS 示例 | CodeBuild 可以在构建规范文件中使用命令挂载 Amazon EFS 文件系统。有关更多信息，请参阅 。CodeBuild 的亚马逊 EFS 示例. | 2018 年 10 月 26 日 |
Bitbucket Webhook | 在您为存储库使用 BitBucket 时，CodeBuild 现在支持 Webhook。有关更多信息，请参阅 。的 CodeBuild 的 Bitbucket 拉取请求示例. | 2018 年 10 月 2 日 |
S3 日志 | CodeBuild 现在在 S3 存储桶中支持构建日志。以前，您只能使用 CloudWatch Logs 构建日志。有关更多信息，请参阅创建项目。 | 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 CloudWatch 指标和警报的 Support | CodeBuild 现在提供与 CloudWatch 指标和警报的集成。您可以使用 CodeBuild 或 CloudWatch 控制台监控项目级别和账户级别的构建。有关更多信息，请参阅监控构建。 | 2018 年 7 月 19 日 |
支持报告构建的状态 | CodeBuild 现在可以向您的源提供商报告构建的开始和完成状态。有关更多信息，请参阅 。在 Code构建中创建构建项目. | 2018 年 7 月 10 日 |
添加到 CodeBuild 文档的环境变量 | 构建环境中的环境变量页面使用 CODEBUILD_BUILD_ID、CODEBUILD_LOG_PATH 和 CODEBUILD_START_TIME 环境变量进行了更新。 | 2018 年 7 月 9 日 |
Supportfinally在 buildspec 文件中将阻止 | CodeBuild 文档使用可选的详细信息进行了更新。 | 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) 或者Amazon开发工具包告知 CodeBuild 使用四个联邦信息处理标准 (FIPS) 终端节点之一。有关更多信息，请参阅指定 Amazon CodeBuild 终端节点。 | 2018 年 3 月 28 日 |
| Amazon CodeBuild在亚太地区（孟买）、欧洲（巴黎）和南美洲（圣保罗）提供。 | Amazon CodeBuild现已在亚太地区（孟买）、欧洲（巴黎）和南美洲（圣保罗）区域推出。有关更多信息，请参阅 。Amazon CodeBuild中的Amazon Web Services. | 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 CodeBuild中的Amazon Web Services. | 2017 年 6 月 29 日 |
| 已支持其他构建规范文件名称和位置 | 现在，您可以不为构建项目指定源代码根目录处的名为 buildspec.yml 的默认构建规范文件，而是指定使用文件名称或位置与之不同的构建规范文件。有关更多信息，请参阅构建规范文件名称和存储位置。 |
2017 年 6 月 27 日 |
| 更新了构建通知示例 | CodeBuild 现在通过 Amazon CloudWatch Event 和 Amazon Simple Notification Service (Amazon SNS) 为构建通知提供内置支持。先前的构建通知示例已更新为演示此新行为。 | 2017 年 6 月 22 日 |
| 添加了自定义映像中的 Docker 示例 | 已添加说明如何使用 CodeBuild 和自定义 Docker 构建映像来构建和运行 Docker 映像的示例。有关更多信息，请参见 自定义映像示例中的 Docker。 | 2017 年 6 月 7 日 |
| 从 GitHub 提取源代码的拉取请求 |
当使用依赖于存储在 GitHub 存储库中的源代码的 CodeBuild 运行构建时，您现在可以指定要构建的 GitHub 拉取请求 ID。您还可以改为指定提交 ID、分支名称或标签名称。有关更多信息，请参阅 。源版本中的值运行构建（控制台）或者 |
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 CodeBuild中的Amazon Web Services. | 2017 年 3 月 21 日 |
| 为 CodePipeline 测试操作支持 | 您现在可以将使用 CodePipeline 的测试操作添加到 CodeBuild Pipeline 中的管道。有关更多信息，请参阅将 CodeBuild 测试操作添加到管道（CodePipeline 控制台）。 | 2017 年 3 月 8 日 |
| 构建规范文件支持从选定的顶级目录中获取构建输出 | 借助构建规范文件，您现在可以指定单独的顶级目录，指示 CodeBuild 将其中的内容添加到构建输出项目中。为此，您可以使用 base-directory 映射。有关更多信息，请参阅构建规范语法。 |
2017 年 2 月 8 日 |
| 内置环境变量 | Amazon CodeBuild 为您要使用的构建提供了额外的内置环境变量。这些包括描述启动了构建项目的实体的环境变量、指向源代码存储库的 URL 以及源代码的版本 ID 等。有关更多信息，请参阅构建环境中的环境变量。 | 2017 年 1 月 30 日 |
| Amazon CodeBuild在美国东部（俄亥俄）提供 | Amazon CodeBuild现已在美国东部（俄亥俄）区域中提供。有关更多信息，请参阅 。Amazon CodeBuild中的Amazon Web Services. | 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 日 |