Criar repositórios com o Bitbucket Cloud

O Cloud Build permite criar gatilhos para compilação a partir de repositórios hospedados no Bitbucket Cloud, permitindo que você execute builds em resposta a eventos como envios de confirmação ou solicitações de mesclagem associados ao seu repositório do Bitbucket Cloud.

Nesta página, explicamos como ativar a funcionalidade do acionador em uma instância do Cloud Bitbucket. Saiba mais sobre gatilhos do Cloud Build e repositórios do Cloud Build.

Antes de começar

  • Ative as APIs Cloud Build and Secret Manager.

    Ative as APIs

Crie um gatilho do Bitbucket Cloud

Crie um gatilho do Bitbucket Cloud seguindo estas etapas:

Console

  1. Acesse a página Gatilhos:

    Abrir a página Acionadores

  2. Selecione seu projeto do Google Cloud e clique em Abrir.

  3. Clique em Criar gatilho.

  4. Preencha as configurações de gatilho a seguir:

    • Nome: nome do gatilho.

    • Região: selecione a região do gatilho.

      • Se o arquivo de configuração da versão associado ao acionador especificar um pool particular, o Cloud Build usa esse pool para executar a compilação. Nesse caso, a região especificada no gatilho precisa corresponder à região em que você criou o pool privado.
      • Se o arquivo de configuração da versão associado ao acionador não especificar um pool particular, o Cloud Build usará o pool padrão para executar a compilação na mesma região que o acionador.
    • Descrição (opcional): uma descrição do gatilho.

    • Evento: selecione o evento de repositório para invocar seu gatilho.

      • Enviar para uma ramificação: defina o gatilho para iniciar um build em confirmações de uma ramificação específica.

      • Enviar nova tag por push: configure o gatilho para iniciar um build em confirmações que contenham uma tag específica.

      • Solicitação de envio: configure o gatilho para iniciar uma compilação após confirmações para uma solicitação de envio.

    • Origem: selecione 2a geração como origem.

      • Repositório: na lista de repositórios disponíveis, selecione o repositório. Para conectar um novo repositório, consulte Conectar-se a um repositório do Bitbucket Cloud.

      • Ramificação ou Tag: especifique uma expressão regular correspondente ao valor da ramificação ou da tag. Para ver informações sobre a sintaxe aceitável de expressões regulares, consulte Sintaxe de RE2 (em inglês).

      • Controle de comentários: se você tiver selecionado Solicitação de envio como seu Evento, escolha uma das seguintes opções para controlar se uma versão será executada automaticamente pelo acionador:

        • Obrigatório, exceto para proprietários e colaboradores: quando uma solicitação de envio é criada ou atualizada por um proprietário ou colaborador do repositório, os builds são executados automaticamente pelo gatilho. Se um colaborador externo iniciar a ação, os builds serão executados somente depois que um proprietário ou colaborador comentar /gcbrun na solicitação de envio.

        • Obrigatório: quando uma solicitação de envio é criada ou atualizada por qualquer colaborador, as versões são executadas somente depois que um proprietário ou colaborador comenta /gcbrun na solicitação de envio. Os builds são executados sempre que uma alteração é feita em uma solicitação de envio.

        • Não obrigatório: quando uma solicitação de envio é criada ou atualizada por qualquer colaborador, os builds são executados automaticamente por acionadores.

    • Configuração: selecione o arquivo de configuração do build localizado no repositório ou configure o build inline no acionador.

    • Tipo: selecione o tipo de configuração a ser usado para seu build.

      • Arquivo de configuração do Cloud Build (yaml ou json): use um arquivo de configuração do build na sua configuração.
      • Dockerfile: use um Dockerfile para sua configuração.
    • Local: especifique o local de configuração.

      • Repositório: se o arquivo de configuração estiver no repositório, forneça o local do arquivo de configuração do build ou o diretório Dockerfile e um nome para a imagem resultante. Se sua configuração for um Dockerfile, você poderá fornecer um tempo limite para a criação. Depois de fornecer o Dockerfile e o nome da imagem, você verá uma visualização do comando docker build para seu build.

      • Inline: se você selecionou o arquivo de configuração do Cloud Build (yaml ou json) como opção de configuração, pode especificar a configuração do build inline. Clique em Abrir editor para gravar seu arquivo de configuração do build no Console do Google Cloud usando a sintaxe YAML ou JSON. Clique em Concluído para salvar a configuração do build.

  5. Clique em Criar para criar o gatilho do Bitbucket Cloud.

gcloud

Crie um gatilho de evento push do repositório usando o seguinte comando:

gcloud builds triggers create bitbucket-cloud \
    --name=TRIGGER_NAME \
    --repository=\
    projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
    --branch-pattern=".*" --build-config="CONFIG_NAME" \
    --region=REGION

Em que:

  • TRIGGER-NAME é o nome que você quer dar ao gatilho de compilação.
  • PROJECT_ID é o ID do projeto no Google Cloud.
  • REGION é a região do gatilho.
  • CONNECTION_NAME é o nome da conexão do host.
  • REPO_NAME é o nome do repositório conectado no Bitbucket Cloud.
  • CONFIG_NAME é o nome do arquivo de esquema de configuração.

Depois que o gatilho é criado, o Cloud Build detecta todos os eventos de push em todas as ramificações. Quando você envia qualquer confirmação para o repositório, o gatilho é invocado. É possível ver os resultados do build na página Histórico da build.

Compartilhamento de dados

Os dados enviados para o Bitbucket Cloud a partir do Cloud Build ajudam a identificar acionadores por nome e ver os resultados de compilação nos seus repositórios do Bitbucket Cloud.

Os dados a seguir são compartilhados entre o Cloud Build e seu host do Bitbucket Cloud:

  • ID do projeto do Google Cloud
  • Nome do gatilho

A seguir