programar uma função HTTP do Cloud Run

Neste tutorial, mostramos como acionar uma função HTTP do Cloud Run usando Cloud Scheduler e ao direcionar para um endpoint HTTP. Use uma função HTTP a função precisa ter um endpoint de URL e responder a solicitações HTTP, como quanto aos webhooks.

Também é possível programe uma função orientada a eventos quando sua função deve ser acionada diretamente em resposta a eventos em sua projeto do Google Cloud, como mensagens em um tópico do Pub/Sub ou alterações em um do bucket do Cloud Storage. Para mais informações, consulte Tipos de funções do Cloud Run.

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

1. Criar uma função HTTP simples do Cloud Run.
2. Criar um job do Cloud Scheduler.
3. executar o job do Cloud Scheduler;
4. Verifique se a função do Cloud Run foi acionada pelo Job do Cloud Scheduler.

Custos

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

• Cloud Run functions
• Cloud Scheduler

Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços. Novos usuários do Google Cloud podem estar qualificados para uma avaliação gratuita.

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.

   Go to project selector

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

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

   Enable the APIs

5. 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 Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

   6. Click Continue.

   7. Click Done to finish creating the service account.

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

   Go to project selector

7. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

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

   Enable the APIs

9. 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 Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

   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 (2ª geração), as permissões de invocação estão disponíveis ao gerenciar o serviço subjacente do Cloud Run.

10. Por padrão, as funções do Cloud Run usam o conta de serviço padrão do Compute Engine para a conta de serviço do ambiente de execução. Use essa conta de serviço para testar neste tutorial. No entanto, dependendo da configuração da política da organização, os conta de serviço padrão pode não receber automaticamente o papel de Editor seu projeto. Se esse for o caso, você deve conceder à conta de serviço os seguintes papéis:
    1. Gravador do Artifact Registry (roles/artifactregistry.writer)
    2. Gravador de registros (roles/logging.logWriter)
    3. Leitor de objetos do Storage (roles/storage.objectViewer)

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 do Google Cloud, acesse a página do 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 exclusão.

4. No console do Google Cloud, acesse a página das funções do Cloud Run.

   Acessar as funções do Cloud Run

5. Marque a caixa de seleção ao lado da função.

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

7. No Console do 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 que você criou.

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

A seguir

• Usar o Cloud Scheduler para acionar o Cloud Run em uma programação