更改构建项目的设置(控制台) - Amazon CodeBuild
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

更改构建项目的设置(控制台)

要更改构建项目的设置,请执行以下过程:

  1. https://console.aws.amazon.com/codesuite/codebuild/home 打开 Amazon CodeBuild 控制台。

  2. 在导航窗格中,选择构建项目

  3. 请执行以下操作之一:

    • 选择要更改的构建项目的链接,然后选择构建详细信息

    • 选择要更改的构建项目旁边的按钮,选择查看详细信息,然后选择构建详细信息

您可以修改以下部分:

项目配置

项目配置部分,选择编辑。完成更改后,请选择更新配置,以保存新的配置。

您可以修改以下属性。

描述

输入构建项目的可选描述,以帮助其他用户了解此项目的用途。

构建徽章

选择启用构建徽章,以使您的项目的构建状态可见且可嵌入。有关更多信息,请参阅构建徽章示例

注意

如果您的源提供商是 Amazon S3,则构建徽章不适用。

启用并发构建限制

如果要限制此项目的并发构建数量,请执行以下步骤:

  1. 选择限制此项目可以启动的并发构建数量

  2. 并发构建限制中,输入此项目允许的并发构建的最大数量。此限制不得大于为该账户设置的并发构建限制。如果您尝试输入大于账户限制的数字,则会显示错误消息。

仅当当前构建数量小于或等于此限值时,才会启动新构建。如果当前构建计数达到此限值,则新构建将受到限制且不会运行。

其他信息

对于标签,请输入您希望支持 Amazon 服务使用的任何标签的名称和值。使用添加行添加标签。最多可以添加 50 个标签。

来源

部分中,请选择编辑。完成更改后,请选择更新配置,以保存新的配置。

您可以修改以下属性:

源提供商

选择源代码提供商类型。使用以下列表为您的源提供商选择适当的选项:

注意

CodeBuild 不支持 Bitbucket 服务器。

Amazon S3
存储桶

选择包含源代码的输入存储桶的名称。

S3 对象密钥或 S3 文件夹

输入 ZIP 文件的名称或包含源代码的文件夹的路径。

源版本

输入表示输入文件版本的对象的版本 ID。有关更多信息,请参阅 源版本示例,包含 Amazon CodeBuild

CodeCommit
存储库

选择要使用的存储库。

参考类型

选择分支Git 标签提交 ID,以指定源代码的版本。有关更多信息,请参阅 源版本示例,包含 Amazon CodeBuild

注意

我们建议您选择看起来不像提交 ID 的 Git 分支名称,例如 811dd1ba1aba14473856cee38308caed7190c0d5392f7。这可以帮助您避免 Git 签出与实际提交发生冲突。

Git 克隆深度

选择该选项,以创建一个浅克隆,其历史记录会截断至指定数量的提交。如果您需要完整克隆,请选择完整

Git 子模块

如果您希望在存储库中包含 Git 子模块,请选择使用 Git 子模块

Bitbucket
存储库

选择使用 OAuth 进行连接使用 Bitbucket 应用程序密码进行连接并按照说明连接(或重新连接)到 Bitbucket。

选择一个公共存储库或您账户中的某个存储库。

源版本

输入分支、提交 ID、标签,或引用以及提交 ID。有关更多信息,请参阅 源版本示例,包含 Amazon CodeBuild

注意

我们建议您选择看起来不像提交 ID 的 Git 分支名称,例如 811dd1ba1aba14473856cee38308caed7190c0d5392f7。这可以帮助您避免 Git 签出与实际提交发生冲突。

Git 克隆深度

选择Git 克隆深度以创建一个浅克隆,其历史记录会截断至指定数量的提交。如果您需要完整克隆,请选择完整

Git 子模块

如果您希望在存储库中包含 Git 子模块,请选择使用 Git 子模块

构建状态

如果您希望向源提供商报告构建的开始和完成状态,请选择在您的构建开始和完成时向源提供商报告构建状态

为了能够向源提供商报告构建状态,与源提供商关联的用户必须拥有对存储库的写入权限。如果用户没有写入权限,则无法更新构建状态。有关更多信息,请参阅源提供商访问权限

状态上下文中,输入要在 Bitbucket 提交状态中用于 name 参数的值。有关更多信息,请参阅 Bitbucket API 文档中的构建

目标 URL 中,输入要在 Bitbucket 提交状态中用于 url 参数的值。有关更多信息,请参阅 Bitbucket API 文档中的构建

由 Webhook 触发的构建的状态将始终报告给源提供商。要将从控制台或 API 调用启动的构建状态报告给源提供商,您必须选择此设置。

如果项目的构建通过 webhook 触发,则必须将新的提交推送到存储库,此设置才能生效。

如果要在每次将代码更改推送到此存储库时生成源代码,请在 “主源 webhook 事件” 中,选择 “每次将代码更改推送到此存储库时都重建”。 CodeBuild 有关 webhook 和筛选条件组的更多信息,请参阅 Bitbucket Webhook 事件

GitHub
存储库

选择 “使用 OAuth 连接” 或 “使用 GitHub 个人访问令牌连接”,然后按照说明进行连接(或重新连接) GitHub 并授权访问。Amazon CodeBuild

选择一个公共存储库或您账户中的某个存储库。

源版本

输入分支、提交 ID、标签,或引用以及提交 ID。有关更多信息,请参阅 源版本示例,包含 Amazon CodeBuild

注意

我们建议您选择看起来不像提交 ID 的 Git 分支名称,例如 811dd1ba1aba14473856cee38308caed7190c0d5392f7。这可以帮助您避免 Git 签出与实际提交发生冲突。

Git 克隆深度

选择Git 克隆深度以创建一个浅克隆,其历史记录会截断至指定数量的提交。如果您需要完整克隆,请选择完整

Git 子模块

如果您希望在存储库中包含 Git 子模块,请选择使用 Git 子模块

构建状态

如果您希望向源提供商报告构建的开始和完成状态,请选择在您的构建开始和完成时向源提供商报告构建状态

为了能够向源提供商报告构建状态,与源提供商关联的用户必须拥有对存储库的写入权限。如果用户没有写入权限,则无法更新构建状态。有关更多信息,请参阅源提供商访问权限

状态上下文中,输入要用于 GitHub 提交状态的context参数的值。有关更多信息,请参阅 GitHub 开发者指南中的创建提交状态

在 “目标 URL” 中,输入要用于 GitHub 提交状态的target_url参数的值。有关更多信息,请参阅 GitHub 开发者指南中的创建提交状态

由 Webhook 触发的构建的状态将始终报告给源提供商。要将从控制台或 API 调用启动的构建状态报告给源提供商,您必须选择此设置。

如果项目的构建通过 webhook 触发,则必须将新的提交推送到存储库,此设置才能生效。

如果要在每次将代码更改推送到此存储库时生成源代码,请在 “主源 webhook 事件” 中,选择 “每次将代码更改推送到此存储库时都重建”。 CodeBuild 有关 webhook 和筛选条件组的更多信息,请参阅 GitHub webhook 事件

GitHub Enterprise Server
GitHub 企业个人访问令牌

请参阅 GitHub 企业服务器示例,以了解有关如何将个人访问令牌复制到剪贴板的信息。在文本字段中粘贴令牌,然后选择保存令牌

注意

您只需输入并保存一次个人访问令牌。 CodeBuild 在所有 future 项目中都使用此代币。

源版本

输入拉取请求、分支、提交 ID、标签,或引用以及提交 ID。有关更多信息,请参阅 源版本示例,包含 Amazon CodeBuild

注意

我们建议您选择看起来不像提交 ID 的 Git 分支名称,例如 811dd1ba1aba14473856cee38308caed7190c0d5392f7。这可以帮助您避免 Git 签出与实际提交发生冲突。

Git 克隆深度

选择Git 克隆深度以创建一个浅克隆,其历史记录会截断至指定数量的提交。如果您需要完整克隆,请选择完整

Git 子模块

如果您希望在存储库中包含 Git 子模块,请选择使用 Git 子模块

构建状态

如果您希望向源提供商报告构建的开始和完成状态,请选择在您的构建开始和完成时向源提供商报告构建状态

为了能够向源提供商报告构建状态,与源提供商关联的用户必须拥有对存储库的写入权限。如果用户没有写入权限,则无法更新构建状态。有关更多信息,请参阅源提供商访问权限

状态上下文中,输入要用于 GitHub 提交状态的context参数的值。有关更多信息,请参阅 GitHub 开发者指南中的创建提交状态

在 “目标 URL” 中,输入要用于 GitHub 提交状态的target_url参数的值。有关更多信息,请参阅 GitHub 开发者指南中的创建提交状态

由 Webhook 触发的构建的状态将始终报告给源提供商。要将从控制台或 API 调用启动的构建状态报告给源提供商,您必须选择此设置。

如果项目的构建通过 webhook 触发,则必须将新的提交推送到存储库,此设置才能生效。

不安全的 SSL

选择 “启用不安全 SSL”,以便在连接到 GitHub 企业项目存储库时忽略 SSL 警告。

如果要在每次将代码更改推送到此存储库时生成源代码,请在 “主源 webhook 事件” 中,选择 “每次将代码更改推送到此存储库时都重建”。 CodeBuild 有关 webhook 和筛选条件组的更多信息,请参阅 GitHub webhook 事件

环境

环境部分中,选择编辑。完成更改后,请选择更新配置,以保存新的配置。

您可以修改以下属性:

置备模式

要更改配置模式,请选择更改配置模式,然后执行以下任一操作:

  • 要使用由管理的按需队列Amazon CodeBuild,请选择按需。使用按需队列,为您的构建 CodeBuild 提供计算能力。构建完成后,计算机就会被销毁。按需实例集是完全托管式的,并包括自动扩展功能以应对需求激增。

  • 要使用由管理的预留容量队列Amazon CodeBuild,请选择预留容量,然后选择队列名称。使用预留容量实例集,您可以为构建环境配置一组专用实例。这些计算机保持闲置状态,可以立即处理生成或测试,并缩短构建持续时间。使用预留容量实例集,您的计算机将始终处于运行状态,并且只要预调配完毕,它们就会继续产生成本。

有关信息,请参阅 使用中的预留容量 Amazon CodeBuild

环境映像

要更改构建映像,请选择覆盖映像,然后执行以下操作之一:

  • 要使用由 Amazon CodeBuild 托管的 Docker 映像,请选择托管映像,然后从操作系统运行时映像以及映像版本中进行相应选择。从环境类型中进行选择(如果可用)。

  • 要使用其他 Docker 映像,请选择自定义映像。对于环境类型,请选择 ARMLinuxLinux GPUWindows。如果您针对外部注册表 URL 选择其他注册表,请使用 docker repository/docker image name 格式在 Docker Hub 中输入 Docker 映像的名称和标签。如果您选择 Amazon ECR,请使用 Amazon ECR 存储库Amazon ECR 映像在您的 Amazon 账户中选择 Docker 映像。

  • 要使用私有 Docker 映像,请选择自定义映像。对于环境类型,请选择 ARMLinuxLinux GPUWindows。对于映像注册表,选择其他注册表,然后输入您的私有 Docker 映像的凭证的 ARN。凭证必须由 Secrets Manager 创建。有关更多信息,请参阅《Amazon Secrets Manager 用户指南》中的什么是 Amazon Secrets Manager?

注意

CodeBuild 会替换自定义 Docker 镜像的。ENTRYPOINT

服务角色

请执行以下操作之一:

  • 如果您没有 CodeBuild 服务角色,请选择 “新建服务角色”。在角色名称中,为新角色输入名称。

  • 如果您有 CodeBuild 服务角色,请选择现有服务角色。在角色 ARN 中,选择服务角色。

注意

使用控制台创建构建项目时,可以同时创建 CodeBuild 服务角色。默认情况下,这个角色仅能与该构建项目配合使用。如果您使用控制台将此服务角色与另一个构建项目关联,则此角色将更新以便与关联的构建项目结合使用。一个服务角色最多可与 10 个构建项目结合使用。

其他配置
超时

指定一个介于 5 分钟到 8 小时之间的值,如果构建未完成,则在该值之后 CodeBuild 停止构建。如果小时分钟都留空,则将使用 60 分钟的默认值。

特权

如果您要构建 Docker 镜像或希望您的版本获得更高的权限,请选择启用此标志。 前提是你打算使用这个构建项目来构建 Docker 镜像。否则,尝试与 Docker 守护程序交互的所有关联的构建都将失败。您还必须启动 Docker 守护程序,以便您的构建与其交互。执行此操作的一种方法是通过运行以下构建命令在您的构建规范的 install 阶段初始化 Docker 守护程序。如果您选择了由 CodeBuild Docker 支持的构建环境镜像,请不要运行这些命令。

注意

默认情况下,非 VPC 版本启用 Docker 守护程序。如果您想使用 Docker 容器进行 VPC 构建,请参阅 Docker Docs 网站上的运行时权限和 Linux 功能并启用特权模式。此外,Windows 不支持特权模式。

- nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://127.0.0.1:2375 --storage-driver=overlay2 & - timeout 15 sh -c "until docker info; do echo .; sleep 1; done"
VPC

如果您 CodeBuild 想使用您的 VPC,请执行以下操作:

  • 对于 VPC,请选择 CodeBuild 使用的 VPC ID。

  • 对于 VPC 子网,请选择包含使用的 CodeBuild 资源的子网。

  • 对于 VPC 安全组,请选择 CodeBuild 用于允许访问 VPC 中资源的安全组。

有关更多信息,请参阅将 Amazon CodeBuild 与 Amazon Virtual Private Cloud 结合使用

计算

请选择可用选项之一。

环境变量

请输入每个环境变量的名称和值,然后选择类型,以供构建使用。

注意

CodeBuild 自动为您的Amazon地区设置环境变量。如果您尚未将以下环境变量添加到 buildspec.yml 中,则必须设置这些变量:

  • AWS_ACCOUNT_ID

  • IMAGE_REPO_NAME

  • IMAGE_TAG

控制台和 Amazon CLI 用户可以查看环境变量。如果您不担心环境变量的可见性,请设置名称字段,然后将类型设置为明文

我们建议您将具有敏感值(例如 Amazon 访问密钥 ID、Amazon 秘密访问密钥或密码)的环境变量作为参数存储在 Amazon EC2 Systems Manager Parameter Store 或 Amazon Secrets Manager 中。

如果您使用的是 Amazon EC2 Systems Manager Parameter Store,则对于类型,请选择参数。在名称中,输入 CodeBuild 要引用的标识符。对于,请按照 Amazon EC2 Systems Manager Parameter Store 中存储的参数名称输入参数名称。使用名为 /CodeBuild/dockerLoginPassword 的参数作为示例,对于类型,选择参数。对于名称,请输入 LOGIN_PASSWORD。对于,请输入 /CodeBuild/dockerLoginPassword

重要

如果您使用 Amazon EC2 Systems Manager Parameter Store,我们建议您使用以 /CodeBuild/ 开头的参数名称(例如,/CodeBuild/dockerLoginPassword)来存储参数。您可以使用 CodeBuild 控制台在 Amazon EC2 Systems Manager 中创建参数。选择创建参数,然后按照对话框中的说明操作。(在该对话框中,对于 KMS 密钥,您可以指定您账户中的 Amazon KMS 密钥的 ARN。Amazon EC2 Systems Manager 使用此密钥在存储过程中加密参数的值并在检索过程中解密参数的值。) 如果您使用 CodeBuild 控制台创建参数,则控制台会将参数名称的存储方式/CodeBuild/作为参数名称的开头。有关更多信息,请参阅《Amazon EC2 Systems Manager 用户指南》中的 Systems Manager Parameter StoreSystems Manager Parameter Store 控制台演练

如果您的构建项目引用了 Amazon EC2 Systems Manager Parameter Store 中存储的参数,则构建项目的服务角色必须允许 ssm:GetParameters 操作。如果您之前选择了 “新建服务角色”,请将此操作 CodeBuild 包含在构建项目的默认服务角色中。但是,如果您选择了现有服务角色,必须单独将此操作添加到您的服务角色中。

如果您的构建项目引用了 Amazon EC2 Systems Manager Parameter Store 中存储的但参数名称不以 /CodeBuild/ 开头的参数,且您选择了新建服务角色,您必须更新该服务角色以允许访问不以 /CodeBuild/ 开头的参数名称。这是因为该服务角色仅允许访问以 /CodeBuild/ 开头的参数名称。

如果您选择新建服务角色,服务角色将拥有解密 Amazon EC2 Systems Manager Parameter Store 中 /CodeBuild/ 命名空间下的所有参数的权限。

您设置的环境变量将替换现有的环境变量。例如,如果 Docker 映像已经包含一个名为 MY_VAR 的环境变量(值为 my_value),并且您设置了一个名为 MY_VAR 的环境变量(值为 other_value),那么 my_value 将被替换为 other_value。同样,如果 Docker 映像已经包含一个名为 PATH 的环境变量(值为 /usr/local/sbin:/usr/local/bin),并且您设置了一个名为 PATH 的环境变量(值为 $PATH:/usr/share/ant/bin),那么/usr/local/sbin:/usr/local/bin 将被替换为文本值 $PATH:/usr/share/ant/bin

请勿使用以 CODEBUILD_ 打头的名称设置任何环境变量。此前缀是专为内部使用预留的。

如果具有相同名称的环境变量在多处都有定义,则应按照如下方式确定其值:

  • 构建操作调用开始时的值优先级最高。

  • 构建项目定义中的值优先级次之。

  • buildspec 声明中的值优先级最低。

如果您使用 Secrets Manager,对于类型,请选择 Secrets Manager。在名称中,输入 CodeBuild 要引用的标识符。对于,请使用模式 secret-id:json-key:version-stage:version-id 输入 reference-key。有关信息,请参阅 Secrets Manager reference-key in the buildspec file

重要

如果您使用 Secrets Manager,我们建议您存储名称以 /CodeBuild/(例如 /CodeBuild/dockerLoginPassword)开头的密钥。有关更多信息,请参阅《Amazon Secrets Manager 用户指南》中的什么是 Amazon Secrets Manager?

如果您的构建项目引用了 Secrets Manager 中存储的密钥,则构建项目的服务角色必须允许 secretsmanager:GetSecretValue 操作。如果您之前选择了 “新建服务角色”,请将此操作 CodeBuild 包含在构建项目的默认服务角色中。但是,如果您选择了现有服务角色,必须单独将此操作添加到您的服务角色中。

如果您的构建项目引用了 Secrets Manager 中存储的但密钥名称不以 /CodeBuild/ 开头的密钥,且您选择了新建服务角色,您必须更新该服务角色以允许访问不以 /CodeBuild/ 开头的密钥名称。这是因为该服务角色仅允许访问以 /CodeBuild/ 开头的密钥名称。

如果您选择新建服务角色,该服务角色将拥有解密 Secrets Manager 中 /CodeBuild/ 命名空间下的所有密钥的权限。

Buildspec

Buildspec 部分,选择编辑。完成更改后,请选择更新配置,以保存新的配置。

您可以修改以下属性:

构建规范

请执行以下操作之一:

  • 如果您的源代码包含 buildspec 文件,请选择使用 buildspec 文件。默认情况下, CodeBuild 在源代码根目录中查找名为 buildspec.yml 的文件。如果您的 buildspec 文件使用其他名称或位置,请在 Buildspec 名称中输入其从源根目录开始的路径(例如,buildspec-two.ymlconfiguration/buildspec.yml。如果 buildspec 文件位于 S3 存储桶中,则该存储桶必须位于您的构建项目所在的同一 Amazon 区域中。使用 ARN(例如 arn:aws:s3:::<my-codebuild-sample2>/buildspec.yml)指定该 buildspec 文件。

  • 如果您的源代码不包括 buildspec 文件,或者如果您要运行的构建命令不是在源代码根目录的 buildspec.yml 文件中为 build 阶段指定的构建命令,则选择插入构建命令。对于构建命令,请输入您要在 build 阶段运行的命令。对于多个命令,使用 && 分开各个命令(例如 mvn test && mvn package)。要在其他阶段运行命令,或者,如果 build 阶段对应的命令列表特别长,请将 buildspec.yml 文件添加到源代码根目录,将命令添加到该文件中,然后选择在源代码根目录中使用 buildspec.yml

有关更多信息,请参阅 Buildspec 参考

批量配置

批量配置部分,选择编辑。完成更改后,请选择更新配置,以保存新的配置。有关更多信息,请参阅 在 Amazon CodeBuild 中批量构建

您可以修改以下属性:

批量服务角色

为批量构建提供服务角色。

选择以下操作之一:

  • 如果您没有批量服务角色,请选择新建服务角色。在服务角色中,为新角色输入名称。

  • 如果您拥有批量服务角色,请选择现有服务角色。在服务角色中,选择对应的服务角色。

批量构建为批量配置引入了全新的安全角色。这个新角色是必需的,因为 CodeBuild 必须能够代表你调用StartBuildStopBuild、和RetryBuild操作才能将生成作为批处理的一部分运行。客户应该使用新角色,而不是他们在构建中使用的角色,原因有两个:

  • 向构建角色授予 StartBuildStopBuildRetryBuild 权限后,将允许单个构建通过 buildspec 启动多个构建。

  • CodeBuild 批处理生成提供了限制,限制了可用于批次构建的生成数量和计算类型。如果构建角色拥有这些权限,则构建本身就有可能绕过这些限制。

批处理允许的计算类型

选择批处理允许的计算类型。选择所有适用的选项。

批处理允许的最大构建数量

输入批处理允许的最大构建数量。如果批处理超过此限制,则会失败。

批处理超时

输入完成批量构建能够使用的最长时间。

合并构件

选择将批处理中的所有构件合并到一个位置,将批处理中的所有构件合并到一个位置。

批量报告模式

为批量构建选择所需的构建状态报告模式。

注意

仅当项目源为 Bitbucket 或 E GitHub nterprise 时,此字段才可用,并且在 “来源” 下选择了生成开始和完成时向源提供商报告构建状态。 GitHub

聚合构建

选择该选项,可将批处理中所有构建的状态合并到一个状态报告中。

单个构建

选择该选项,可分别报告批处理中所有构建的构建状态。

构件

构件部分中,选择编辑。完成更改后,请选择更新配置,以保存新的配置。

您可以修改以下属性:

类型

请执行以下操作之一:

  • 如果您不想创建任何构建输出构件,请选择无构件。如果您只运行构建测试,或者您要将 Docker 映像推送到 Amazon ECR 存储库,建议执行此操作。

  • 要将构建输出存储在 S3 存储桶中,请选择 Amazon S3,然后执行以下操作:

    • 如果要将项目名称用于构建输出 ZIP 文件或文件夹,请将名称留空。否则,请输入名称。(如果您要输出 ZIP 文件,并且要让 ZIP 文件包含文件扩展名,请务必在 ZIP 文件名之后添加扩展名。)

    • 如果希望构建规范文件中指定的名称覆盖控制台中指定的任何名称,请选择启用语义版本控制。buildspec 文件中的名称是构建时计算得出的,使用 Shell 命令语言。例如,您可以将日期和时间附加到您的构件名称后面,以便确保其唯一性。为构件提供唯一名称可防止其被覆盖。有关更多信息,请参阅buildspec 语法

    • 对于存储桶名称,请选择输出存储桶的名称。

    • 如果您在此过程的前面部分选择了插入构建命令,那么对于输出文件,请输入构建(该构建要放到构建输出 ZIP 文件或文件夹中)中的文件位置。对于多个位置,使用逗号将各个位置隔开(例如,appspec.yml, target/my-app.jar)。有关更多信息,请参阅buildspec 语法files 的描述。

    • 如果不想加密构建构件,请选择删除构件加密

对于所需的每个辅助构件集:

  1. 对于构件标识符,输入少于 128 个字符且仅包含字母数字字符和下划线的值。

  2. 选择添加构件

  3. 按照前面步骤的说明配置辅助构件。

  4. 选择保存构件

其他配置
加密密钥

请执行以下操作之一:

  • 要使用您的账户中的 Amazon 托管式密钥 Amazon S3 加密构建输出构件,请将加密密钥留空。这是默认模式。

  • 要使用客户托管密钥加密构建输出构件,请在加密密钥中输入客户托管密钥的 ARN。采用格式 arn:aws:kms:region-ID:account-ID:key/key-ID

缓存类型

对于缓存类型,请选择下列选项之一:

  • 如果您不想使用缓存,请选择无缓存

  • 如果要使用 Amazon S3 缓存,请选择 Amazon S3,然后执行以下操作:

    • 对于存储桶,选择存储缓存的 S3 存储桶的名称。

    • (可选)对于缓存路径前缀,输入 Amazon S3 路径前缀。缓存路径前缀值类似于目录名称。它使您能够在存储桶的同一目录下存储缓存。

      重要

      请勿将尾部斜杠 (/) 附加到路径前缀后面。

  • 如果想要使用本地缓存,请选择本地,然后选择一个或多个本地缓存模式。

    注意

    Docker 层缓存模式仅适用于 Linux。如果您选择该模式,您的项目必须在特权模式下运行。

使用缓存可节省大量构建时间,因为构建环境的可重用部分被存储在缓存中,并且可跨构建使用。有关在 buildspec 文件中指定缓存的信息,请参阅buildspec 语法。有关缓存的更多信息,请参阅 在 Amazon CodeBuild 中构建缓存

日志

标签部分中,选择编辑。完成更改后,请选择更新配置,以保存新的配置。

您可以修改以下属性:

选择要创建的日志。您可以创建 Amazon CloudWatch 日志、Amazon S3 日志或两者兼而有之。

CloudWatch

如果你想要 Amazon CloudWatch Logs 日志:

CloudWatch 日志

选择CloudWatch 日志

组名

输入您的 Amazon CloudWatch 日志组的名称。

流名称

输入您的 Amazon CloudWatch 日志流名称。

S3

如果要创建 Amazon S3 日志:

S3 日志

选择 S3 日志

存储桶

选择您的日志的 S3 存储桶的名称。

路径前缀

输入日志的前缀。

禁用 S3 日志加密

如果您不希望加密您的 S3 日志,请选择此选项。