对于 GitLab,您可以使用 GitLab 连接来访问源提供商。
将 CodeBuild 连接到 GitLab
连接使您可以授权和建立一些配置,使用 AWS CodeConnections 将您的第三方提供商与您的 AWS 资源相关联。要将您的第三方存储库关联为构建项目的源,您应使用连接。
要在 CodeBuild 中添加 GitLab 或 GitLab 自行管理源提供商,您可以选择执行以下任一操作:
-
使用 CodeBuild 控制台创建构建项目向导或编辑源页面来选择 GitLab 或 GitLab 自行管理提供商选项。要添加源提供商,请参阅创建到 GitLab 的连接(控制台)。控制台可帮助您创建连接资源。
-
使用 CLI 来创建连接资源,请参阅 创建到 GitLab 的连接(CLI),以便使用 CLI 创建连接资源。
注意
您也可以使用开发人员工具控制台,在设置下创建连接。参阅创建连接。
注意
授权在 GitLab 中安装此连接,即表示您向我们的服务授予相关的权限,使服务可通过访问您的账户来处理您的数据,并且您可以随时通过卸载应用程序来撤消这些权限。
创建到 GitLab 的连接
本节介绍如何将 GitLab 连接到 CodeBuild。有关 GitLab 连接的更多信息,请参阅将 CodeBuild 连接到 GitLab。
开始前的准备工作:
-
您必须已使用 GitLab 创建了账户。
注意
连接只能访问用于创建并授权连接的账户所拥有的存储库。
注意
您可以创建与您在 GitLab 中具有拥有者角色的存储库的连接,然后该连接可以与包含诸如 CodeBuild 之类的资源的存储库一起使用。对于群组中的仓库,您无需成为群组拥有者。
-
要为您的构建项目指定一个源,必须事先在 GitLab 上创建存储库。
创建到 GitLab 的连接(控制台)
通过以下步骤,可使用 CodeBuild 控制台为 GitLab 中您的项目(存储库)添加连接。
创建或编辑您的构建项目
-
登录到 CodeBuild 控制台。
-
选择以下选项之一。
-
选择创建构建项目。按照创建构建项目(控制台)中的步骤完成第一个屏幕,然后在源部分的源提供商下,选择 GitLab。
-
选择编辑现有构建项目。选择编辑,然后选择源。在编辑源页面的源提供商下面,选择 GitLab。
-
-
选择以下操作之一:
-
在连接下,选择默认连接。默认连接将在所有项目中应用默认 GitLab 连接。
-
在连接下,选择自定义连接。自定义连接会应用自定义 GitLab 连接,该连接会覆盖您账户的默认设置。
-
-
请执行以下操作之一:
-
在默认连接或自定义连接下,如果您尚未创建与提供商的连接,请选择创建新 GitLab 连接。继续执行步骤 5,以便创建连接。
-
在连接下,如果您已创建到提供程序的连接,请选择该连接。继续执行步骤 10。
注意
如果您在创建 GitLab 连接之前关闭弹出窗口,则需要刷新页面。
-
-
要创建到 GitLab 存储库的连接,请在选择提供商下,选择 GitLab。在连接名称中,输入要创建的连接的名称。选择连接到 GitLab。
-
显示 GitLab 的登录页面时,使用您的凭证登录,然后选择登录。
-
如果这是您首次为连接授权,则会显示一个授权页面,其中包含一条消息,请求授权该连接以访问您的 GitLab 账户。
选择授权。
-
浏览器返回到连接控制台页面。在GitLab 连接设置下,连接名称中会显示新的连接。
-
选择连接。
成功创建 GitLab 连接后,顶部会显示成功横幅。
-
在创建构建项目页面的默认连接或自定义连接下拉列表中,确保列出了您的连接 ARN。如果未列出,请点击刷新按钮以使其显示。
-
在存储库中,通过指定带命名空间的项目路径,选择 GitLab 中您的项目的名称。例如,对于组级存储库,请按以下格式输入存储库名称:
group-name/repository-name
。有关路径和命名空间的更多信息,请参阅 https://docs.gitlab.com/ee/api/projects.html#get-single-project中的 path_with_namespace
字段。有关 GitLab 中命名空间的更多信息,请参阅 https://docs.gitlab.com/ee/user/namespace/。 注意
对于 GitLab 中的组,必须手动指定带命名空间的项目路径。例如,对于组
mygroup
中名为myrepo
的存储库,请输入以下内容:mygroup/myrepo
。您可以在 GitLab 的 URL 中找到带命名空间的项目路径。 -
在源版本 - 可选中,输入拉取请求 ID、分支、提交 ID、标签或引用以及提交 ID。有关更多信息,请参阅 使用 AWS CodeBuild 的源版本示例。
注意
我们建议您选择看起来不像提交 ID 的 Git 分支名称,例如
811dd1ba1aba14473856cee38308caed7190c0d
或5392f7
。这可以帮助您避免 Git 签出与实际提交发生冲突。 -
在 Git 克隆深度 - 可选中,可以创建一个浅克隆,其历史记录会截断至指定数量的提交。如果您需要完整克隆,请选择完整。
-
在构建状态 - 可选中,如果您希望向源提供商报告构建的开始和完成状态,请选择在构建开始和完成时向源提供商报告构建状态。
为了能够向源提供商报告构建状态,与源提供商关联的用户必须拥有对存储库的写入权限。如果用户没有写入权限,则无法更新构建状态。有关更多信息,请参阅 源提供商访问权限。
创建到 GitLab 的连接(CLI)
您可以使用 AWS Command Line Interface(AWS CLI)创建连接。
为此,请使用 create-connection 命令。
重要
默认情况下,通过 AWS CLI 或 AWS CloudFormation 创建的连接处于 PENDING
状态。使用 CLI 或 AWS CloudFormation 创建一个连接后,可使用控制台编辑该连接以使其状态为 AVAILABLE
。
创建连接
-
按照《开发人员工具控制台用户指南》中的说明来创建与 GitLab 的连接(CLI)。