创建到 GitLab.com （控制台）的连接创建到 GitLab.com (CLI) 的连接

GitLab.com 连接

连接允许您授权和建立将第三方提供商与 AWS 资源关联的配置。要将您的第三方存储库关联为管道的源，您应使用连接。

注意

不用再创建连接或使用账户中的现有链接，您可以使用其他 AWS 账户之间的共享连接。请参阅使用与其他账户共享的连接。

注意

此功能在亚太地区（香港）、亚太地区（海得拉巴）、亚太地区（雅加达）、亚太地区（墨尔本）、亚太地区（大阪）、非洲（开普敦）、中东（巴林）、中东（阿联酋）、欧洲（西班牙）、欧洲（苏黎世）、以色列（特拉维夫）或 AWS GovCloud （US-West）区域不可用。要参考其他可用操作，请参阅与的产品和服务集成 CodePipeline。有关在欧洲地区（米兰）区域使用此操作的注意事项，请参阅CodeStarSourceConnection 用于 Bitbucket Cloud GitHub GitLab.com、 GitHub 企业服务器和 GitLab 自我管理的操作中的说明。

要在中添加 GitLab.com 源操作 CodePipeline，您可以选择：

使用 CodePipeline 控制台 “创建管道” 向导或 “编辑” 操作页面选择GitLab提供商选项。参阅创建到 GitLab.com （控制台）的连接以添加操作。控制台可帮助您创建连接资源。
使用 CLI，添加提供方为 GitLab 的 CreateSourceConnection 操作的操作配置，如下所示：
- 要创建连接资源，请参阅创建到 GitLab.com (CLI) 的连接，以便使用 CLI 创建连接资源。
- 使用CodeStarSourceConnection 用于 Bitbucket Cloud GitHub GitLab.com、 GitHub 企业服务器和 GitLab 自我管理的操作中的 CreateSourceConnection 示例操作配置来添加操作，如创建管道（CLI）中所示。

注意

您也可以使用开发人员工具控制台，在设置下创建连接。参阅创建连接。

注意

通过在中授权安装此连接 GitLab.com，即表示您授予我们的服务权限，允许通过访问您的帐户来处理您的数据，并且您可以随时通过卸载应用程序来撤消这些权限。

开始前的准备工作：

您必须已经使用创建了一个帐户 GitLab.com。

注意
连接只能访问用于创建并授权连接的账户所拥有的存储库。

注意
您可以创建与具有所有者角色的存储库的连接 GitLab，然后可以将该连接与包含资源的存储库一起使用，例如 CodePipeline。对于群组中的仓库，您无需成为群组拥有者。
要为您的管道指定一个源，必须事先在 gitlab.com 上创建存储库。

创建到 GitLab.com （控制台）的连接

使用这些步骤使用 CodePipeline 控制台为您的项目（存储库）添加连接操作 GitLab。

创建或编辑您的管道

登录 CodePipeline 控制台。
选择下列选项之一。
- 选择创建管道。按照创建管道 中的步骤操作，完成第一个屏幕，然后选择下一步。在 “来源” 页面的 “来源提供商” 下，选择GitLab。
- 选择编辑现有管道。选择编辑，然后选择编辑阶段。选择添加或编辑您的源操作。在编辑操作页面的操作名称下，输入您的操作的名称。对于操作提供程序，选择 GitLab。
请执行以下操作之一：
- 在 “连接” 下，如果您尚未创建与提供商的连接，请选择 “连接到” GitLab 。继续执行步骤 4，以便创建连接。
- 在连接下，如果您已创建到提供程序的连接，请选择该连接。继续执行步骤 9。
注意
如果在创建 GitLab.com 连接之前关闭了弹出窗口，则需要刷新页面。
要创建与 GitLab.com 存储库的连接，请在选择提供商下选择GitLab。在连接名称中，输入要创建的连接的名称。选择 “连接到” GitLab 。
当 GitLab.com 显示登录页面时，使用您的凭据登录，然后选择登录。
如果这是您第一次授权连接，则会显示一个授权页面，其中包含一条消息，请求授权该连接访问您的 GitLab.com 帐户。

选择授权。
浏览器返回到连接控制台页面。在 “创建 GitLab 连接” 下，新连接显示在 “连接名称” 中。
选择 “连接到” GitLab 。

您将返回到 CodePipeline 控制台。

注意
成功创建 GitLab.com 连接后，成功横幅将显示在主窗口上。
如果您之前没有登录到 GitLab 当前计算机，则需要手动关闭弹出窗口。
在存储库名称中， GitLab 通过使用命名空间指定项目路径来选择您的项目名称。例如，对于组级存储库，请按以下格式输入存储库名称：group-name/repository-name。有关路径和命名空间的更多信息，请参阅 https://docs.gitlab.com/ee/api/projects.html #get-single-p path_with_namespace roject 中的字段。有关中的命名空间的更多信息 GitLab，请参阅https://docs.gitlab.com/ee/user/namespace/。

注意
对于中的群组 GitLab，必须使用命名空间手动指定项目路径。例如，对于组 mygroup 中名为 myrepo 的存储库，请输入以下内容：mygroup/myrepo。您可以在的 URL 中找到带有命名空间的项目路径 GitLab。
如果您的操作是操作，则可以在 “管道触发器” 下添加触发器。 CodeConnections 要配置管道触发器配置并选择性使用触发器进行筛选，请参阅添加带有代码推送或拉取请求事件类型的触发器中的更多详细信息。
在分支名称中，选择您希望管道在其中检测源更改的分支。

注意
如果未自动填充分支名称，说明您没有存储库的所有者访问权限。项目名称无效，或者使用的连接无权访问 project/repository.
在输出构件格式中，您必须为构件选择格式。
- 要使用默认方法存储 GitLab.com 操作的输出对象，请选择CodePipeline 默认。该操作访问存储库中的文件，并将构件 GitLab.com 存储在管道对象存储区的 ZIP 文件中。
- 要存储包含存储库的 URL 引用的 JSON 文件，以便下游操作可以直接执行 Git 命令，请选择完全克隆。此选项只能由 CodeBuild 下游操作使用。
  
  如果选择此选项，则需要更新 CodeBuild 项目服务角色的权限，如中所示添加 CodeBuild GitClone 连接到 Bitbucket GitHub、 GitHub 企业服务器或 GitLab.com。如需查看教程以了解如何使用完整克隆选项，请参阅教程：使用带有 GitHub 管道源的完整克隆。
选择保存源操作并继续。

创建到 GitLab.com (CLI) 的连接

你可以使用 AWS Command Line Interface (AWS CLI) 来创建连接。

为此，请使用 create-connection 命令。

重要

默认情况下，通过 AWS CLI 或创建的连接 AWS CloudFormation 处于PENDING状态。使用 CLI 创建连接后 CloudFormation，或使用控制台编辑连接以使其处于状态AVAILABLE。

创建连接

打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。使用运行create-connection命令，--connection-name为您的连接指定--provider-type和。 AWS CLI 在此示例中，第三方提供方名称为 GitLab，指定的连接名称为 MyConnection。
```
aws codestar-connections create-connection --provider-type GitLab --connection-name MyConnection
```
如果成功，该命令将返回类似以下内容的连接 ARN 信息。
```
{
    "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
使用控制台完成连接。有关更多信息，请参阅更新挂起的连接。

管道默认会在向连接源存储库推送代码时检测更改。要配置手动发布或 Git 标签管道触发器配置，请执行以下操作之一：

要将管道触发器配置为仅通过手动发布启动，请在配置中添加以下行：
```
"DetectChanges": "false",
```

要配置管道触发器配置以使用触发器进行筛选，请参阅添加带有代码推送或拉取请求事件类型的触发器中的更多详细信息。例如，以下内容添加到管道 JSON 定义的管道级别。在此示例中，release-v0 和 release-v1 是要包含的 Git 标签，release-v2 是要排除的 Git 标签。


"triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "tags": {
                                "includes": [
                                    "release-v0", "release-v1"
                                ],
                                "excludes": [
                                    "release-v2"
                                ]
                            }
                        }
                    ]
                }
            }
        ]

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

GitHub 企业服务器连接

用于 GitLab 自我管理的连接