Tutorial su HTTP

Questo semplice tutorial mostra la scrittura, il deployment e l'attivazione di una funzione Cloud HTTP.

Obiettivi

  • Tutto il necessario per la scrittura, il deployment e l'attivazione di una funzione Cloud HTTP.

Costi

Questo tutorial utilizza i seguenti componenti fatturabili di Google Cloud:

  • Cloud Functions

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud possono beneficiare di una prova gratuita.

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.

    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. Installa e inizializza l'interfaccia a riga di comando di Google Cloud.

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

    Vai al selettore progetti

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

  8. Abilita le API Cloud Functions and Cloud Build.

    Abilita le API

  9. Installa e inizializza l'interfaccia a riga di comando di Google Cloud.

    10. Se hai già installato l'interfaccia a riga di comando gcloud, aggiornala eseguendo il comando seguente:

    gcloud components update
  10. Prepara l'ambiente di sviluppo.

Preparazione dell'applicazione

  1. Clonare il repository dell'app di esempio sul 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 di esempio 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/

    PHP 

    cd php-docs-samples/functions/helloworld_get/

  3. Dai un'occhiata al codice di esempio:

    Node.js

    Functions/helloworld/index.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

    Functions/helloworld/main.py 
    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 
    
// 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 
    
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 
    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 
    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 
    
use Psr\Http\Message\ServerRequestInterface;

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

Deployment della funzione

Per eseguire il deployment della funzione con un trigger HTTP, esegui il seguente comando nella directory che contiene il codice di esempio (o, nel caso di Java, il file pom.xml):

Node.js 

gcloud functions deploy helloGET \
--runtime nodejs16 --trigger-http --allow-unauthenticated
Puoi utilizzare i seguenti valori per il flag --runtime per specificare la versione Node.js preferita:
  • 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 versione Python preferita:
  • 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 versione Go preferita:
  • go116 (consigliato)
  • go113
  • go111

Java 

gcloud functions deploy java-http-function \
--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-http-function \
--entry-point HelloWorld.Function \
--runtime dotnet3 --trigger-http --allow-unauthenticated

Ruby 

gcloud functions deploy hello_get --runtime ruby27 --trigger-http --allow-unauthenticated
Puoi utilizzare i seguenti valori per il flag --runtime per specificare la versione Ruby preferita:
  • ruby30 (anteprima)
  • ruby27 (consigliato)
  • ruby26

PHP 

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

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

Attivazione della funzione

Per inviare una richiesta HTTP alla funzione, esegui il comando seguente:

Node.js 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/helloGET"

Python 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/hello_get"

Go 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/HelloGet"

Java 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/java-http-function"

C# 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/csharp-http-function"

Ruby 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/hello_get"

PHP 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/helloGet"

dove

  • REGION è l'area geografica in cui viene eseguito il deployment della funzione. È visibile nel terminale quando termina il deployment della funzione.
  • PROJECT_ID è l'ID progetto Cloud. È visibile nel terminale quando la funzione termina il deployment.

Puoi anche visitare l'endpoint della funzione di cui hai eseguito il deployment nel browser per vedere il messaggio "Hello World!".

Esegui la pulizia

Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è eliminare il progetto che hai creato per il tutorial.

Per eliminare il progetto:

  1. In Cloud Console, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto da eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Eliminazione della funzione Cloud

L'eliminazione di Cloud Functions non rimuove le risorse archiviate in Cloud Storage.

Per eliminare la Funzione Cloud creata in questo tutorial, 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-http-function

C# 

gcloud functions delete csharp-http-function

Ruby 

gcloud functions delete hello_get

PHP 

gcloud functions delete helloGet

Puoi anche eliminare Cloud Functions da Google Cloud Console.