Guia de início rápido do Cloud Scheduler

Neste guia de início rápido, você verá as seguintes operações básicas do Cloud Scheduler:

  • Criar um job do Cloud Scheduler.
  • Definir uma programação recorrente para um job.
  • Especificar um tópico do Cloud Pub/Sub como destino da tarefa.
  • 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. Instale e inicialize o SDK do Cloud.

  2. Adicione os componentes gcloud para produtos:

     gcloud components install
    
  3. 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 Cloud SDK e crie um projeto do GCP:

     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 a ferramenta gcloud para usar o projeto escolhido:

     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, denominados europe-west e us-central nos comandos do App Engine, são chamados, respectivamente, europe-west1 e us-central1 nos comandos do Cloud Tasks.

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

     gcloud app describe
    

    A região aparece em locationId, por exemplo, 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 Platform para ativar recursos:

  1. Ative o faturamento do projeto.

  2. Ative a API do Cloud Scheduler.

  3. Ative a API Cloud Pub/Sub.

Use a ferramenta gcloud para configurar o Cloud Pub/Sub:

  1. Configure um tópico do Cloud Pub/Sub para usar como destino do cron job:

    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 do Cloud Pub/Sub para ver os resultados do job.

    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.

    imagem

  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 criado anteriormente (cron-topic).

  7. Adicione uma string de Payload para enviar ao destino do Cloud Pub/Sub.

    imagem

  8. Clique em Criar

Você acaba de criar um job que envia uma mensagem ao tópico do Cloud 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.

    imagem

Parabéns! Você acabou de ver no console os resultados da execução de um cron job que envia uma mensagem ao Cloud Pub/Sub. A seguir, você aprenderá a verificar se o Cloud Pub/Sub recebeu a mensagem.

Verificar os resultados no Cloud Pub/Sub

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

  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 GCP pelo uso de recursos neste guia de início rápido:

Exclua o job do Cloud Scheduler

  1. Acesse a página do Cloud Scheduler no Console do GCP.

    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. Acesse a página do Cloud Pub/Sub no Console do GCP.

    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.

Próximas etapas