Guia de início rápido do Cloud Scheduler

Este guia de início rápido aborda as seguintes operações básicas do Cloud Scheduler:

  • Criar um job do Cloud Scheduler.
  • Definir uma programação recorrente para um job.
  • Especifique um tópico Pub/Sub como o destino do job.
  • Executar um job.
  • Verificar a execução.

O Cloud Scheduler inclui um nível gratuito, por isso seguir este guia de início rápido não gerará custos. Para mais informações, consulte Preços.

Antes de começar

Use as instruções a seguir e se prepare para o guia de início rápido. Talvez você já tenha concluído algumas das etapas.

Instale e configure a ferramenta de linha de comando gcloud:

  1. Instalar e inicializar o Cloud SDK

  2. Atualize todos os componentes:

     gcloud components update
    

Crie um projeto com um aplicativo do App Engine.

Você também pode usar um projeto já existente, se tiver um.

  1. Abra um terminal na máquina em que você instalou o SDK do Cloud e crie um projeto em nuvem:

     gcloud projects create [PROJECT_ID]
    

    PROJECT_ID representa o código do projeto criado. Os códigos de projeto precisam começar com letra minúscula e podem conter letras ASCII minúsculas, números e hifens. Também precisam ter entre 6 e 30 caracteres.

  2. Configure gcloud para usar o projeto que você escolheu:

     gcloud config set project [PROJECT-ID]
    

    PROJECT_ID deve ser o código que você definiu anteriormente.

  3. Crie o app:

     gcloud app create [--region=REGION]
    

    onde [REGION] é o local em que o aplicativo é executado. Observe que dois locais, chamados europe-west e us-central nos comandos do App Engine, são chamados, respectivamente, europe-west1 e us-central1 nos comandos do Cloud Scheduler.

    Para verificar a região de um aplicativo existente, use este comando:

     gcloud app describe
    

    A região é listada por locationId. Sua localização, por exemplo, pode ser mostrada como locationId: us-central.

    Não é possível alterar a zona do aplicativo do App Engine depois de defini-la.

Use o Console do Google Cloud para ativar os recursos:

  1. Ative o faturamento do projeto.

  2. Ative a API do Cloud Scheduler

  3. Habilite a API Pub/Sub

Use gcloud para configurar Pub/Sub:

  1. Configure um tópico Pub/Sub para usar como destino para seu trabalho cron:

    gcloud pubsub topics create cron-topic
    

    Esse comando cria um tópico chamado "cron-topic". Anote o nome vai precisar dele mais tarde durante este guia.

  2. Crie uma assinatura Pub/Sub; você precisa disso para visualizar os resultados do seu trabalho.

    gcloud pubsub subscriptions create cron-sub --topic cron-topic
    

Criar um job

  1. Acesse a página do Cloud Scheduler no console:

    Cloud Scheduler

  2. Clique no botão Criar job.

  3. Dê um nome ao job e, se preferir, inclua uma descrição.

    image

  4. Especifique a frequência do job usando o formato unix-cron.

    * * * * *
    

    Consulte mais informações em Como configurar programações de cron job. Os desenvolvedores também podem usar o formato de cron do App Engine se estiverem familiarizados com ele.

  5. Selecione seu fuso horário.

  6. No campo Destino, selecione tópico do Pub/Sub no menu suspenso e insira o tópico que você criou anteriormente (cron-topic).

  7. Adicione uma string de Payload a ser enviada ao destino do Pub/Sub.

    image

  8. Clique em Criar

Agora você tem um trabalho que envia uma mensagem para o tópico Pub/Sub a cada minuto. Vamos executá-lo.

Executar o job

  1. Na página do console do Cloud Scheduler aberta com o projeto, clique no botão Executar agora.

    A primeira execução do primeiro job criado em um projeto pode levar alguns minutos devido à configuração necessária. Portanto, talvez seja necessário esperar um pouco.

  2. Veja os resultados na coluna Resultado.

    image

Parabéns! Você acabou de visualizar os resultados no console da execução de um trabalho cron que envia uma mensagem para Pub/Sub. Em seguida, você aprenderá como verificar se Pub/Sub realmente recebeu a mensagem.

Verifique os resultados em Pub/Sub

Para verificar se o seu tópico Pub/Sub está recebendo mensagens do seu trabalho:

  1. Chame o comando:

     gcloud pubsub subscriptions pull cron-sub --limit 5
    
  2. Veja os resultados. Um código semelhante a este será exibido.

     +-------------+----------------+------------+-----------------------------+
     | DATA        | MESSAGE_ID     | ATTRIBUTES | ACK_ID                      |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56344662920621 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340561244339 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340388879975 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337745052761 |            | EkwnGERJUytDCypYEU4EISE...  |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337890896134 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
    

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

Exclua o job do Cloud Scheduler

  1. Vá para a página Cloud Scheduler no Cloud Console.

    Acessar a página do Scheduler

  2. Clique na caixa de seleção ao lado do seu job.

  3. Clique no botão Excluir na parte superior da página e confirme.

Exclua o tópico Pub/Sub

  1. Vá para a página Cloud Pub/Sub no Cloud Console.

    Acessar a página do Pub/Sub

  2. Clique na caixa de seleção ao lado do tópico.

  3. Clique em Excluir na parte superior da página e confirme.

Exclua o projeto

Se você criou um projeto apenas para este guia de início rápido.

  1. No Console do Cloud, acesse a página Gerenciar recursos:

    Acessar a página "Gerenciar recursos"

  2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
  3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir