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)

Conexões do Bitbucket Cloud

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

nota

Este atributo não está disponível na região Á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 AWS GovCloud (Oeste dos EUA). Para fazer referência a outras ações disponíveis, consulte Integrações de produtos e serviços com o CodePipeline. Para considerações sobre essa ação na região Europa (Milão), consulte a nota em CodeStarSourceConnection para ações gerenciadas do Bitbucket Cloud, do GitHub, do GitHub Enterprise Server, do GitLab.com e do GitLab.

Para adicionar uma ação de origem do Bitbucket Cloud no CodePipeline, você pode optar 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)

Execute estas etapas para usar o console do CodePipeline para adicionar uma ação de conexão ao seu repositório do 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 console do CodePipeline.

  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, selecione 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 aplicativo do AWS CodeStar 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. Na seção Gatilhos do pipeline, é possível configurar gatilhos caso a ação seja do CodeConnections. Para definir a configuração de gatilhos do pipeline e, se necessário, aplicar filtros, consulte mais detalhes em Filtrar gatilhos em push de código ou solicitações pull.

  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 a partir da ação do Bitbucket Cloud usando o método padrão, escolha CodePipeline padrão. 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). Esta opção só pode ser usada por ações downstream do CodeBuild.

      Se você escolher essa opção, precisará atualizar as permissões do perfil de serviço do projeto CodeBuild, conforme mostrado em Adicione permissões do CodeBuild GitClone para conexões com o Bitbucket, o GitHub, o GitHub Enterprise Server ou o GitLab.com.

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

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

É possível usar a 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 da AWS CLI ou do AWS CloudFormation permanece no status PENDING por padrão. Depois de criar uma conexão com a CLI ou o AWS CloudFormation, use o console para editar a conexão e tornar seu status AVAILABLE.

Como criar uma conexão

  1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use a AWS CLI para executar o comando create-connection, especificando o --provider-type e o --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 definir a configuração de gatilhos do pipeline e aplicar filtros, consulte mais detalhes em Filtrar gatilhos em push de código ou solicitações pull. 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"
                                ]
                            }
                        }
                    ]
                }
            }
        ]