Conexões Bitbucket - AWS CodePipeline

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 Bitbucket

As conexões permitem que você autorize e estabeleça configurações que associam seu provedor terceirizado ao seuAWSrecursos da AWS. Para associar seu repositório de terceiros como fonte para o pipeline, você usa uma conexão.

nota

Este recurso não está disponível na região Ásia-Pacífico (Hong Kong) ou Europa (Milão). Para usar outras ações de origem disponíveis nessa região, consulteIntegrações de ações de origem.

Para adicionar uma ação de origem do Bitbucket Cloud no CodePipeline, você pode optar por:

nota

Você também pode criar uma conexão usando o console Developer Tools emConfigurações. ConsulteCriar uma conexão.

Antes de começar:

  • Você deve ter criado uma conta com o provedor do repositório de terceiros, como o Bitbucket.

  • Você já deve ter criado um repositório de código de terceiros, como um repositório Bitbucket.

nota

As conexões Bitbucket fornecem acesso somente a repositórios de propriedade da conta Bitbucket usada para criar a conexão.

Criar uma conexão com o Bitbucket (console)

Use estas etapas para usar o console do CodePipeline para adicionar uma ação de conexões ao 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: Crie ou edite seu pipeline

Para criar ou editar seu pipeline

  1. Faça login no console do CodePipeline.

  2. Escolha uma das seguintes opções.

    • Escolha criar um pipeline. Siga as etapas emCriar um pipelinepara completar a primeira tela e escolherPróximo. NoOrigempágina, emProvedor de origem, escolhaBitbucket.

      
                                    Captura de tela do console mostrando a caixa de diálogo Adicionar etapa de origem com Bitbucket escolhido como o provedor de origem.
      
                                    Captura de tela do console mostrando a caixa de diálogo Adicionar etapa de origem com Bitbucket Cloud escolhido como o provedor de origem.
    • Escolha editar um pipeline existente. SelecioneEditeE, depois, escolhaEdit stage. Escolha adicionar ou editar sua ação de origem. NoEditar açãopágina, emAction name (Nome da ação), insira o nome da ação. DentroProvedor de ação, escolhaBitbucket.

  3. Execute um destes procedimentos:

    • UNDERConexão doSe você ainda não tiver criado uma conexão com o provedor, escolhaConectar-se ao Bitbucket. Prossiga para a Etapa 2: Crie uma conexão com o Bitbucket.

    • UNDERConexão do, se você já criou uma conexão com seu provedor, escolha a conexão. Prossiga para a Etapa 3: Salve a ação de origem para sua conexão.

Etapa 2: Criar uma conexão com o Bitbucket

Para criar uma conexão com o Bitbucket

  1. NoConectar-se ao Bitbucketpágina de configurações, insira o nome da conexão e escolhaConectar-se ao Bitbucket.

    
                            Captura de tela do console mostrando o botão Connect ao Bitbucket.

    OAplicativos Bitbucketcampo é 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

    Você instala uma aplicação para todas as suas conexões com um provedor específico. 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 Connect to Bitbucket (Conectar ao Bitbucket) com o botão de instalação de nova aplicação.
  3. Se a página de login do Bitbucket for exibida, faça login com suas credenciais e escolha a opção de continuar.

  4. Na página de instalação da aplicação, uma mensagem mostra que a aplicação AWS CodeStar está tentando se conectar à sua conta do Bitbucket. Escolha Grant access (Conceder acesso).

    
                            Captura de tela do console mostrando a solicitação de 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: Salve sua ação de origem do Bitbucket

Use estas etapas no assistente ouEditar açãopara salvar sua ação de origem com as informações de conexão.

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

  1. Em Repository name (Nome do repositório), escolha o nome do repositório de terceiros. Em Branch name (Nome da ramificação), escolha a ramificação onde deseja que o pipeline detecte alterações de origem.

  2. 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 usando o método padrão, escolha CodePipeline default (Padrão CodePipeline). A ação acessa os arquivos do repositório Bitbucket 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 para a função de serviço do projeto CodeBuild, conforme mostrado emAdicione permissões do GitClone do CodeBuild para conexões com o Bitbucket, GitHub ou GitHub Enterprise Server.

  3. SelecionePróximoNo assistente ouSalvarnoEditar ação.

Criar uma conexão com o Bitbucket (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, consulteAtualizar uma conexão pendente.