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, vai:

  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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  4. Enable the Cloud Scheduler, 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

  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.

      Aceder ao IAM
    2. Selecione o projeto.
    3. Clique em Conceder acesso.

    4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

    5. Na lista Selecionar uma função, selecione uma função.
    6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
    7. Clique em Guardar.

  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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  8. Enable the Cloud Scheduler, 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

  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.

      Aceder ao IAM
    2. Selecione o projeto.
    3. Clique em Conceder acesso.

    4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

    5. Na lista Selecionar uma função, selecione uma função.
    6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
    7. Clique em Guardar.

    10. 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 > Executar à força.

      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 tópico Pub/Sub está a receber mensagens da 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?