Agende e execute uma tarefa cron através da Google Cloud consola

Este início rápido mostra como usar a Google Cloud consola para realizar algumas operações básicas com o Cloud Scheduler.

Neste início rápido:

  1. Crie um tópico do Pub/Sub para configurar como destino da tarefa do Cloud Scheduler.
  2. Crie uma tarefa cron com o Cloud Scheduler e configure uma programação recorrente para a tarefa.
  3. Execute a tarefa.
  4. Verifique se a tarefa foi executada com êxito.

O Cloud Scheduler tem um nível gratuito e a execução deste início rápido não deve incorrer em custos. Para mais informações, consulte a secção Preços.

Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Orientar-me:

Visita guiada

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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Cloud Scheduler and Pub/Sub APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Cloud Scheduler and Pub/Sub APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    10.

    Funções necessárias

    Para receber as autorizações de que precisa para concluir este início rápido, peça ao seu administrador que lhe conceda as seguintes funções da IAM no seu projeto:

    Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

    Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

    Crie um tópico e uma subscrição do Pub/Sub

    Um tópico Pub/Sub é um recurso para o qual os publicadores podem enviar mensagens. Para receber mensagens publicadas num tópico, tem de criar uma subscrição desse tópico.

    1. Na Google Cloud consola, aceda à página do Pub/Sub.

      Aceda ao Pub/Sub

    2. Clique em Criar tópico.

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

    4. Mantenha as predefinições, incluindo a opção Adicionar uma subscrição predefinida.

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

    6. Clique em Criar.

    Isto cria um tópico Pub/Sub denominado cron-topic e uma subscrição para esse tópico denominada cron-topic-sub.

    Crie uma tarefa cron com o Cloud Scheduler

    Configurar uma unidade de trabalho agendada, conhecida como tarefa cronológica, que é enviada para um destino num agendamento recorrente.

    1. Na Google Cloud consola, aceda à página Cloud Scheduler.

      Aceda ao Cloud Scheduler

    2. Clique em Criar tarefa.

    3. Atribua um nome à tarefa.

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

    5. Especifique uma frequência para a tarefa, usando um formato baseado em unix-cron. Por exemplo:

      30 16 * * 7

      Para mais informações, consulte o artigo Configure programações de tarefas cron.

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

      Para alguns fusos horários, o horário de verão pode fazer com que as tarefas sejam executadas ou não executadas inesperadamente. Para mais informações, consulte o artigo Fuso horário.

    7. Clique em Continuar.

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

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

    10. No campo Corpo da mensagem, introduza uma string a ser enviada para o tópico de destino do Pub/Sub. Por exemplo: "Olá mundo!"

    11. Clique em Criar.

    Criou uma tarefa que envia uma mensagem para um tópico Pub/Sub às 16:30 aos domingos. Agora, pode executar a tarefa.

    Execute a tarefa

    Além de ser executado de acordo com a programação especificada, pode forçar a execução imediata da tarefa.

    1. Na Google Cloud consola, aceda à página Cloud Scheduler.

      Aceda ao Cloud Scheduler

      O seu trabalho deve ser apresentado.

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

      Tenha em atenção que, devido a alguma configuração inicial, a primeira tarefa criada num projeto pode demorar alguns minutos a ser executada.

    3. Na coluna Estado da última execução, um estado Success indica que executou com êxito a tarefa cron.

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

    Valide os resultados no Pub/Sub

    Verifique se o seu tópico Pub/Sub está a receber mensagens da sua tarefa extraindo mensagens Pub/Sub da subscrição.

    1. Na Google Cloud consola, aceda à página Subscrições do Pub/Sub.

      Aceda ao Pub/Sub

    2. Clique na subscrição do seu tópico Pub/Sub.

    3. Clique no separador Mensagens.

    4. Clique em Extrair.

    Deve ver a mensagem que publicou, com o corpo da mensagem, Hello world e a hora em que a mensagem foi publicada.

    Limpar

    Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

    1. Elimine a tarefa cron que criou:

      1. Na Google Cloud consola, aceda à página Cloud Scheduler.

        Aceda ao Cloud Scheduler

      2. Selecione a caixa de verificação da tarefa.

      3. Clique em Eliminar e confirme a eliminação.

    2. Elimine o tópico Pub/Sub:

      1. Na Google Cloud consola, aceda à página Pub/Sub.

        Aceda ao Pub/Sub

      2. Selecione a caixa de verificação do seu tópico.

      3. Clique em Eliminar e confirme a eliminação.

    3. Elimine a subscrição do Pub/Sub:

      1. Na Google Cloud consola, aceda à página Pub/Sub.

        Aceda ao Pub/Sub

      2. Selecione a caixa de verificação da sua subscrição.

      3. Clique em Eliminar e confirme a eliminação.

    4. Em alternativa, se criou um novo projeto para saber mais sobre o Cloud Scheduler e já não precisar do projeto, elimine-o:

      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.

    O que se segue?