Agende uma função HTTP do Cloud Run

---

Este tutorial mostra como agendar uma função HTTP do Cloud Run segmentando um ponto final HTTP no Cloud Scheduler. Use uma função HTTP quando precisar que a sua função tenha um ponto final de URL e responda a pedidos HTTP, como para webhooks.

Em alternativa, se criou uma função CloudEvents, use acionadores de eventos do Eventarc para agendar a resposta da sua função a eventos no seu projeto. O Eventarc pode acionar mensagens num tópico do Pub/Sub, alterações num contentor do Cloud Storage e muito mais. Para mais informações, consulte Tipos de funções do Cloud Run.

O agendamento da execução de uma função do Cloud Run é um exemplo de utilização comum do Cloud Scheduler. Neste tutorial, vai:

1. Crie uma função HTTP simples do Cloud Run.
2. Crie uma tarefa do Cloud Scheduler.
3. Execute a tarefa do Cloud Scheduler.
4. Confirme que a tarefa do Cloud Scheduler aciona a sua função do Cloud Run.

Custos

Neste documento, usa os seguintes componentes faturáveis do Google Cloud:

• Cloud Run
• Cloud Scheduler

Para gerar uma estimativa de custos com base na sua utilização projetada, use a calculadora de preços.

Os novos Google Cloud utilizadores podem ser elegíveis para uma avaliação gratuita.

Antes de começar

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.

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

Enable the APIs

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click Add another role and add each additional role.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
6. Click Continue.

7. Click Done to finish creating the service account.

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

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler APIs.

Enable the APIs

Create a service account:

1. In the Google Cloud console, go to the Create service account page.

   Go to Create service account
2. Select your project.

3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

   In the Service account description field, enter a description. For example, Service account for quickstart.

4. Click Create and continue.

5. Grant the following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

   To grant a role, find the Select a role list, then select the role.

   To grant additional roles, click Add another role and add each additional role.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
6. Click Continue.

7. Click Done to finish creating the service account.

Tenha em atenção que tem de conceder a função de invocador do Cloud Run porque, nas funções do Cloud Run, as autorizações de invocação estão disponíveis através da gestão do serviço do Cloud Run subjacente.

Funções necessárias

Para receber as autorizações de que precisa para concluir o tutorial, peça ao seu administrador para lhe conceder as seguintes funções da IAM no seu projeto:

• Cloud Run Source Developer (roles/run.sourceDeveloper)
• Administrador do Cloud Scheduler (roles/cloudscheduler.admin)
• Aceder à vista de registos (roles/logging.viewAccessor)
• Project IAM Admin (roles/resourcemanager.projectIamAdmin)
• Administrador da conta de serviço (roles/iam.serviceAccountAdmin)
• Utilizador da conta de serviço (roles/iam.serviceAccountUser)

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.

Nota: as funções básicas da IAM também podem conter autorizações para concluir o tutorial. Não deve conceder funções básicas num ambiente de produção, mas pode concedê-las num ambiente de desenvolvimento ou de teste.

Conceda as funções

Consola

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

   Aceda 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 da Conta Google usado para implementar o serviço do Cloud Run.

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.

gcloud

Para conceder as funções de IAM necessárias à sua conta no seu projeto:

     gcloud projects add-iam-policy-binding PROJECT_ID \
         --member=PRINCIPAL \
         --role=ROLE
     

Substituir:

• PROJECT_NUMBER com o número do seu Google Cloud projeto.
• PROJECT_ID com o seu Google Cloud ID do projeto.
• PRINCIPAL com a conta à qual está a adicionar a associação. Normalmente, trata-se do endereço de email da Conta Google que é usado para implementar o serviço do Cloud Run.
• ROLE com a função que está a adicionar à conta do implementador.

Crie uma função HTTP do Cloud Run

Crie uma função HTTP acionada pelo Cloud Scheduler.

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

   Aceda ao Cloud Run

2. Clique em Escrever uma função.

3. Na secção Configurar, faça o seguinte:

   1. No campo Nome do serviço, introduza um nome para a função.
   2. Na lista Região, selecione uma região.
   3. Não modifique o idioma de tempo de execução predefinido.

   4. Para autenticação, selecione Exigir autenticação.

      Se estiver ao abrigo de uma política da organização de restrição de domínio que restringe as invocações não autenticadas para o seu projeto, tem de aceder ao serviço implementado conforme descrito em Testar serviços privados.

      Para mais informações, consulte o artigo Autentique-se para a invocação.

4. Aceite as outras predefinições e clique em Criar.

5. Copie o URL HTTP da função.

Crie uma tarefa do Cloud Scheduler

Crie uma tarefa do Cloud Scheduler que aciona uma ação através de HTTP.

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

   Aceda ao Cloud Scheduler

2. Clique em Criar tarefa.

3. Introduza um nome para a tarefa.

4. Na lista Região, selecione uma região.

5. Especifique a frequência da tarefa, usando um formato unix-cron:

   30 16 * * 7
   

   Para mais informações, consulte o artigo Formato de tarefa cron e fuso horário.

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

7. Clique em Continuar.

8. Na lista Tipo de destino, selecione HTTP.

9. No campo URL, introduza o URL HTTP da função que copiou anteriormente.

10. Na lista Cabeçalho de autorização, selecione Adicionar token OIDC.

11. Na lista Conta de serviço, selecione a conta de serviço que criou anteriormente.

12. No campo Público-alvo, introduza o URL HTTP da função que copiou anteriormente.

13. Clique em Criar.

Criou uma tarefa cron que executa a sua função do Cloud Run aos domingos às 16:30.

Execute a sua tarefa do Cloud Scheduler

Agora, pode executar a tarefa 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 que criou e clique em Forçar execução.

   Quando é invocado inicialmente, o primeiro trabalho criado num projeto pode demorar alguns minutos a configurar e executar.

3. Após a execução da tarefa, o Estado da última execução deve indicar Success.

Valide os resultados nas funções do Cloud Run

Pode verificar se a função do Cloud Run é acionada e executada com êxito pela tarefa cron.

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

   Aceda ao Cloud Run

2. Selecione Filtrar serviços > Tipo de implementação > Função. Isto filtra a lista de serviços para mostrar apenas funções.

3. Clique no nome da função.

   É apresentada a página Detalhes do serviço, que apresenta as métricas do serviço.

4. Clique no separador Registos.

   Deve ver uma entrada de registo semelhante a: POST 200 146 B 5 ms Google-Cloud-Scheduler https://FUNCTION_NAME

Limpar

Para evitar incorrer em custos na sua conta do Google Cloud pelos recursos usados neste tutorial, elimine o projeto que contém os recursos ou mantenha o projeto e elimine os recursos individuais.

Eliminar projeto

Atenção: a eliminação de um projeto tem os seguintes efeitos:

• Tudo no projeto é eliminado. Se usou um projeto existente para as tarefas neste documento, quando o elimina, também elimina qualquer outro trabalho que tenha feito no projeto.
• Os IDs dos projetos personalizados são perdidos. Quando criou este projeto, pode ter criado um ID do projeto personalizado que quer usar no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, elimine os recursos selecionados no projeto em vez de eliminar o projeto inteiro.

Se planeia explorar várias arquiteturas, tutoriais ou inícios rápidos, a reutilização de projetos pode ajudar a evitar exceder os limites de quota de projetos.

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.

Elimine recursos de tutoriais

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

   Aceda ao Cloud Scheduler

2. Selecione a caixa de verificação junto ao seu trabalho.

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

4. Na Google Cloud consola, aceda à página Cloud Run.

   Aceda ao Cloud Run

5. Selecione a caixa de verificação junto ao seu serviço.

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

7. Na Google Cloud consola, aceda à página Contas de serviço.

   Aceda a Contas de serviço

8. Selecione a caixa de verificação junto à conta de serviço que criou.

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

O que se segue?

• Use o Cloud Scheduler para acionar o Cloud Run de acordo com um horário
• Escreva funções CloudEvents para agendar a sua função para responder a eventos no seu projeto.