Como programar builds

Nesta página, você aprenderá como executar versões com base em uma programação predefinida usando o Console do Google Cloud. Para programar versões, você precisa criar um acionador 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 sua versão:

  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 o gatilho.

  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 acionador.

    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
    

    Ao selecionar 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 versões. Se você excluir acidentalmente essa conta de serviço ou revogar qualquer uma das permissões 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 depois de recriar a conta de serviço.

  7. Clique em Continuar.

    Se você não tiver uma região selecionada, talvez seja necessário 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 seu projeto. Não é possível alterar a região do projeto mais tarde. Veja mais informações em 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, é possível especificar 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 atualizar o campo Revisão no gatilho manual, você precisará atualizar manualmente o job do Cloud Scheduler associado ao gatilho. Por exemplo, se você atualizar o nome da ramificação para o gatilho manual, será necessário atualizar manualmente o nome da ramificação no job.

Para atualizar o job do Cloud Scheduler:

  1. Abra a página 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. Receba o ID do gatilho executando 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. Insira o ID do gatilho na barra de filtro na parte superior da tabela.

    Você verá a lista dos 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 seu job do Cloud Scheduler.

  5. No campo Corpo, atualize sua 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 criados automaticamente quando você programou a acionador. Seus jobs existem e as versões podem continuar sendo invocadas.

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

Próximas etapas