Crie e implemente uma função HTTP do Cloud Run com Python (1.ª geração)

Este guia explica o processo de escrita de uma função do Cloud Run usando o tempo de execução do Python. Existem dois tipos de funções do Cloud Run:

• Uma função HTTP, que invoca a partir de pedidos HTTP padrão.
• Uma função orientada por eventos, que usa para processar eventos da sua infraestrutura do Google Cloud, como mensagens num tópico Pub/Sub ou alterações num contentor do Cloud Storage.

O exemplo mostra como criar uma função HTTP simples.

Saiba mais: para mais detalhes, leia acerca das funções HTTP e das funções orientadas por eventos.

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.

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.

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 Functions and Cloud Build 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

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.

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 Functions and Cloud Build 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

1. Instale e inicialize a CLI gcloud.
2. Atualize e instale os componentes do gcloud:

   gcloud components update

Nota: precisa de uma linha de comandos? Pode usar o Google Cloud Shell. O Google Cloud Shell é um ambiente de linha de comandos que já inclui a CLI Google Cloud, pelo que não precisa de a instalar. A CLI do Google Cloud também está pré-instalada nas máquinas virtuais do Google Compute Engine.
3. Prepare o seu ambiente de desenvolvimento.

   Aceda ao guia de configuração do Python

Crie uma função

1. Crie um diretório no seu sistema local para o código da função:

   Linux ou Mac OS X

   mkdir ~/helloworld
   cd ~/helloworld
   

   Windows

   mkdir %HOMEPATH%\helloworld
   cd %HOMEPATH%\helloworld
   

2. Crie um ficheiro main.py no diretório helloworld com o seguinte conteúdo:

   
   import functions_framework
   
   
   from markupsafe import escape
   
   @functions_framework.http
   def hello_http(request):
       """HTTP Cloud Function.
       Args:
           request (flask.Request): The request object.
           <https://flask.palletsprojects.com/en/1.1.x/api/#incoming-request-data>
       Returns:
           The response text, or any set of values that can be turned into a
           Response object using `make_response`
           <https://flask.palletsprojects.com/en/1.1.x/api/#flask.make_response>.
       """
       request_json = request.get_json(silent=True)
       request_args = request.args
   
       if request_json and "name" in request_json:
           name = request_json["name"]
       elif request_args and "name" in request_args:
           name = request_args["name"]
       else:
           name = "World"
       return f"Hello {escape(name)}!"
   
   

   Esta função de exemplo recebe um nome fornecido no pedido HTTP e devolve uma saudação ou "Olá, mundo!" quando não é fornecido nenhum nome.

   Nota: as funções do Cloud Run procuram funções implementáveis em main.py por predefinição. Use a flag --source quando implementar a sua função através do gcloud para especificar um diretório diferente que contenha um ficheiro main.py.

Especifique dependências

As dependências em Python são geridas com o pip e expressas num ficheiro de metadados denominado requirements.txt. Este ficheiro tem de estar no mesmo diretório que o ficheiro main.py que contém o código da função.

Não precisa de criar um requirements.txt para executar este exemplo específico, mas suponhamos que quer adicionar as suas próprias dependências. Veja como o fazer:

1. Crie um ficheiro requirements.txt no diretório helloworld.

2. Adicione a dependência da função ao ficheiro requirements.txt, por exemplo:

   # An example requirements file, add your dependencies below
   sampleproject==2.0.0
   

Saiba mais: para mais detalhes, leia sobre como especificar dependências.

Implemente a função

Para implementar a função com um acionador HTTP, execute o seguinte comando no diretório helloworld:

gcloud functions deploy hello_http --no-gen2 --runtime python312 --trigger-http --allow-unauthenticated

A flag --allow-unauthenticated permite-lhe aceder à função sem autenticação. Para exigir a autenticação, omita a flag.

Saiba mais: para mais detalhes, leia sobre a implementação de funções do Cloud Run.

Teste a função

1. Quando a implementação da função terminar, tome nota da propriedade httpsTrigger.url ou encontre-a através do seguinte comando:

   gcloud functions describe hello_http
   

   Deve ter esta forma:

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_http

2. Visite este URL no seu navegador. Deverá ver a mensagem "Hello World!".

   Experimente transmitir um nome no pedido HTTP, por exemplo, usando o seguinte URL:

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_http?name=NAME

   Deverá ver a mensagem "Olá NAME!"

Ver registos

Os registos das funções do Cloud Run são visíveis através da CLI gcloud e na IU do Cloud Logging.

Use a ferramenta de linha de comandos

Para ver os registos da sua função com a CLI gcloud, use o comando logs read, seguido do nome da função:

gcloud functions logs read hello_http

O resultado deve ser semelhante ao seguinte:

LEVEL  NAME        EXECUTION_ID  TIME_UTC                 LOG
D      hello_http  pdb5ys2t022n  2019-09-18 23:29:09.791  Function execution started
D      hello_http  pdb5ys2t022n  2019-09-18 23:29:09.798  Function execution took 7 ms, finished with status code: 200

Nota: normalmente, existe um ligeiro atraso entre o momento em que as entradas do registo são criadas e o momento em que são apresentadas no Cloud Logging.

Use o painel de controlo de registo

Também pode ver os registos das funções do Cloud Run a partir da Google Cloud consola.

Saiba mais: para mais detalhes, leia sobre como escrever, ver e responder a registos.