创建到 Bitbucket Cloud 的连接（控制台）创建到 Bitbucket Cloud 的连接 (CLI)

Bitbucket Cloud 连接

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

注意

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

要在中添加 Bitbucket Cloud 源操作 CodePipeline，您可以选择以下任一选项：

使用 CodePipeline 控制台的 “创建管道” 向导或 “编辑” 操作页面选择 Bitbucket 提供程序选项。参阅创建到 Bitbucket Cloud 的连接（控制台）以添加操作。控制台可帮助您创建连接资源。

注意
您可以创建到 Bitbucket Cloud 存储库的连接。不支持已安装的 Bitbucket 提供程序类型（如 Bitbucket 服务器）。
使用 CLI，添加提供方为 Bitbucket 的 CreateSourceConnection 操作的操作配置，如下所示：
- 要创建连接资源，请参阅创建到 Bitbucket Cloud 的连接 (CLI)，以便使用 CLI 创建连接资源。
- 使用CodeStarSourceConnection 适用于 Bitbucket Cloud GitHub、、 GitHub 企业服务器、 GitLab .com 和 GitLab 自我管理操作中的 CreateSourceConnection 示例操作配置来添加操作，如创建管道（CLI）中所示。

注意

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

开始前的准备工作：

您必须已创建第三方存储库提供方（如 Bitbucket Cloud）的账户。
您必须事先创建第三方代码存储库，如 Bitbucket Cloud 存储库。

注意

Bitbucket Cloud 连接只能访问用于创建连接的 Bitbucket Cloud 账户所拥有的存储库。

如果要将应用程序安装在 Bitbucket Cloud 工作区中，则需要管理工作区权限。否则，安装应用程序的选项将不会显示。

创建到 Bitbucket Cloud 的连接（控制台）

使用这些步骤使用 CodePipeline 控制台为您的 Bitbucket 存储库添加连接操作。

注意

您可以创建到 Bitbucket Cloud 存储库的连接。不支持已安装的 Bitbucket 提供程序类型（如 Bitbucket 服务器）。

步骤 1：创建或编辑您的管道

创建或编辑您的管道

登录 CodePipeline 控制台。
选择以下选项之一。
- 选择创建管道。按照创建管道 中的步骤操作，完成第一个屏幕，然后选择下一步。在源页面的源提供程序下，选择 Bitbucket。
- 选择编辑现有管道。选择编辑，然后选择编辑阶段。选择添加或编辑您的源操作。在编辑操作页面的操作名称下，输入您的操作的名称。在操作提供程序中，选择 Bitbucket。
请执行以下操作之一：
- 在连接下，如果您尚未创建到提供程序的连接，请选择连接到 Bitbucket。继续执行步骤 2：创建到 Bitbucket 的连接。
- 在连接下，如果您已创建到提供程序的连接，请选择该连接。继续执行步骤 3：保存连接的源操作。

步骤 2：创建到 Bitbucket Cloud 的连接

创建到 Bitbucket Cloud 的连接

在连接到 Bitbucket 设置页面上，输入您的连接名称，然后选择连接到 Bitbucket。

此时将出现 Bitbucket 应用程序字段。
在 Bitbucket 应用程序下，选择一个应用程序安装，或者选择安装新应用程序来创建一个应用程序安装。

注意
您只需为每个 Bitbucket 工作区或账户安装一次该应用。如果已经安装 Bitbucket 应用，请选择它，然后移至步骤 4。
如果显示 Bitbucket Cloud 的登录页面，请使用您的凭证登录，然后选择继续。
在应用程序安装页面上，一条消息显示该 AWS CodeStar 应用程序正在尝试连接到您的 Bitbucket 帐户。

如果您使用的是 Bitbucket 工作区，请更改工作区的 Authorize for（授权）选项。只有您拥有管理员访问权限的工作区才会显示。

选择授予访问权限。
在 Bitbucket 应用程序中，将显示新安装的连接 ID。选择连接。创建的连接将显示在连接列表中。

步骤 3：保存您的 Bitbucket Cloud 源操作

使用向导或编辑操作页面上的这些步骤，将源操作与连接信息一起保存。

完成并保存您的源操作和连接

在存储库名称中，选择第三方存储库的名称。
如果您的操作是操作，则可以在 Pip elin e 触发器下添加触发器。 CodeConnections 要配置管道触发器配置并选择使用触发器进行筛选，请在中查看更多详细信息筛选代码推送或拉取请求的触发器。
在输出构件格式中，您必须为构件选择格式。
- 要使用默认方法存储 Bitbucket Cloud 操作的输出项目，请选择CodePipeline 默认。操作会访问 Bitbucket Cloud 存储库中的文件，并将构件以 ZIP 文件格式存储在管道构件存储中。
- 要存储包含存储库的 URL 引用的 JSON 文件，以便下游操作可以直接执行 Git 命令，请选择完全克隆。此选项只能由 CodeBuild 下游操作使用。
  
  如果选择此选项，则需要更新 CodeBuild 项目服务角色的权限，如所示添加连接 Bitbucket、 GitHub、En GitHub terprise Server 或 GitLab .com 的 CodeBuild GitClone 权限。
在向导上选择下一步，或者在编辑操作页面上选择保存。

创建到 Bitbucket Cloud 的连接 (CLI)

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

注意

您可以创建到 Bitbucket Cloud 存储库的连接。不支持已安装的 Bitbucket 提供程序类型（如 Bitbucket 服务器）。

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

重要

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

创建连接

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

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

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

要将管道触发器配置配置配置为使用触发器进行筛选，请在中查看更多详细信息筛选代码推送或拉取请求的触发器。例如，以下内容将 Git 标签添加到管道 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。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

为 Amazon S3 来源创建 EventBridge 规则（AWS CloudFormation 模板）

CodeCommit 源操作和 EventBridge