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

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

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

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

  • 最近文档更新时间:2019 年 8 月 22 日

变更 说明 日期

对主题进行了更新

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

August 16, 2019

对主题进行了更新

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

March 8, 2019

新主题

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

February 21, 2019

新主题

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

February 8, 2019

新主题

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

February 4, 2019

支持专用 Docker 镜像仓库

CodeBuild 现在支持使用在专用镜像仓库中存储的 Docker 镜像作为您的运行时环境。有关更多信息,请参阅专用镜像仓库与 AWS Secrets Manager 示例

January 24, 2019

对主题进行了更新

CodeBuild 现在支持使用另一 AWS 账户中的 Amazon ECR 映像。有多个主题进行了更新,以反映此更改,包括 CodeBuild 的 Amazon ECR 示例创建构建项目创建 CodeBuild 服务角色

January 24, 2019

对主题进行了更新

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

December 6, 2018

对主题进行了更新

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

November 15, 2018

VPC 终端节点策略主题

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

November 9, 2018

更新的内容

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

October 30, 2018

Amazon EFS 示例

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

October 26, 2018

BitBucket Webhooks

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

October 2, 2018

S3 日志

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

September 17, 2018

多输入源和多输出构件

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

August 30, 2018

语义版本控制示例

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

August 14, 2018

新的静态网站示例

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

August 14, 2018

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

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

August 7, 2018

支持未加密的构建构件

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

July 26, 2018

支持 Amazon CloudWatch 指标和警报

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

July 19, 2018

支持报告构建的状态

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

July 10, 2018

添加到 CodeBuild 文档的环境变量

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

July 9, 2018

支持构建规范文件中的 finally 数据块

CodeBuild 文档更新了有关构建规范文件中的可选 finally 数据块的详细信息。finally 语句块命令总是在其相应的命令语句块命令之后执行。有关更多信息,请参阅生成规范语法

June 20, 2018

CodeBuild 代理更新通知

CodeBuild 文档中有关您使用 Amazon SNS 获得新版本 CodeBuild 代理发布通知的方式的详细信息进行了更新。有关更多信息,请参阅接收有关新 AWS CodeBuild 代理版本的通知

June 15, 2018

早期更新

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

变更 描述 日期
支持 Windows 构建 CodeBuild 现在支持 Microsoft Windows Server 平台的构建,包括 Windows 上 .NET Core 2.0 的预打包构建环境。有关更多信息,请参阅适用于 CodeBuild 的 Microsoft Windows 示例 2018 年 5 月 25 日
支持构建幂等性 当您使用 AWS Command Line Interface (AWS CLI) 运行 start-build 命令时,可以指定构建为幂等性的。有关更多信息,请参阅运行构建项目 (AWS CLI) 2018 年 5 月 15 日
支持覆盖多个构建项目设置 现在,在创建构建时,可以覆盖多个构建项目设置。覆盖仅针对该构建。有关更多信息,请参阅在 CodeBuild 中运行构建 2018 年 5 月 15 日
VPC 终端节点支持 现在,您可以使用 VPC 终端节点来提高构建的安全性。有关更多信息,请参阅 使用 VPC 终端节点 2018 年 3 月 18 日
支持触发器 现在,您可以创建触发器,按固定频率安排构建。有关更多信息,请参阅创建 CodeBuild 触发器 2018 年 3 月 28 日
FIPS 终端节点文档 现在,您可以了解如何使用 AWS Command Line Interface (AWS CLI) 或 AWS 开发工具包来告知 CodeBuild 使用四种联邦信息处理标准 (FIPS) 终端节点之一。有关更多信息,请参阅指定 CodeBuild 终端节点 2018 年 3 月 28 日
AWS CodeBuild 在Asia Pacific (Mumbai)、EU (Paris)和South America (São Paulo)中可用 AWS CodeBuild 现已在Asia Pacific (Mumbai)、EU (Paris)和South America (São Paulo)区域中可用。有关更多信息,请参阅 Amazon Web Services General Reference 中的“AWS 区域和终端节点”主题的 AWS CodeBuild 部分。 2018 年 3 月 28 日
GitHub Enterprise 支持 CodeBuild 现在可以从存储在 GitHub Enterprise 存储库中的源代码进行构建。有关更多信息,请参阅GitHub Enterprise 示例 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 日
AWS Config 集成 AWS Config 现在支持 CodeBuild 作为 AWS 资源,这表示该服务可以跟踪您的 CodeBuild 项目。有关 AWS Config 的更多信息,请参阅将 AWS Config 与 AWS CodeBuild 结合使用的示例 2017 年 10 月 20 日
在 GitHub 存储库中自动重新构建更新的源代码 如果您的源代码存储在 GitHub 存储库中,则可让 AWS CodeBuild 在代码更改被推送到存储库时重新构建源代码。有关更多信息,请参阅GitHub 拉取请求和 Webhook 筛选示例 2017 年 9 月 21 日
在 Amazon EC2 Systems Manager Parameter Store 中存储和检索敏感或大型环境变量的新方法 您现在可以使用 AWS CodeBuild 控制台或 AWS CLI 来检索存储在 Amazon EC2 Systems Manager Parameter Store 中的敏感或大型环境变量。现在也可以使用 AWS CodeBuild 控制台将这些类型的环境变量存储在 Amazon EC2 Systems Manager Parameter Store 中。以前,您只能通过将这些类型的环境变量包含在生成规范中或运行构建命令以自动化 AWS CLI 来检索这些变量。您只能通过使用 Amazon EC2 Systems Manager Parameter Store 控制台来存储这些类型的环境变量。有关更多信息,请参阅创建构建项目更改生成项目的设置运行生成项目 2017 年 9 月 14 日
构建删除支持 您现在可以在 AWS CodeBuild 中删除构建。有关更多信息,请参阅删除构建 2017 年 8 月 31 日
使用生成规范检索存储在 Amazon EC2 Systems Manager Parameter Store 中的敏感或大型环境变量的更新方法 AWS CodeBuild 现在可让您更轻松地使用生成规范来检索存储在 Amazon EC2 Systems Manager Parameter Store 中的敏感或大型环境变量。以前,您只能通过运行构建命令自动化 AWS CLI 来检索这些类型的环境变量。有关更多信息,请参阅生成规范语法中的 parameter-store 映射。 2017 年 8 月 10 日
AWS CodeBuild 支持 Bitbucket CodeBuild 现在可以从存储在 Bitbucket 存储库中的源代码进行构建。有关更多信息,请参阅 创建构建项目运行生成项目 2017 年 8 月 10 日
AWS CodeBuild 在US West (N. California)、EU (London)和Canada (Central)中可用 AWS CodeBuild 现已在US West (N. California)、EU (London)和Canada (Central)区域中可用。有关更多信息,请参阅 Amazon Web Services General Reference 中的“AWS 区域和终端节点”主题的 AWS CodeBuild 部分。 2017 年 6 月 29 日
已支持替代构建规范文件名称和位置 您现在可以指定构建规范文件的替代文件名称或位置以用于构建项目,而不是源代码根处的名为 buildspec.yml 的默认构建规范文件。有关更多信息,请参阅构建规范文件名称和存储位置 2017 年 6 月 27 日
更新了构建通知示例 CodeBuild 现在通过 Amazon CloudWatch Events 和 Amazon Simple Notification Service (Amazon SNS) 提供对构建通知的内置支持。先前的生成通知示例已更新为演示此新行为。 2017 年 6 月 22 日
添加了自定义映像中的 Docker 示例 已添加说明如何使用 CodeBuild 和自定义 Docker 构建镜像来构建和运行 Docker 镜像的示例。有关更多信息,请参阅 自定义映像示例中的 Docker 2017 年 6 月 7 日
从 GitHub 提取源代码的拉取请求

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

2017 年 6 月 6 日
更新了生成规范版本 已发布新版本的生成规范格式。版本 0.2 可解决 CodeBuild 在默认 Shell 的单独实例中运行每条构建命令的问题。此外,在版本 0.2 中,environment_variables 已重命名为 env,而且 plaintext 已重命名为 variables。有关更多信息,请参阅适用于 CodeBuild 的生成规范参考 2017 年 5 月 9 日
在 GitHub 中提供构建映像的 Dockerfile AWS CodeBuild 提供的许多构建映像的定义在 GitHub 中作为 Dockerfile 提供。有关更多信息,请参阅 CodeBuild 提供的 Docker 镜像中表的“定义”列。 2017 年 5 月 2 日
AWS CodeBuild 在EU (Frankfurt)、Asia Pacific (Singapore)、Asia Pacific (Sydney)和Asia Pacific (Tokyo)中可用 AWS CodeBuild 现已在EU (Frankfurt)、Asia Pacific (Singapore)、Asia Pacific (Sydney)和Asia Pacific (Tokyo)区域中可用。有关更多信息,请参阅 Amazon Web Services General Reference 中的“AWS 区域和终端节点”主题的 AWS CodeBuild 部分。 2017 年 3 月 21 日
CodePipeline 对 CodeBuild 的测试操作支持 现在,您可以将使用 CodeBuild 的测试操作添加到 CodePipeline 中的管道。有关更多信息,请参阅将 CodeBuild 测试操作添加到管道(CodePipeline 控制台) 2017 年 3 月 8 日
生成规范支持从选定的顶级目录中获取构建输出 借助生成规范,您现在可以指定单独的顶级目录,指示 CodeBuild 将其中的内容添加到构建输出项目中。为此,您可以使用 base-directory 映射。有关更多信息,请参阅生成规范语法 2017 年 2 月 8 日
内置环境变量 AWS CodeBuild 为您要使用的构建提供了额外的内置环境变量。这些包括描述启动了构建项目的实体的环境变量、指向源代码存储库的 URL 以及源代码的版本 ID 等。有关更多信息,请参阅构建环境中的环境变量 2017 年 1 月 30 日
AWS CodeBuild 在US East (Ohio)中可用 AWS CodeBuild 目前在US East (Ohio)区域中可用。有关更多信息,请参阅 Amazon Web Services General Reference 中的“AWS 区域和终端节点”主题的 AWS CodeBuild 部分。 2017 年 1 月 19 日
AWS Lambda 示例 向示例添加了一条引用,说明如何使用 CodeBuild 以及 Lambda、AWS CloudFormation 和 CodePipeline 来构建和部署遵循了 AWS 无服务器应用程序模型 (AWS SAM) 标准的无服务器应用程序。有关更多信息,请参阅 AWS Lambda 示例 2016 年 12 月 20 日
Shell 和命令行为信息 CodeBuild 在构建环境默认 Shell 的单独实例中运行您指定的每个命令。这种默认行为可对您的命令产生一些意想不到的副作用。我们推荐了一些方法,用于在需要时处理这种默认行为。有关更多信息,请参阅构建环境中的 Shell 和命令 2016 年 12 月 9 日
环境变量信息 CodeBuild 提供了您可以在构建命令中使用的多个环境变量。您也可以定义自己的环境变量。有关更多信息,请参阅构建环境中的环境变量 2016 年 12 月 7 日
故障排除主题 现已提供故障排除信息。有关更多信息,请参阅 CodeBuild 问题排查 2016 年 12 月 5 日
Jenkins 插件初始版本 这是 CodeBuild Jenkins 插件的初始版本。有关更多信息,请参阅将 AWS CodeBuild 与 Jenkins 结合使用 2016 年 12 月 5 日
用户指南初始版本 这是 CodeBuild 用户指南 的初始版本。 2016 年 12 月 1 日

本页内容: