Criar uma função do Cloud Run de primeira geração usando a CLI do Google Cloud

Criar uma função do Cloud Run de primeira geração usando a CLI do Google Cloud

Observação: este conteúdo se aplica apenas às funções do Cloud Run (1a geração), anteriormente Cloud Functions (1a geração).

Para a versão do Cloud Run functions deste documento, consulte Criar e implantar uma função do Cloud Run.

Nesta página, mostramos como criar e implantar uma função do Cloud Run da primeira geração usando a CLI do Google Cloud.

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.

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

5. 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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

8. Instale e inicialize a gcloud CLI.
9. Atualize os componentes gcloud:

   gcloud components update

Precisa de um prompt de comando? Use o Google Cloud Shell. O Google Cloud Shell é um ambiente de linha de comando que já inclui a Google Cloud CLI. Portanto, não é necessário instalá-lo. A Google Cloud CLI também vem pré-instalado em máquinas virtuais do Google Compute Engine.

10. Prepare seu ambiente de desenvolvimento.

    Node.js

    Acessar o guia de configuração do Node.js

    Python

    Acessar o guia de configuração do Python

    Go

    Acessar o guia de configuração do Go

    Java

    Acessar o guia de configuração do Java

    C#

    Acessar o guia de configuração do .NET

    Ruby

    Acessar o guia de configuração do Ruby

    PHP

    Acessar "Como usar o PHP no Google Cloud"

Como obter o código de amostra

1. Clone o repositório de amostra na máquina local:

   Node.js

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

   Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

   Python

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

   Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

   Go

   git clone https://github.com/GoogleCloudPlatform/golang-samples.git

   Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

   Java

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git

   Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

   C#

   git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git

   Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

   Ruby

   git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git

   Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

   PHP

   git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git

   Outra alternativa é fazer o download da amostra como um arquivo ZIP e extraí-lo.

2. Mude para o diretório que contém o código de amostra das funções do Cloud Run:

   Node.js

   cd nodejs-docs-samples/functions/helloworld/

   Python

   cd python-docs-samples/functions/helloworld/

   Go

   cd golang-samples/functions/helloworld/

   Java

   cd java-docs-samples/functions/helloworld/helloworld/

   C#

   cd dotnet-docs-samples/functions/helloworld/HelloWorld/

   Ruby

   cd ruby-docs-samples/functions/helloworld/get/

   PHP

   cd php-docs-samples/functions/helloworld_get/

3. Confira o código de amostra:

   Node.js

   const functions = require('@google-cloud/functions-framework');
   
   // Register an HTTP function with the Functions Framework that will be executed
   // when you make an HTTP request to the deployed function's endpoint.
   functions.http('helloGET', (req, res) => {
     res.send('Hello World!');
   });

   Python

   import functions_framework
   
   @functions_framework.http
   def hello_get(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>.
       Note:
           For more information on how Flask integrates with Cloud
           Functions, see the `Writing HTTP functions` page.
           <https://cloud.google.com/functions/docs/writing/http#http_frameworks>
       """
       return "Hello World!"
   
   

   Go

   
   // Package helloworld provides a set of Cloud Functions samples.
   package helloworld
   
   import (
   	"fmt"
   	"net/http"
   )
   
   // HelloGet is an HTTP Cloud Function.
   func HelloGet(w http.ResponseWriter, r *http.Request) {
   	fmt.Fprint(w, "Hello, World!")
   }
   

   Java

   
   package functions;
   
   import com.google.cloud.functions.HttpFunction;
   import com.google.cloud.functions.HttpRequest;
   import com.google.cloud.functions.HttpResponse;
   import java.io.BufferedWriter;
   import java.io.IOException;
   
   public class HelloWorld implements HttpFunction {
     // Simple function to return "Hello World"
     @Override
     public void service(HttpRequest request, HttpResponse response)
         throws IOException {
       BufferedWriter writer = response.getWriter();
       writer.write("Hello World!");
     }
   }

   C#

   using Google.Cloud.Functions.Framework;
   using Microsoft.AspNetCore.Http;
   using System.Threading.Tasks;
   
   namespace HelloWorld;
   
   public class Function : IHttpFunction
   {
       public async Task HandleAsync(HttpContext context)
       {
           await context.Response.WriteAsync("Hello World!", context.RequestAborted);
       }
   }

   Ruby

   require "functions_framework"
   
   FunctionsFramework.http "hello_get" do |_request|
     # The request parameter is a Rack::Request object.
     # See https://www.rubydoc.info/gems/rack/Rack/Request
   
     # Return the response body as a string.
     # You can also return a Rack::Response object, a Rack response array, or
     # a hash which will be JSON-encoded into a response.
     "Hello World!"
   end

   PHP

   
   use Psr\Http\Message\ServerRequestInterface;
   
   function helloGet(ServerRequestInterface $request): string
   {
       return 'Hello, World!' . PHP_EOL;
   }
   

Implantar uma função

Para implantar a função com um gatilho HTTP, execute o seguinte comando no diretório que contém a função:

Node.js

gcloud functions deploy helloGET \
--runtime nodejs22 --trigger-http

Use a flag --runtime para especificar o ID do ambiente de execução de uma versão do Node.js compatível a fim de executar a função.

Python

gcloud functions deploy hello_get \
--runtime python312 --trigger-http

Use a flag --runtime para especificar o ID do ambiente de execução de uma versão compatível do Python a fim de executar a função.

Go

gcloud functions deploy HelloGet \
--runtime go122 --trigger-http

Use a flag --runtime para especificar o ID do ambiente de execução de uma versão do Go compatível a fim de executar a função.

Java

gcloud functions deploy java-helloworld \
--entry-point functions.HelloWorld \
--runtime java21 \
--memory 512MB --trigger-http

Use a flag --runtime para especificar o ID do ambiente de execução de uma versão compatível do Java a fim de executar a função.

C#

gcloud functions deploy csharp-helloworld \
--entry-point HelloWorld.Function \
--runtime dotnet8 --trigger-http

Use a flag --runtime para especificar o ID do ambiente de execução de uma versão do .NET compatível a fim de executar a função.

Ruby

gcloud functions deploy hello_get --runtime ruby33 --trigger-http

Use a flag --runtime para especificar o ID do ambiente de execução de uma versão compatível do Ruby a fim de executar a função.

PHP

 gcloud functions deploy helloGet --runtime php83 --trigger-http

Use a flag --runtime para especificar o ID do ambiente de execução de uma versão do PHP compatível a fim de executar a função.

Também é possível usar a sinalização --allow-unauthenticated para alcançar a função sem autenticação. Isso é útil para testes, mas não recomendamos usar essa configuração em produção, a menos que você esteja criando uma API ou um site público. Além disso, talvez ela não funcione para você, dependendo das configurações da política corporativa. Consulte Como autenticar para invocação para detalhes sobre como invocar uma função que requer autenticação.

teste a função

1. Quando a implantação da função for concluída, anote o url de httpsTrigger ou encontre-o usando o seguinte comando:

   Node.js

   gcloud functions describe helloGET --format="value(httpsTrigger.url)"

   Python

   gcloud functions describe hello_get --format="value(httpsTrigger.url)"

   Go

   gcloud functions describe HelloGet --format="value(httpsTrigger.url)"

   Java

   gcloud functions describe java-helloworld --format="value(httpsTrigger.url)"

   C#

   gcloud functions describe csharp-helloworld --format="value(httpsTrigger.url)"

   Ruby

   gcloud functions describe hello_get --format="value(httpsTrigger.url)"

   PHP

   gcloud functions describe helloGet --format="value(httpsTrigger.url)"

   Você verá o seguinte:

   Node.js

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

   Python

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

   Go

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

   Java

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/java-helloworld

   C#

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/csharp-helloworld

   Ruby

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

   PHP

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

2. Visite este URL no navegador. Você verá uma mensagem Hello World!.

Excluir a função

Para excluir a função, execute o seguinte comando:

Node.js

gcloud functions delete helloGET 

Python

gcloud functions delete hello_get 

Go

gcloud functions delete HelloGet 

Java

gcloud functions delete java-helloworld 

C#

gcloud functions delete csharp-helloworld 

Ruby

gcloud functions delete hello_get 

PHP

gcloud functions delete helloGet 

A seguir

Consulte o guia Sua primeira função relevante do ambiente de execução de sua escolha para saber como configurar o ambiente de desenvolvimento, criar uma nova função a partir do zero, especificar dependências, implantar a função. testar a função e ver os registros. Estes guias são apenas para o Cloud Run functions (1ª geração):

• Sua primeira função: Node.js
• Sua primeira função: Python
• Sua primeira função: Go
• Sua primeira função: Java
• Sua primeira função: .NET
• Sua primeira função: Ruby
• Sua primeira função: PHP