Agende compilações

Esta página explica como executar compilações numa programação predefinida através da Google Cloud consola. Para agendar compilações, tem de criar um acionador manual e, em seguida, invocar o acionador através do Cloud Scheduler.

Antes de começar

  • Enable the Cloud Build API.

    Enable the API

  • Tenha o código-fonte pronto.
  • Se ainda não o fez, crie um acionador manual. Só pode agendar compilações se o acionador for um acionador manual.

Agendamento de compilações

Depois de criar um acionador manual, tem tudo pronto para agendar a compilação.

Para agendar a compilação:

  1. Abra a página Acionadores:

    Abra a página Acionadores

  2. Localize a linha que contém o nome do acionador manual que quer executar de acordo com uma programação.

  3. Clique no menu (reticências verticais) localizado no extremo direito da linha que contém o seu acionador.

  4. Clique em Executar de acordo com a programação para agendar a compilação.

    É apresentado o painel Executar acionador de acordo com uma programação no lado direito.

  5. Ative a API Cloud Scheduler.

    Só lhe é pedido que ative a API Cloud Scheduler na primeira vez que agendar uma compilação.

  6. Selecione a conta de serviço que quer que o Cloud Scheduler use quando invocar o seu acionador.

    Recomendamos que selecione a conta de serviço de agendamento predefinida, que tem o seguinte formato, em que PROJECT_ID é o ID do projeto:

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

    Quando seleciona a conta de serviço de agendamento predefinida, esta é criada automaticamente para si com a função do IAM Editor do Cloud Build concedida. Recomendamos que não elimine esta conta de serviço, uma vez que é usada pelo Cloud Scheduler para agendar compilações. Se eliminar acidentalmente esta conta de serviço ou revogar alguma das respetivas autorizações do IAM, pode navegar para a página do IAM para adicionar manualmente a conta de serviço e conceder-lhe a função de editor do Cloud Build. Pode ter de aguardar até uma hora para que as tarefas existentes do Cloud Scheduler sejam retomadas após a recriação da conta de serviço.

  7. Clique em Continuar.

    Se não tiver uma região selecionada, pode ser-lhe pedido que selecione uma região para as suas tarefas do Cloud Scheduler antes de avançar para o passo seguinte. Quando seleciona uma região, é criada automaticamente uma aplicação do App Engine no seu projeto. Não pode alterar a região do seu projeto posteriormente. Para saber mais, consulte o artigo Regiões suportadas.

  8. Introduza as seguintes definições da tarefa do Cloud Scheduler:

    • Nome: um nome para a sua tarefa do Cloud Scheduler.
    • Descrição (opcional): uma descrição da sua tarefa do Cloud Scheduler.
    • Frequência: selecione a frequência com que quer que o acionador seja executado. Pode escolher uma frequência no menu pendente ou introduzir um valor personalizado através da sintaxe cron. Por exemplo, se quiser que o acionador manual seja executado todos os dias às 06:00, pode especificar a frequência na sintaxe cron como 0 6 * * *. Para saber mais sobre a sintaxe cron, consulte o artigo Configurar agendamentos de tarefas cron.
    • Fuso horário: selecione o seu fuso horário.

  9. Clique em Criar para criar a tarefa do Cloud Scheduler.

    Pode criar várias tarefas do programador para cada acionador manual.

  10. Se quiser ver a sua tarefa do Cloud Scheduler, clique em Ver. Caso contrário, clique em Concluído para fechar o painel.

Atualizar a sua tarefa do Cloud Scheduler

Se atualizar o campo Revision no acionador manual, tem de atualizar manualmente a tarefa do Cloud Scheduler associada ao acionador. Por exemplo, se atualizar o nome da ramificação para o acionador manual, tem de atualizar manualmente o nome da ramificação na tarefa.

Para atualizar a tarefa do Cloud Scheduler:

  1. Abra a página Cloud Scheduler:

    Abra a página do Cloud Scheduler

    É apresentada uma lista das suas tarefas do Cloud Scheduler.

  2. [Opcional] Identifique a tarefa do Cloud Scheduler associada ao seu acionador:

    1. Obtenha o ID do acionador executando o seguinte comando, onde TRIGGER_NAME é o nome do acionador:

      gcloud builds triggers describe TRIGGER_NAME

    2. Tome nota do ID do acionador.

    3. Introduza o ID do acionador na barra de filtros na parte superior da tabela.

    É apresentada a lista das suas tarefas do Cloud Scheduler associadas ao seu acionador.

  3. Clique na linha que contém o nome da tarefa que quer atualizar.

  4. Clique em Editar na parte superior da página.

    É apresentado um formulário para atualizar a tarefa do Cloud Scheduler.

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

  6. Clique em Atualizar.

Atualizou a revisão associada ao seu acionador para a tarefa do Cloud Scheduler.

Remover a tarefa do Cloud Scheduler

A eliminação ou a desativação do acionador não elimina nem desativa automaticamente todas as tarefas do Cloud Scheduler que foram criadas automaticamente quando agendou o acionador. As suas tarefas vão existir e as compilações podem continuar a ser invocadas.

Para garantir que o acionador deixa de ser executado numa hora especificada, elimine a tarefa do Cloud Scheduler.

Passos seguintes