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

# Bitbucket 应用程序连接
<a name="connections-bitbucket-app"></a>

你可以使用 Bitbucket 进行连接。 CodeBuild通过 [Amazon CodeConnections](https://docs.amazonaws.cn/dtconsole/latest/userguide/welcome-connections.html) 支持 Bitbucket 应用程序连接。

**注意**  
CodeConnections 在少于. 的地区可用 CodeBuild。您可以在中使用跨区域连接。 CodeBuild在选择加入区域创建的连接不能在其他区域中使用。有关更多信息，请参阅 [Amazon CodeConnections 终端节点和限额](https://docs.amazonaws.cn/general/latest/gr/codestar_connections.html)。

**Topics**
+ [步骤 1：创建到 Bitbucket 的连接（控制台）](#connections-bitbucket-console)
+ [步骤 2：向 CodeBuild 项目 IAM 角色授予使用连接的访问权限](#connections-bitbucket-role-access)
+ [步骤 3：配置 CodeBuild 为使用新连接](#connections-bitbucket-account-credential)

## 步骤 1：创建到 Bitbucket 的连接（控制台）
<a name="connections-bitbucket-console"></a>

使用以下步骤使用 CodeBuild 控制台在 Bitbucket 中为您的项目添加连接。

**要创建到 Bitbucket 的连接**
+ 按照《开发人员工具用户指南》**中的说明来[创建与 Bitbucket 的连接](https://docs.amazonaws.cn/dtconsole/latest/userguide/connections-create-bitbucket.html)。

**注意**  
您可以使用其他账户共享的连接，而不是创建或使用 Amazon 账户中的现有连接。有关更多信息，请参阅[与 Amazon 账户共享连接](https://docs.amazonaws.cn/dtconsole/latest/userguide/connections-share.html)。

## 步骤 2：向 CodeBuild 项目 IAM 角色授予使用连接的访问权限
<a name="connections-bitbucket-role-access"></a>

您可以向 CodeBuild 项目 IAM 角色授予使用您的连接出售的 Bitbucket 令牌的访问权限。

**授予 CodeBuild 项目 IAM 角色访问权限**

1. 按照项目的说明为您的 CodeBuild 项目创建 IAM 角色。[CodeBuild 允许与其他 Amazon 服务进行交互](setting-up-service-role.md) CodeBuild 

1. 按照说明进行操作时，将以下 IAM 策略添加到您的 CodeBuild 项目角色以授予对连接的访问权限。

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "codeconnections:GetConnectionToken",
                   "codeconnections:GetConnection"
               ],
               "Resource": [
                   "arn:aws:iam::*:role/Service*"
               ]
           }
       ]
   }
   ```

------

## 步骤 3：配置 CodeBuild 为使用新连接
<a name="connections-bitbucket-account-credential"></a>

您可以将连接配置为账户级别凭证，并在项目中使用。

------
#### [ Amazon Web Services 管理控制台 ]

**要将连接配置为账户级别的凭证，请参阅 Amazon Web Services 管理控制台**

1. 对于**源提供商**，选择 **Bitbucket**。

1. 对于**凭证**，执行以下操作之一：
   + 选择**默认来源凭证**，使用您账户的默认来源凭证应用于所有项目。

     1. 如果未连接到 Bitbucket，请选择**管理默认来源凭证**。

     1. 对于**凭证类型**，选择**CodeConnections**。

     1. 在**连接**中，选择使用现有连接或创建新连接。
   + 选择**自定义来源凭证**，以便使用自定义来源凭证来覆盖您账户的默认设置。

     1. 对于**凭证类型**，选择**CodeConnections**。

     1. 在**连接**中，选择使用现有连接或创建新连接。

------
#### [ Amazon CLI ]

**要将连接配置为账户级别的凭证，请参阅 Amazon CLI**
+ 打开终端（Linux、macOS 或 Unix）或命令提示符（Windows）。 Amazon CLI 使用运行**import-source-credentials**命令，`--token`为您的连接指定`--auth-type``--server-type`、和。

  使用以下命令：

  ```
  aws codebuild import-source-credentials --auth-type CODECONNECTIONS --server-type BITBUCKET --token <connection-arn>
  ```

------

有关在 CodeBuild 项目中设置多个令牌的更多信息，请参阅[将多个令牌配置为源级别凭证](multiple-access-tokens.md#asm-source-credential)。