Programar e executar um cron job usando o console Google Cloud

Neste guia de início rápido, mostramos como usar o console Google Cloud para realizar algumas operações básicas com 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 ele.
  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. gerar custos. Para mais informações, consulte Preços.

Para seguir as instruções detalhadas 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. Make sure that billing is enabled for your Google Cloud project.

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

    Enable the APIs

  5. Make sure that you have the following role or roles on the project: Cloud Scheduler Admin, Pub/Sub Editor

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM
    2. Selecionar um projeto.
    3. Clique em CONCEDER ACESSO.

    4. No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

    5. Na lista Selecionar um papel, escolha um.
    6. Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
    7. Clique em Salvar.

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

    Go to project selector

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

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

    Enable the APIs

  9. Make sure that you have the following role or roles on the project: Cloud Scheduler Admin, Pub/Sub Editor

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM
    2. Selecionar um projeto.
    3. Clique em CONCEDER ACESSO.

    4. No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

    5. Na lista Selecionar um papel, escolha um.
    6. Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
    7. Clique em Salvar.

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

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

  1. No console 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 os padrões, 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 Google Cloud , acesse a página 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 executados 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: "Olá, mundo!"

  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 Google Cloud , acesse a página 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 ao extrair mensagens do Pub/Sub da assinatura.

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

    Ir para o Pub/Sub

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

  3. Clique na guia Mensagens.

  4. Clique em Pull.

Você vai ver 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 sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

  1. Exclua o cron job criado:

    1. No console Google Cloud , acesse a página 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 Google Cloud , acesse a página 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 Google Cloud , acesse a página 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