Programar builds

Nesta página, explicamos como executar builds em uma programação predefinida usando o Google Cloud console. 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.

    Funções necessárias para ativar APIs

    Para ativar as APIs, é necessário ter a permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de proprietário (roles/owner). Caso contrário, você pode receber essa permissão com o papel de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

  • Prepare seu código-fonte.
  • Crie um gatilho manual, caso ainda não tenha feito isso, . Só é possível programar builds se o gatilho for manual.
  • Se você planeja usar uma conta de serviço especificada pelo usuário para o gatilho de compilação, prepare o endereço de e-mail dessa conta de serviço pronto. Será necessário conceder permissão à conta de serviço de programação para usá-la.

Como programar builds

Depois de criar um gatilho manual, você estará pronto para programar o build.

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 Ações 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 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 o papel de 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.

    Se o gatilho manual usar uma conta de serviço especificada pelo usuário, você também precisará conceder o papel de Usuário da conta de serviço (roles/iam.serviceAccountUser) à conta de serviço de programação padrão na conta de serviço especificada pelo usuário. Sem esse papel, o Cloud Scheduler não terá permissão para executar o gatilho.

  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 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 vão existir, 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