As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conexões do Bitbucket Cloud
<a name="connections-bitbucket"></a>

As conexões permitem que você autorize e estabeleça configurações que associem seu provedor terceirizado aos seus AWS recursos. Para associar seu repositório de terceiros como origem do pipeline, use uma conexão. 

**nota**  
Em vez de criar ou usar uma conexão existente na conta, você pode usar uma conexão compartilhada entre outra Conta da AWS. Consulte [Usar uma conexão compartilhada com outra conta](connections-shared.md).

**nota**  
Esse recurso não está disponível nas regiões Ásia-Pacífico (Hong Kong), Ásia-Pacífico (Hyderabad), Ásia-Pacífico (Jacarta), Ásia-Pacífico (Melbourne), Ásia-Pacífico (Osaka), África (Cidade do Cabo), Oriente Médio (Bahrein), Oriente Médio (EAU), Europa (Espanha), Europa (Zurique), Israel (Tel Aviv) ou (Oeste dos EUA). AWS GovCloud Para fazer referência a outras ações disponíveis, consulte [Integrações de produtos e serviços com CodePipeline](integrations.md). Para considerações sobre essa ação na região Europa (Milão), consulte a nota em [CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com e ações GitLab autogerenciadas](action-reference-CodestarConnectionSource.md).

Para adicionar uma ação de origem do Bitbucket Cloud CodePipeline, você pode escolher entre: 
+ Use o assistente de **criação de pipeline** do CodePipeline console ou a página **Editar ação** para escolher a opção **de provedor do Bitbucket**. Consulte [Criar uma conexão com o Bitbucket Cloud (console)](#connections-bitbucket-console) para adicionar a ação. O console ajuda você a criar um recurso de conexão.
**nota**  
Você pode criar conexões para um repositório do Bitbucket Cloud. Não há suporte a tipos de provedores instalados do Bitbucket, como o Bitbucket Server. 
+ Usar a CLI para adicionar a configuração da ação `CreateSourceConnection` com o provedor `Bitbucket`:
  + Para criar seus recursos de conexão, consulte [Criar uma conexão com o Bitbucket Cloud (CLI)](#connections-bitbucket-cli) para criar um recurso de conexão com a CLI.
  + Use o exemplo de configuração da ação `CreateSourceConnection` em [CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com e ações GitLab autogerenciadas](action-reference-CodestarConnectionSource.md) para adicionar sua ação, conforme mostrado em [Criar um pipeline (CLI)](pipelines-create.md#pipelines-create-cli).

**nota**  
É possível criar uma conexão por meio do console do Developer Tools em **Configurações**. Consulte [Criar uma conexão](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).

Antes de começar
+ Você deve ter criado uma conta com o provedor do repositório de terceiros, como o Bitbucket Cloud.
+ Você já deve ter criado um repositório de código de terceiros, como um repositório do Bitbucket Cloud.

**nota**  
As conexões do Bitbucket Cloud fornecem acesso somente aos repositórios pertencentes à conta do Bitbucket Cloud usada para criar a conexão.  
Se a aplicação estiver sendo instalada em um espaço de trabalho do Bitbucket Cloud, você precisará de permissões para **Administrar o espaço de trabalho**. Caso contrário, a opção de instalar a aplicação não será exibida.

**Topics**
+ [Criar uma conexão com o Bitbucket Cloud (console)](#connections-bitbucket-console)
+ [Criar uma conexão com o Bitbucket Cloud (CLI)](#connections-bitbucket-cli)

## Criar uma conexão com o Bitbucket Cloud (console)
<a name="connections-bitbucket-console"></a>

Use essas etapas para usar o CodePipeline console para adicionar uma ação de conexões ao seu repositório Bitbucket.

**nota**  
Você pode criar conexões para um repositório do Bitbucket Cloud. Não há suporte a tipos de provedores instalados do Bitbucket, como o Bitbucket Server. 

### Etapa 1: Criar ou editar seu pipeline
<a name="connections-bitbucket-console-action"></a>

**Para criar ou editar seu pipeline**

1. Faça login no CodePipeline console.

1. Escolha uma das opções a seguir.
   + Opte por criar um pipeline. Siga as etapas em *Criar um pipeline* para concluir a primeira tela e escolha **Próximo**. Na página **Origem**, em **Provedor de origem**, escolha **Bitbucket**.
   + Opte por editar um pipeline existente. Escolha **Editar** e, em seguida, escolha **Editar estágio**. Escolha adicionar ou editar sua ação de origem. Na página **Editar ação**, em **Nome da ação**, insira um nome para a ação. Em **Provedor de ação**, selecione **Bitbucket**.

1. Execute um destes procedimentos:
   + Em **Conexão**, se você ainda não criou uma conexão com seu provedor, escolha **Conectar ao Bitbucket**. Vá para a Etapa 2: Criar uma conexão com o Bitbucket.
   + Em **Conexão**, se você ainda não criou uma conexão com seu provedor, escolha a conexão. Vá para a Etapa 3: Salve a ação de origem para sua conexão.

### Etapa 2: Criar uma conexão com o Bitbucket Cloud
<a name="connections-bitbucket-console-create"></a>

**Para criar uma conexão com o Bitbucket Cloud**

1. Na página de configurações **Conectar ao Bitbucket**, insira o nome da sua conexão e escolha **Conectar ao Bitbucket**.  
![\[Captura de tela do console mostrando o botão Conectar ao Bitbucket.\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/create-connection-bitbucket.png)

   O campo **Aplicativos Bitbucket** é exibido.

1. Em **Bitbucket apps** (Aplicações do Bitbucket), escolha uma instalação de aplicação ou **Install a new app** (Instalar uma nova aplicação) para criar uma.
**nota**  
O aplicativo é instalado apenas uma vez para cada espaço de trabalho ou conta do Bitbucket. Se você já instalou o aplicativo Bitbucket, escolha-o e vá para a etapa 4.  
![\[Captura de tela do console mostrando a caixa de diálogo Conectar ao Bitbucket Cloud, com o botão de instalação de novo aplicativo.\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/newreview-source-wizard-bitbucket.png)

1. Se a página de login do Bitbucket Cloud for exibida, faça login com suas credenciais e escolha a opção de continuar.

1. Na página de instalação do aplicativo, uma mensagem mostra que o AWS CodeStar aplicativo está tentando se conectar à sua conta do Bitbucket. 

   Se você estiver usando um espaço de trabalho do Bitbucket, altere a opção **Authorize for** (Autorizar para) do espaço de trabalho. Somente os espaços de trabalho nos quais você tem acesso de administrador serão exibidos.

   Escolha **Conceder acesso**.

1. Em **Bitbucket apps** (Aplicações do Bitbucket), o ID de conexão para a nova instalação é exibido. Selecione **Conectar**. A conexão criada é exibida na lista de conexões.  
![\[Captura de tela do console mostrando a solicitação de acesso\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/create-connection-bitbucket-app-ID.png)

### Etapa 3: Salvar a ação de origem do Bitbucket Cloud
<a name="connections-bitbucket-console-save"></a>

Execute estas etapas no assistente ou na página **Editar ação** para salvar a ação de origem com as informações de conexão.

**Para concluir e salvar a ação de origem com a conexão**

1. Em **Repository name (Nome do repositório)**, escolha o nome do repositório de terceiros.

1. Em **Gatilhos do Pipeline**, você pode adicionar gatilhos se sua ação for uma ação. CodeConnections Para definir a configuração de gatilhos do pipeline e, se necessário, aplicar filtros, consulte mais detalhes em [Adicionar gatilho com tipos de eventos code push ou pull request](pipelines-filter.md).

1. Em **Output artifact format (Formato de artefato de saída)**, você deve escolher o formato para seus artefatos. 
   + **Para armazenar artefatos de saída da ação do Bitbucket Cloud usando o método padrão, escolha CodePipeline default.** A ação acessa os arquivos do repositório do Bitbucket Cloud e armazena os artefatos em um arquivo ZIP no armazenamento de artefatos do pipeline.
   + Para armazenar um arquivo JSON que contém uma referência de URL ao repositório para que as ações downstream possam executar comandos Git diretamente, escolha **Full clone (Clone completo)**. Essa opção só pode ser usada por ações CodeBuild posteriores.

     Se você escolher essa opção, precisará atualizar as permissões para sua função de serviço CodeBuild do projeto, conforme mostrado em[Adicione CodeBuild GitClone permissões para conexões com o Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab](troubleshooting.md#codebuild-role-connections).

1. Escolha **Próximo** no assistente ou **Salvar** na página **Editar ação**.

## Criar uma conexão com o Bitbucket Cloud (CLI)
<a name="connections-bitbucket-cli"></a>

Você pode usar o AWS Command Line Interface (AWS CLI) para criar uma conexão. 

**nota**  
Você pode criar conexões para um repositório do Bitbucket Cloud. Não há suporte a tipos de provedores instalados do Bitbucket, como o Bitbucket Server. 

Para fazer isso, use o comando **create-connection**. 

**Importante**  
Uma conexão criada por meio do AWS CLI ou AWS CloudFormation está no `PENDING` status por padrão. Depois de criar uma conexão com a CLI ou CloudFormation, use o console para editar a conexão e definir seu status. `AVAILABLE`

**Para criar uma conexão**

1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use o AWS CLI para executar o **create-connection** comando, especificando `--provider-type` e `--connection-name` para sua conexão. Neste exemplo, o nome do provedor de terceiros é `Bitbucket` e o nome da conexão especificada é `MyConnection`.

   ```
   aws codestar-connections create-connection --provider-type Bitbucket --connection-name MyConnection
   ```

   Se tiver êxito, esse comando gerará as informações do ARN de conexão semelhantes às seguintes.

   ```
   {
       "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }
   ```

1. Use o console para concluir a conexão. Para obter mais informações, consulte [Atualizar uma conexão pendente](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html).

1. O pipeline assume como padrão a detecção de alterações ao enviar o código por push ao repositório de origem da conexão. Para definir a configuração do gatilho do pipeline para liberação manual ou para tags Git, execute um dos seguintes procedimentos:
   + Para definir a configuração do gatilho do pipeline para início somente por meio de liberação manual, adicione a seguinte linha à configuração: 

     ```
     "DetectChanges": "false",
     ```
   + Para definir a configuração de gatilhos do pipeline e aplicar filtros, consulte mais detalhes em [Adicionar gatilho com tipos de eventos code push ou pull request](pipelines-filter.md). Por exemplo, o trecho a seguir adiciona etiquetas Git ao nível do pipeline dentro da definição JSON do pipeline. Neste exemplo, `release-v0` e `release-v1` são as tags Git a serem incluídas, enquanto `release-v2` são as tags Git a serem excluídas.

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