Crea ed esegui il deployment di una funzione Cloud Functions (1a generazione) utilizzando l'interfaccia a riga di comando di Google Cloud

Guida rapida: creazione e deployment di una funzione Cloud Functions (1a generazione) utilizzando l'interfaccia a riga di comando di Google Cloud

Crea ed esegui il deployment di una funzione Cloud Functions (1a generazione) utilizzando l'interfaccia a riga di comando di Google Cloud

Questa pagina mostra come creare e sottoporre a deployment una funzione Cloud Functions di 1a generazione utilizzando l'interfaccia a riga di comando di Google Cloud. Per iniziare a utilizzare Cloud Functions (2a generazione), consulta il tutorial introduttivo su Cloud Functions (2a generazione).

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

   Nota: se non hai intenzione di conservare le risorse che crei in questa procedura, crea un progetto anziché selezionarne uno esistente. Al termine di questi passaggi, puoi eliminare il progetto rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

4. Abilita le API Cloud Functions and Cloud Build.

   Abilita le API

5. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

   Nota: se non hai intenzione di conservare le risorse che crei in questa procedura, crea un progetto anziché selezionarne uno esistente. Al termine di questi passaggi, puoi eliminare il progetto rimuovendo tutte le risorse associate.

   Vai al selettore progetti

6. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

7. Abilita le API Cloud Functions and Cloud Build.

   Abilita le API

8. Installa e inizializza l'interfaccia a riga di comando gcloud.
9. Aggiorna i componenti gcloud:

   gcloud components update

Hai bisogno di un prompt dei comandi? Puoi utilizzare Google Cloud Shell. Google Cloud Shell è un ambiente a riga di comando che include già l'interfaccia a riga di comando di Google Cloud, quindi non è necessario installarlo. L'interfaccia a riga di comando di Google Cloud è preinstallata anche sulle macchine virtuali di Google Compute Engine.

10. Prepara l'ambiente di sviluppo.

    Node.js

    Vai alla guida alla configurazione di Node.js

    Python

    Vai alla guida alla configurazione di Python

    Go

    Vai alla guida alla configurazione di Go

    Java

    Vai alla guida alla configurazione di Java

    C#

    Vai alla guida alla configurazione di .NET

    Ruby

    Vai alla guida alla configurazione di Ruby

    PHP

    Vai a Utilizzo di PHP su Google Cloud

Recupera il codice campione

1. Clona il repository di esempio sul tuo computer locale:

   Node.js

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

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

   Python

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

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

   Go

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

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

   Java

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

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

   C#

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

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

   Ruby

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

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

   PHP

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

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

2. Passa alla directory che contiene il codice campione di Cloud Functions:

   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. Dai un'occhiata al codice di esempio:

   Node.js

   Functions/helloworld/index.js

   Visualizza su GitHub Feedback

   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

   Functions/helloworld/main.py

   Visualizza su GitHub Feedback

   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

   Functions/helloworld/hello_world.go

   Visualizza su GitHub Feedback

   
   // 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

   Functions/helloworld/helloworld/src/main/java/functions/HelloWorld.java

   Visualizza su GitHub Feedback

   
   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#

   Functions/helloworld/HelloWorld/Function.cs

   Visualizza su GitHub Feedback

   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!");
           }
       }
   }

   Ruby

   Functions/helloworld/get/app.rb

   Visualizza su GitHub Feedback

   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

   Functions/helloworld_get/index.php

   Visualizza su GitHub Feedback

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

Esegui il deployment di una funzione

Per il deployment della funzione con un trigger HTTP, esegui il comando seguente nella directory contenente la funzione:

Node.js

gcloud functions deploy helloGET \
--runtime nodejs16 --trigger-http --allow-unauthenticated

Per specificare la versione di Node.js preferita, puoi utilizzare i seguenti valori per il flag --runtime:

• nodejs16 (consigliato)
• nodejs14
• nodejs12
• nodejs10

Python

gcloud functions deploy hello_get \
--runtime python39 --trigger-http --allow-unauthenticated

Puoi utilizzare i seguenti valori per il flag --runtime per specificare la tua versione di Python preferita:

• python310 (anteprima)
• python39 (consigliato)
• python38
• python37

Go

gcloud functions deploy HelloGet \
--runtime go116 --trigger-http --allow-unauthenticated

Puoi utilizzare i seguenti valori per il flag --runtime per specificare la tua versione Go preferita:

• go116 (consigliato)
• go113
• go111

Java

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

Puoi utilizzare i seguenti valori per il flag --runtime per specificare la tua versione di Java preferita:

• java17 (anteprima)
• java11 (consigliato)

C#

gcloud functions deploy csharp-helloworld \
--entry-point HelloWorld.Function \
--runtime dotnet3 --trigger-http --allow-unauthenticated

Ruby

gcloud functions deploy hello_get --runtime ruby30 --trigger-http --allow-unauthenticated

Per specificare la versione di Ruby preferita, puoi utilizzare i seguenti valori per il flag --runtime:

• ruby30 (consigliato)
• ruby27
• ruby26

PHP

gcloud functions deploy helloGet --runtime php74 --trigger-http --allow-unauthenticated

Puoi utilizzare i seguenti valori per il flag --runtime per specificare la tua versione PHP preferita:

• php81 (anteprima)
• php74 (consigliato)

Il flag --allow-unauthenticated ti consente di raggiungere la funzione senza autenticazione. Per richiedere l'autenticazione, ometti il flag.

Testa la funzione

1. Al termine del deployment della funzione, prendi nota della proprietà httpsTrigger's url o individuala utilizzando il seguente comando:

   Node.js

   gcloud functions describe helloGET

   Python

   gcloud functions describe hello_get

   Go

   gcloud functions describe HelloGet

   Java

   gcloud functions describe java-helloworld

   C#

   gcloud functions describe csharp-helloworld

   Ruby

   gcloud functions describe hello_get

   PHP

   gcloud functions describe helloGet

   Dovrebbe avere questo aspetto:

   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. Visita questo URL nel tuo browser. Dovresti vedere un messaggio Hello World!.

Elimina la funzione

Per eliminare la funzione, esegui il comando seguente:

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 

Passaggi successivi

• Scopri di più sulla scrittura di funzioni Cloud.
• Scopri di più sul deployment di Cloud Functions.
• Scopri di più sulle chiamate alle funzioni Cloud.
• Scopri di più sul monitoraggio delle funzioni Cloud Functions.
• Scopri di più sull'esecuzione locale di Cloud Functions.
• Esplora i tutorial più avanzati di Cloud Functions.