Programar uma função do Cloud Run em HTTP

Neste tutorial, mostramos como programar uma função do Cloud Run HTTP direcionando um endpoint HTTP no Cloud Scheduler. Use uma função HTTP quando precisar que a função tenha um endpoint de URL e responda a solicitações HTTP, como para webhooks.

Como alternativa, se você criou uma função do CloudEvents, use acionadores de eventos do Eventarc para programar a função e responder a eventos no seu projeto. O Eventarc pode acionar mensagens em um tópico do Pub/Sub, mudanças em um bucket do Cloud Storage e muito mais. Para mais informações, consulte Tipos de funções do Cloud Run.

Agendar a execução de uma função do Cloud Run é um caso de uso comum do Cloud Scheduler. Com este tutorial, você vai:

1. Crie uma função simples do Cloud Run em HTTP.
2. Crie um job do Cloud Scheduler.
3. Execute o job do Cloud Scheduler.
4. Verifique se o job do Cloud Scheduler aciona a função do Cloud Run.

Custos

Neste documento, você vai usar os seguintes componentes faturáveis do Google Cloud:

• Cloud Run
• Cloud Scheduler

Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços.

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.

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 Add another role and add each additional role.

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.

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 Add another role and add each additional role.

6. Click Continue.

7. Click Done to finish creating the service account.

É necessário conceder o papel de invocador do Cloud Run porque, nas funções do Cloud Run, as permissões de invocação estão disponíveis ao gerenciar o serviço do Cloud Run subjacente.

Funções exigidas

Para conseguir as permissões necessárias para concluir o tutorial, peça ao administrador para conceder a você os papéis do IAM a seguir no seu projeto:

• Desenvolvedor de origem do Cloud Run (roles/run.sourceDeveloper)
• Administrador do Cloud Scheduler (roles/cloudscheduler.admin)
• Acessador de exibição de registros (roles/logging.viewAccessor)
• Administrador de projetos do IAM (roles/resourcemanager.projectIamAdmin)
• Administrador da conta de serviço (roles/iam.serviceAccountAdmin)
• Usuário da conta de serviço (roles/iam.serviceAccountUser)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Conceder os papéis

Console

1. No console do Google Cloud , acesse a página IAM.

   Acessar o IAM
2. Selecione o projeto.
3. Clique em person_addCONCEDER ACESSO.

4. No campo Novos principais, digite seu identificador de usuário. Normalmente, esse é o endereço de e-mail da Conta do Google usado para implantar o serviço do Cloud Run.

5. Na lista Selecionar papel, escolha um.
6. Para conceder outros papéis, clique em add Adicionar outro papel e adicione cada papel adicional.
7. Clique em Salvar.

gcloud

Para conceder os papéis do IAM necessários à sua conta no projeto:

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

Substitua:

• PROJECT_NUMBER pelo número do projeto Google Cloud .
• PROJECT_ID com o Google Cloud ID do projeto.
• PRINCIPAL com a conta a que você está adicionando a vinculação. Normalmente, é o endereço de e-mail da Conta do Google usado para implantar o serviço do Cloud Run.
• ROLE com o papel que você está adicionando à conta do implantador.

Criar uma função do Cloud Run em HTTP

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

1. No console Google Cloud , acesse a página do Cloud Run.

   Acesse o Cloud Run

2. Clique em Escrever uma função.

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

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

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

      Se você precisa seguir uma política da organização de restrição de domínio que restringe invocações não autenticadas para seu projeto, será necessário acessar o serviço implantado, conforme descrito em Como testar serviços particulares.

      Para mais informações, consulte Autenticar para invocação.

4. Aceite todos os padrões e clique em Criar.

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

Criar um job do Cloud Scheduler

Crie um job do Cloud Scheduler que acione uma ação usando HTTP.

1. No console Google Cloud , acesse a página Cloud Scheduler.

   Acessar o Cloud Scheduler

2. Clique em add_box Criar job.

3. Insira um nome para o job.

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

5. Especifique a frequência do job usando um formato unix-cron:

   30 16 * * 7
   

   Para mais informações, consulte Formato de cron job 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, insira o URL HTTP da função que você copiou antes.

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

11. Na lista Conta de serviço, selecione a conta de serviço que você criou antes.

12. No campo Público, insira o URL HTTP da função que você copiou antes.

13. Clique em Criar.

Você criou um cron job que executa sua função do Cloud Run às 16h30 aos domingos.

Executar o job do Cloud Scheduler

Agora você pode executar o job que criou.

1. No console Google Cloud , acesse a página do Cloud Scheduler.

   Acessar o Cloud Scheduler

2. Marque a caixa de seleção do job que você criou e clique em Execução forçada.

   Na primeira vez que é invocado, o primeiro job criado em um projeto pode levar alguns minutos para ser configurado e executado.

3. Depois que o job for executado, o Status da última execução vai indicar Success.

Verificar os resultados nas funções do Cloud Run

É possível verificar se a função do Cloud Run foi acionada e executada corretamente pelo cron job.

1. No console Google Cloud , acesse a página do Cloud Run.

   Acesse o Cloud Run

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

3. Clique no nome da função.

   A página Detalhes do serviço é aberta e mostra as métricas do serviço.

4. Clique na guia Registros.

   Você vai encontrar uma entrada de registro semelhante a POST 200 146 B 5 ms Google-Cloud-Scheduler https://FUNCTION_NAME

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados no tutorial, exclua o projeto que os contém ou mantenha o projeto e exclua os recursos individuais.

Excluir projeto

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.

Excluir recursos do tutorial

1. No console Google Cloud , acesse a página Cloud Scheduler.

   Acessar o Cloud Scheduler

2. Clique na caixa de seleção que está próxima ao job.

3. Clique em delete Excluir e confirme a exclusão.

4. No console Google Cloud , acesse a página do Cloud Run.

   Acesse o Cloud Run

5. Marque a caixa de seleção ao lado do serviço.

6. Clique em delete Excluir e confirme a exclusão.

7. No console Google Cloud , acesse a página Contas de serviço.

   Acessar a página "Contas de serviço"

8. Marque a caixa de seleção ao lado da conta de serviço criada.

9. Clique em delete Excluir e confirme a exclusão.

A seguir

• Usar o Cloud Scheduler para acionar o Cloud Run em uma programação
• Escreva funções do CloudEvents para programar sua função para responder a eventos no projeto.