Programar e executar um cron job usando o console do Google Cloud

Neste guia de início rápido, mostramos como usar o console do Google Cloud para realizar algumas operações básicas usando o Cloud Scheduler.

Neste guia de início rápido, você fará as seguintes tarefas:

  1. Crie um tópico do Pub/Sub para configurar como destino do job do Cloud Scheduler.
  2. Crie um cron job usando o Cloud Scheduler e configure uma programação recorrente para o job.
  3. Execute o job.
  4. Verificar se o job foi concluído com sucesso.

O Cloud Scheduler tem um nível gratuito. Não convém executar este guia de início rápido. resultar em custos. Para mais informações, consulte Preços.


Para seguir as instruções passo a passo desta tarefa diretamente no console do Google Cloud, clique em Orientação:

Orientações


Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Enable the Cloud Scheduler, Pub/Sub APIs.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  7. Enable the Cloud Scheduler, Pub/Sub APIs.

    Enable the APIs

Criar um tópico e uma assinatura do Pub/Sub

Um tópico do Pub/Sub é um recurso para o qual os editores podem enviar mensagens. Para receber as mensagens publicadas em um tópico, crie uma assinatura para ele.

  1. No console do Google Cloud, acesse a página do Pub/Sub.

    Ir para o Pub/Sub

  2. Selecione Criar tópico.

  3. No campo ID do tópico, insira cron-topic como o ID do tópico.

  4. Mantenha as opções padrão, incluindo a opção Adicionar uma assinatura padrão.

  5. Não selecione outras opções.

  6. Clique em Criar.

Isso cria um tópico do Pub/Sub chamado cron-topic e uma assinatura para esse tópico chamada cron-topic-sub.

Criar um cron job usando o Cloud Scheduler

Configure uma unidade de trabalho programada, conhecida como cron job, que é enviada a um destino em uma programação recorrente.

  1. No console do Google Cloud, acesse a página do Cloud Scheduler.

    Acessar o Cloud Scheduler

  2. Clique em Criar job.

  3. Dê um nome ao job.

  4. Na lista Região, selecione uma região para o job.

  5. Especifique uma Frequência para o job usando um formato baseado em unix-cron. Exemplo:

    30 16 * * 7
    

    Para mais informações, consulte Configure cron job jobs.

  6. Na lista Fuso horário, selecione um fuso horário.

    Em alguns fusos horários, o horário de verão pode fazer com que os jobs sejam executados ou não. de maneira inesperada. Para mais informações, consulte Fuso horário.

  7. Clique em Continuar.

  8. Na lista Tipo de destino, selecione Pub/Sub.

  9. Selecione o tópico que você criou anteriormente: cron-topic.

  10. No campo Corpo da mensagem, insira uma string a ser enviada ao tópico de destino do Pub/Sub. Por exemplo: "Hello world!"

  11. Clique em Criar.

Você criou um job que envia uma mensagem para um tópico do Pub/Sub aos domingos às 16h30. Agora é possível executar o job.

Executar o job

Além de executar de acordo com a programação especificada, você pode forçar a execução imediata do job.

  1. No console do Google Cloud, acesse a página do Cloud Scheduler.

    Acessar o Cloud Scheduler

    O job será listado.

  2. Na linha do job, clique em Ações > Forçar execução.

    Devido a algumas configurações iniciais, a execução do primeiro job criado em um projeto pode levar alguns minutos.

  3. Na coluna Status da última execução, o status Success indica que o cron job foi executado com sucesso.

Em seguida, você pode verificar se o Pub/Sub recebeu a mensagem.

Verifique os resultados no Pub/Sub

Verifique se o tópico do Pub/Sub está recebendo mensagens do seu job extraindo mensagens do Pub/Sub da assinatura.

  1. No console do Google Cloud, acesse o Pub/Sub página de assinaturas.

    Ir para o Pub/Sub

  2. Clique na assinatura do tópico do Pub/Sub.

  3. Clique na guia Mensagens.

  4. Clique em Pull.

A mensagem publicada com o corpo da mensagem vai aparecer, Hello world e a hora em que a mensagem foi publicada.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

  1. Exclua o cron job criado:

    1. No console do Google Cloud, acesse a página do Cloud Scheduler.

      Acessar o Cloud Scheduler

    2. Marque a caixa de seleção do seu job.

    3. Clique em Delete (Excluir) e confirme a exclusão.

  2. Exclua o tópico Pub/Sub:

    1. No console do Google Cloud, acesse a página do Pub/Sub.

      Ir para o Pub/Sub

    2. Marque a caixa de seleção do seu tópico.

    3. Clique em Delete (Excluir) e confirme a exclusão.

  3. Exclua a assinatura do Pub/Sub:

    1. No console do Google Cloud, acesse a página do Pub/Sub.

      Ir para o Pub/Sub

    2. Marque a caixa de seleção da sua assinatura.

    3. Clique em Delete (Excluir) e confirme a exclusão.

  4. Como alternativa, se você tiver criado um novo projeto para saber mais sobre o Cloud Scheduler e não precisar mais dele, exclua o projeto:

    1. In the Google Cloud console, go to the Manage resources page.

      Go to Manage resources

    2. In the project list, select the project that you want to delete, and then click Delete.
    3. In the dialog, type the project ID, and then click Shut down to delete the project.

A seguir