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

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

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 nenhuma outra opção.

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 Configurar programações de cron job.

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 inesperadamente. 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 às 16h30 aos domingos. Agora você pode 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 trabalho extraindo mensagens do Pub/Sub da assinatura.

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

   Ir para o Pub/Sub

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

3. Clique na guia Mensagens.

4. Clique em Pull.

Você vai encontrar a mensagem que publicou, com o corpo da mensagem, Hello world e o horário em que ela 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:

   Cuidado: excluir um projeto tem os seguintes efeitos:

   • Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
   • Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

   Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do 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

• Saiba mais sobre o Cloud Scheduler
• Saiba como visualizar registros do Cloud Scheduler