Esta página explica como criar acionadores manuais. Os acionadores manuais podem ser usados para invocar versões manualmente. Assim, é possível modificar os valores das variáveis de substituição definidas no momento da invocação antes de executá-las. Também é possível programar acionadores manuais para serem executados automaticamente em um horário específico.
Para saber como iniciar builds manualmente usando a CLI gcloud ou a API Cloud Build, consulte Como iniciar builds manualmente.
Antes de começar
-
Ative a API Cloud Build.
- Prepare seu código-fonte.
Gatilhos manuais
Os gatilhoes manuais permitem configurar versões que são executadas apenas quando você invoca o gatilho em repositórios conectados. Digamos que você esteja criando um pipeline para implantar seu código-fonte em um ambiente de teste ou produção. É recomendável automatizar seu fluxo de trabalho, mas só pretende executar versões manualmente. Você pode definir gatilhos manuais.
Os acionadores manuais permitem invocar manualmente as versões:
- Buscando código-fonte de um repositório hospedado com um branch ou tag especificados.
- Parametrizar seu build com substituições que não precisam ser transmitidas manualmente sempre que você executa um build.
- Como substituir valores de variáveis de substituição definidas no momento da invocação antes de invocar uma versão.
Para executar builds do diretório de trabalho local em vez de um repositório hospedado
ou se quiser enviar builds sem criar um gatilho, execute o seguinte
comando gcloud
no diretório de trabalho:
gcloud builds submit --config build-config source-code
Em que:
- build-config é o caminho para o arquivo de configuração da compilação;
- source-code é o caminho ou o código-fonte do URL.
Para saber mais sobre como usar o comando gcloud
para iniciar versões manualmente
no diretório local, consulte Como iniciar versões manualmente.
Como criar gatilhos manuais
Para criar um gatilho manual, faça o seguinte:
Acesse a página Gatilhos:
Selecione seu projeto na parte superior da página e clique em Abrir.
Clique em Criar gatilho.
Preencha as configurações de gatilho a seguir:
- Nome: nome do acionador.
- Região: selecione a região do gatilho. Observação: se você selecionar global como a região, os pools padrão serão usados para executar sua compilação. Caso contrário, um conjunto particular na região do gatilho é usado para executar a compilação.
- Descrição (opcional): uma descrição do gatilho.
- Quando: selecione invocação manual para configurar o gatilho de modo que os builds sejam executados somente quando o gatilho for invocado manualmente.
Origem: selecione o repositório a ser criado quando o gatilho manual for executado. Observação: a região do repositório precisa corresponder à região do gatilho. Se a origem for um repositório do Cloud Source Repositories, o repositório não estará conectado a uma região específica, mas ao seu projeto.
Revisão: selecione a ramificação ou a tag que será criada quando o gatilho manual for executado.
- Filial: defina um gatilho para o build nesse branch. É preciso especificar um valor literal. Expressões regulares não são compatíveis no momento.
- Tag: define um gatilho para o build nessa tag. É preciso especificar um valor literal. Expressões regulares não são compatíveis no momento.
Configuração: selecione o arquivo de configuração do build localizado no seu repositório remoto ou crie um arquivo de configuração do build inline para usar no build.
- 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. - Buildpacks: use os buildpacks na sua configuração.
Local: especifique o local de configuração.
- Repositório: se o arquivo de configuração estiver no seu
repositório remoto, forneça o local do arquivo de configuração do build, o diretório
Dockerfile
, ou o diretório buildpacks. Se o tipo de configuração do build for umDockerfile
ou um buildpack, você precisará fornecer um nome para a imagem resultante e, opcionalmente, um tempo limite para o seu build. Depois de fornecer o nome da imagemDockerfile
ou do buildpack, você verá uma visualização do comandodocker build
oupack
que seu build executará. - Variáveis de ambiente de pacote (opcional): se você
tiver selecionado
buildpacks
como tipo de configuração, clique em Adicionar variável de ambiente de pacote para especificar os valores e variáveis de ambiente do buildpack. Para saber mais sobre as variáveis de ambiente de buildpack, consulte Variáveis de ambiente. 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.
- Repositório: se o arquivo de configuração estiver no seu
repositório remoto, forneça o local do arquivo de configuração do build, o diretório
- Tipo: selecione o tipo de configuração a ser usado para seu build.
Clique em Criar para criar seu gatilho manual.
Como executar gatilhos manuais
Para executar um gatilho manual usando o Console do Google Cloud:
Abra a página Gatilhos no Console do Google Cloud.
Localize o gatilho na lista.
Clique em Executar gatilho.
Depois de clicar em Executar gatilho, você verá o painel Executar gatilho no lado direito. Se tiver especificado campos como o nome da ramificação, da tag ou das variáveis de substituição, será possível substituí-los no momento da invocação.
Se você especificou novos valores de variáveis para a substituição, clique em Executar gatilho para executar seu build.
Para executar gatilhos manuais dentro da programação, consulte Como programar builds.
Próximas etapas
- Saiba como iniciar builds manualmente usando comandos
gcloud
ou a API do Cloud Build. - Saiba como programar builds.
- Saiba como criar e gerenciar gatilhos.
- Saiba como ver os resultados da build.
- Saiba como resolver erros de build.