Conexões do Bitbucket Cloud - AWS CodePipeline
Criar uma conexão com o Bitbucket Cloud (console)Criar uma conexão com o Bitbucket Cloud (CLI)

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

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

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. 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.

Para adicionar uma ação de origem do Bitbucket Cloud CodePipeline, você pode escolher entre:

nota

É possível criar uma conexão por meio do console do Developer Tools em Configurações. Consulte Criar uma conexão.

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.

Criar uma conexão com o Bitbucket Cloud (console)

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

Para criar ou editar seu pipeline

  1. Faça login no CodePipeline console.

  2. Escolha uma das seguintes opções.

    • 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, escolha Bitbucket.

  3. 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

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.

    O campo Aplicativos Bitbucket é exibido.

  2. 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.

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

  4. 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.

  5. 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

Etapa 3: Salvar a ação de origem do Bitbucket Cloud

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.

  2. Em Gatilhos do Pipeline, você pode adicionar gatilhos se sua ação for uma ação. CodeConnections Para configurar a configuração do gatilho do pipeline e, opcionalmente, filtrar com gatilhos, veja mais detalhes em. Filtrar gatilhos em solicitações push ou pull de código

  3. 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 emAdicione CodeBuild GitClone permissões para conexões com o Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab.

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

Criar uma conexão com o Bitbucket Cloud (CLI)

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 AWS CloudFormation, use o console para editar a conexão e definir seu status. AVAILABLE

Como 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"
}

  2. Use o console para concluir a conexão. Para obter mais informações, consulte Atualizar uma conexão pendente.

  3. 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 configurar a configuração do gatilho do pipeline para filtrar com gatilhos, veja mais detalhes em. Filtrar gatilhos em solicitações push ou pull de código Por exemplo, o seguinte adiciona tags Git ao nível do pipeline 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"
                                ]
                            }
                        }
                    ]
                }
            }
        ]