Esta página explica como ativar a funcionalidade do acionador em uma do Bitbucket Cloud. Saiba mais sobre Gatilhos do Cloud Build e Repositórios do Cloud Build.
Antes de começar
-
Enable the Cloud Build and Secret Manager APIs.
- Siga as instruções para conectar um host do Bitbucket Cloud.
- Siga as instruções em Conectar-se a um repositório do Bitbucket Cloud.
Criar um gatilho do Bitbucket Cloud
Crie um gatilho do Bitbucket Cloud seguindo estas etapas:
Console
Acesse a página Gatilhos:
Selecione seu projeto do Google Cloud e clique em Abrir.
Clique em Criar gatilho.
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 do build associado ao acionador especificar um pool particular, o Cloud Build vai usar o pool particular para executar o build. Nesse caso, a região especificada no acionador precisa corresponder à região em que você criou o pool particular.
- Se o arquivo de configuração do build associado ao gatilho não especifica um pool privado, O Cloud Build usa a configuração pool para executar seu build na mesma região como gatilho.
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 pull: configure o acionador para iniciar um build em confirmações para uma solicitação de pull.
Origem: selecione 2ª geração como sua origem.
Repositório: na lista de repositórios disponíveis, selecione o repositório de dados. Para conectar um novo repositório, consulte Conectar-se a um Bitbucket repositório do Google 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ê selecionou Solicitação de envio como seu Evento, escolha uma das seguintes opções para controlam se uma versão será executada automaticamente pelo gatilho:
Obrigatório, exceto para proprietários e colaboradores: quando uma solicitação de envio é criada ou atualizada por um proprietário ou colaborador de repositório, os builds são executados automaticamente pelo gatilho. Se um usuário externo colaborador inicia a ação, os builds são executados somente após um proprietário ou colaborador comenta
/gcbrun
na solicitação de envio.Obrigatório: quando uma solicitação de envio é criada ou atualizada por qualquer colaborador, os builds só são executados depois que um proprietário ou colaborador comenta
/gcbrun
na solicitação de envio. Construções 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 gatilhos.
Configuração: selecione o arquivo de configuração do build localizado no seu repositório ou configure o build inline no gatilho.
Type: selecione o tipo de configuração a ser usado para o 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 localizado no repositório, forneça a localização do arquivo de configuração do build ou o
Dockerfile
e um nome para a imagem resultante. Se sua configuração for umDockerfile
, você poderá fornecer um tempo limite para a criação. Depois de fornecer oDockerfile
e o nome da imagem, você vai ver uma visualização do comandodocker build
para o 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 o 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 da compilação.
Clique em Criar para criar o gatilho do Bitbucket Cloud.
gcloud
Crie um acionador de evento de envio 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 à conta 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 esquema de configuração. .
Depois que o acionador é criado, o Cloud Build detecta todos os eventos de push em todas as ramificações. Quando você envia um commit para o repositório, o gatilho é invocado. É possível ver os resultados do build na página Histórico de builds.
Compartilhamento de dados
Os dados enviados do Cloud Build para o Bitbucket Cloud ajudam a identificar gatilhos por nome e conferir os resultados da versão nos repositórios do Bitbucket Cloud.
Os dados a seguir são compartilhados entre o Cloud Build e seu Bitbucket Host da nuvem:
- ID do projeto do Google Cloud
- Nome do gatilho
A seguir
- Saiba como criar e gerenciar gatilhos.
- Saiba como iniciar versões manualmente.
- Saiba como ver os resultados da build.
- Saiba como realizar implantações azul-verde no Compute Engine.