AWS CodeBuild 现在支持使用构建徽章,该徽章提供一个动态生成的可嵌入映像(徽章),用以显示项目的最新构建状态。可通过为您的 CodeBuild 项目生成的公开可用的 URL 访问此映像。这将允许任何人查看 CodeBuild 项目的状态。构建徽章不包含任何安全信息,因此它们无需身份验证。
创建具有构建徽章的构建项目
使用以下过程之一创建已启用构建徽章的构建项目。您可以使用 AWS CLI 或 AWS Management Console。
创建已启用构建徽章的构建项目(AWS CLI)
有关创建构建项目的信息,请参阅创建构建项目 (AWS CLI)。要在您的 AWS CodeBuild 项目中包含构建徽章,您必须指定值为
true
的badgeEnabled
。
创建已启用构建徽章的构建项目(控制台)
从 https://console.aws.amazon.com/codesuite/codebuild/home
打开 AWS CodeBuild 控制台。 -
如果显示了 CodeBuild 信息页面,请选择创建构建项目。否则,请在导航窗格中,展开构建,选择构建项目,然后选择创建构建项目。
在项目名称中,输入此构建项目的名称。构建项目名称在您的各个 AWS 账户内必须是唯一的。您还可以包含构建项目的可选描述,以帮助其他用户了解此项目的用途。
-
在源中,对于源提供商,选择源代码提供商类型,然后执行以下操作之一:
注意
CodeBuild 不支持 Amazon S3 源提供商随附的构建徽章。由于 AWS CodePipeline 使用 Amazon S3 进行构件传输,因此对于作为在 CodePipeline 中创建的管道的一部分的构建项目,不支持构建徽章。
-
如果您选择了 CodeCommit,那么对于存储库,请选择存储库的名称。选择启用构建徽章,以使您的项目的构建状态可见且可嵌入。
-
如果您选择了 GitHub,请按照说明连接(或重新连接)GitHub。在 GitHub 授权应用程序页面上,对于组织访问权限,选择您希望 AWS CodeBuild 能够访问的每个存储库旁边的请求访问。选择授权应用程序后,返回 AWS CodeBuild 控制台,对于存储库,选择包含源代码的存储库的名称。选择启用构建徽章,以使您的项目的构建状态可见且可嵌入。
-
如果您选择了 Bitbucket,请按照说明连接(或重新连接)Bitbucket。在 Bitbucket 确认对账户的访问页面上,对于组织访问权限,选择授予访问权限。选择授予访问权限后,返回 AWS CodeBuild 控制台,对于存储库,选择包含源代码的存储库的名称。选择启用构建徽章,以使您的项目的构建状态可见且可嵌入。
重要
更新项目源可能会影响项目构建徽章的准确性。
-
-
在环境中:
对于环境映像,执行下列操作之一:
-
要使用由 AWS CodeBuild 托管的 Docker 映像,请选择托管映像,然后从操作系统、运行时和映像以及映像版本中进行相应选择。从环境类型中进行选择(如果可用)。
-
要使用其他 Docker 映像,请选择自定义映像。对于环境类型,请选择 ARM、Linux、Linux GPU 或 Windows。如果您针对外部注册表 URL 选择其他注册表,请使用
格式在 Docker Hub 中输入 Docker 映像的名称和标签。如果您选择 Amazon ECR,请使用 Amazon ECR 存储库和 Amazon ECR 映像在您的 AWS 账户中选择 Docker 映像。docker repository
/docker image name
-
要使用私有 Docker 映像,请选择自定义映像。对于环境类型,请选择 ARM、Linux、Linux GPU 或 Windows。对于映像注册表,选择其他注册表,然后输入您的私有 Docker 映像的凭证的 ARN。凭证必须由 Secrets Manager 创建。有关更多信息,请参阅《AWS Secrets Manager 用户指南》中的什么是 AWS Secrets Manager?。
-
-
在服务角色中,执行下列操作之一:
-
如果您没有 CodeBuild 服务角色,请选择新建服务角色。在角色名称中,为新角色输入名称。
-
如果您拥有 CodeBuild 服务角色,请选择现有服务角色。在角色 ARN 中,选择服务角色。
注意
当您使用控制台来创建或更新构建项目时,您可以同时创建 CodeBuild 服务角色。默认情况下,这个角色仅能与该构建项目配合使用。如果您使用控制台将此服务角色与另一个构建项目关联,则此角色将更新以便与关联的构建项目结合使用。一个服务角色最多可与 10 个构建项目结合使用。
-
-
在 Buildspec 中,执行以下操作之一:
-
选择使用 buildspec 文件,以在源代码根目录中使用 buildspec.yml 文件。
-
选择插入构建命令,以使用控制台插入构建命令。
有关更多信息,请参阅 Buildspec 参考。
-
-
在构件中,对于类型,执行以下操作之一:
-
如果您不想创建构建输出构件,请选择无构件。
-
要将构建输出存储在 S3 存储桶中,请选择 Amazon S3,然后执行以下操作:
-
如果要将项目名称用于构建输出 ZIP 文件或文件夹,请将名称留空。否则,请输入名称。默认情况下,构件名称是项目名称。如果您要使用其他名称,请在构件名称框中输入该名称。如果您要输出 ZIP 文件,请包含 zip 扩展名。
-
对于存储桶名称,请选择输出存储桶的名称。
-
如果您在此过程的前面部分选择了插入构建命令,对于输出文件,请输入构建(该构建要放到构建输出 ZIP 文件或文件夹中)中的文件位置。对于多个位置,使用逗号将各个位置隔开(例如,
appspec.yml, target/my-app.jar
)。有关更多信息,请参阅buildspec 语法中files
的描述。
-
-
-
展开其他配置并根据需要选择选项。
-
选择 Create build project(创建构建项目)。在审核页面上,选择开始构建以运行构建。