Como criar gatilhos programados

Nesta página, explicamos como executar builds em uma programação predefinida usando o Console do Google Cloud. Para programar builds, é preciso criar um gatilho manual e, em seguida, invocar o gatilho usando o Cloud Scheduler.

Antes de começar

  • Ative a API Cloud Build.

    Ative a API

Como programar builds

Para programar seu build:

  1. Acesse a página Gatilhos:

    Abrir a página Acionadores

  2. Localize a linha que contém o nome do gatilho manual que você quer executar na programação.

  3. Clique no menu (três pontos verticais) localizado na extremidade direita da linha que contém seu acionador.

  4. Clique em Executar na programação para programar sua versão.

    Você verá o painel Executar gatilho na programação, no lado direito.

  5. Ative a API Cloud Scheduler

    Você só receberá uma solicitação para ativar a API Cloud Scheduler na primeira vez que programar uma criação.

  6. Selecione a conta de serviço que você quer que o Cloud Scheduler use ao invocar seu gatilho.

    Recomendamos selecionar a conta de serviço de programação padrão, que tem o seguinte formato, em que PROJECT_ID é o ID do projeto:

     cloud-build-trigger-scheduler@PROJECT_ID.iam.gserviceaccount.com
    

    Quando você seleciona a conta de serviço de programação padrão, ela é criada automaticamente com o papel do IAM de Editor do Cloud Build. Recomendamos que você não exclua essa conta de serviço, porque ela é usada pelo Cloud Scheduler para programar builds. Se você excluir acidentalmente essa conta de serviço ou revogar qualquer permissão do IAM, acesse a página do IAM para adicionar manualmente a conta de serviço e conceder a ela Editor do Cloud Build. Talvez seja necessário aguardar até uma hora para que os jobs atuais do Cloud Scheduler sejam retomados após a recriação da conta de serviço.

  7. Clique em Continuar.

    Se a região não for selecionada, talvez você precise selecionar uma região para os jobs do Cloud Scheduler antes de prosseguir para a próxima etapa. Quando você seleciona uma região, um aplicativo do App Engine é criado automaticamente no projeto. Não é possível alterar a região do projeto posteriormente. Para saber mais, consulte as regiões compatíveis.

  8. Digite as configurações de job do Cloud Scheduler a seguir:

    • Nome: um nome do job do Cloud Scheduler.
    • Descrição (opcional): uma descrição do job do Cloud Scheduler.
    • Frequência: selecione a frequência com que o gatilho será executado. É possível escolher uma frequência no menu suspenso ou inserir um valor personalizado usando a sintaxe cron. Por exemplo, se você quiser que o gatilho manual seja executado diariamente às 6h, especifique a frequência na sintaxe do cron como 0 6 * * *. Para saber mais sobre a sintaxe do cron, consulte Como configurar programações de cron job.
    • Fuso horário: selecione seu fuso horário.
  9. Clique em Criar para criar o job do Cloud Scheduler.

    É possível criar vários jobs de programador para cada gatilho manual.

  10. Caso queira visualizar seu job do Cloud Scheduler, clique em Visualizar. Caso contrário, clique em Concluído para fechar o painel.

Como atualizar o job do Cloud Scheduler

Se você atualizar o campo Revisão no gatilho manual, precisará atualizar manualmente o job do Cloud Scheduler associado ao gatilho. Por exemplo, se você atualizar o nome do branch para o gatilho manual, será necessário atualizar manualmente o nome dele no job.

Para atualizar o job do Cloud Scheduler:

  1. Abra a página do Cloud Scheduler:

    Abrir a página do Cloud Scheduler

    Você verá uma lista dos jobs do Cloud Scheduler.

  2. [Opcional] Identifique o job do Cloud Scheduler associado ao gatilho:

    1. Para receber o ID do gatilho, execute o seguinte comando, em que TRIGGER_NAME é o nome do gatilho:

      gcloud beta builds triggers describe TRIGGER_NAME
      
    2. Anote o ID do gatilho.

    3. Digite o código do acionador na barra de filtros na parte superior da tabela.

    Você verá a lista de jobs do Cloud Scheduler associados ao gatilho.

  3. Clique na linha que contém o nome do job que você quer atualizar.

  4. Clique em Editar no topo da página.

    Você verá um formulário para atualizar o job do Cloud Scheduler.

  5. No campo Corpo, atualize a revisão.

  6. Clique em Atualizar.

Você atualizou a revisão associada ao gatilho do job do Cloud Scheduler.

Como remover o job do Cloud Scheduler

Excluir ou desativar o gatilho não excluirá ou desativará automaticamente todos os jobs do Cloud Scheduler que foram criados automaticamente quando você programou a gatilho. Seus jobs existirão, e os builds poderão continuar sendo invocados.

Para garantir que o gatilho não seja mais executado em um horário especificado, exclua o job do Cloud Scheduler.

Próximas etapas