Ajude a moldar o futuro da entrega de software e manifeste-se respondendo à pesquisa sobre o estado de DevOps 2202.

Como criar gatilhos manuais

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 ferramenta de linha de comando gcloud ou a API Cloud Build, consulte Como iniciar builds manualmente.

Antes de começar

  • Ative a API Cloud Build.

    Ative a API

  • 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ó pretendem invocar 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 sua versão com substituições que não precisam ser transmitidas manualmente sempre que você invoca uma versão.
  • Como substituir valores de variáveis de substituição definidas no momento da invocação antes de invocar uma versão.

Para invocar versões do diretório de trabalho local em vez de um repositório hospedado ou quiser enviar versões 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:

  1. Acesse a página Gatilhos:

    Abrir a página Acionadores

  2. Selecione seu projeto na parte superior da página e clique em Abrir.

  3. Clique em Criar gatilho.

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

    • Nome: nome do gatilho.
    • Descrição (opcional): uma descrição do gatilho.
    • Quando: selecione Executar manualmente 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.
    • Revisão: selecione a ramificação ou tag a 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 da versão localizado no seu repositório remoto ou crie um arquivo de configuração da versão in-line para usar na sua versão.

      • Type: selecione o tipo de configuração a ser usado na build.
        • Arquivo de configuração do Cloud Build (yaml ou json): use um arquivo de configuração de versão para sua configuração.
        • Dockerfile: use um Dockerfile para sua configuração.
      • Local: especifique o local da sua configuração.

        • Repositório: se o arquivo de configuração estiver localizado no seu repositório remoto, forneça o local do seuarquivo de configuração de build ou aDockerfile e um nome para a imagem resultante. Se sua configuração for um Dockerfile, será possível fornecer um tempo limite para sua versão. Ao fornecer o Dockerfile e o nome da imagem, você verá uma prévia do comando docker build que sua versão executará.
        • Inline: se você selecionou Arquivo de configuração do Cloud Build (yaml ou json) como opção de configuração, é possível especificar a configuração da versão in-line. Clique em Abrir editor para gravar o arquivo de configuração da criação no Console do Google Cloud usando a sintaxe YAML ou JSON. Clique em Concluído para salvar a configuração da versão.
  5. Clique em Criar para criar seu gatilho manual.

Como executar gatilhos manuais

Para executar um gatilho manual usando o Console do Google Cloud:

  1. Abra a página Gatilhos no Console do Google Cloud.

    Abrir a página "Gatilhos"

  2. Localize o gatilho na lista.

  3. 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 invocar sua versão.

Para executar acionadores manuais na programação, consulte Como programar versões.

Próximas etapas