Crea ed esegui il deployment di una funzione Cloud Functions HTTP con Go (1ª generazione.)

Questa guida illustra il processo di scrittura di una Cloud Function con il runtime Go. Esistono due tipi di funzioni Cloud Functions:

  • Una funzione HTTP, che richiami dalle richieste HTTP standard.
  • Una funzione basata su eventi, che utilizzi per gestire gli eventi dal tuo Cloud ad esempio i messaggi su un argomento Pub/Sub o le modifiche nel bucket Cloud Storage.

L'esempio mostra come creare una funzione HTTP semplice.

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Abilita le API Cloud Functions and Cloud Build.

    Abilita le API

    5.

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

    Go to project selector

  6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  7. Abilita le API Cloud Functions and Cloud Build.

    Abilita le API

    8.
  8. Installa e inizializza gcloud CLI.
  9. Aggiorna e installa i componenti di gcloud: 
    gcloud components update
  10. Prepara l'ambiente di sviluppo.

    Vai alla guida alla configurazione di Go .

Crea una funzione

  1. Crea una directory sul tuo sistema locale per il codice della funzione:

    Linux o Mac OS X

    mkdir ~/helloworld
cd ~/helloworld

    Windows

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

  2. Crea un file denominato hello_http.go in helloworld con il seguente contenuto:

    
// Package helloworld provides a set of Cloud Functions samples.
package helloworld

import (
	"encoding/json"
	"fmt"
	"html"
	"net/http"

	"github.com/GoogleCloudPlatform/functions-framework-go/functions"
)

func init() {
	functions.HTTP("HelloHTTP", HelloHTTP)
}

// HelloHTTP is an HTTP Cloud Function with a request parameter.
func HelloHTTP(w http.ResponseWriter, r *http.Request) {
	var d struct {
		Name string `json:"name"`
	}
	if err := json.NewDecoder(r.Body).Decode(&d); err != nil {
		fmt.Fprint(w, "Hello, World!")
		return
	}
	if d.Name == "" {
		fmt.Fprint(w, "Hello, World!")
		return
	}
	fmt.Fprintf(w, "Hello, %s!", html.EscapeString(d.Name))
}

    Questa funzione di esempio prende un nome fornito nella richiesta HTTP e restituisce un saluto o "Hello, World!" se non viene specificato alcun nome.

Specifica delle dipendenze

Questa funzione di esempio utilizza solo pacchetti di libreria Go standard, quindi non è necessario per dichiarare eventuali dipendenze oltre alla semplice importazione dei pacchetti.

Per le funzioni che richiedono dipendenze al di fuori della libreria standard, devi fornire le dipendenze tramite un file go.mod o un vendor . Per maggiori dettagli, leggi Specificare le dipendenze in Go.

esegui il deployment della funzione

Per eseguire il deployment della funzione con un trigger HTTP, esegui questo comando nella directory helloworld, specificando go113 o go111 come valore per il flag --runtime, a seconda della versione utilizzano:

gcloud functions deploy HelloHTTP --runtime go121 --trigger-http --allow-unauthenticated

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

testa la funzione

  1. Al termine del deployment della funzione, prendi nota del httpsTrigger.url o trovarla con il comando seguente:

    gcloud functions describe HelloHTTP

    Dovrebbe avere il seguente aspetto:

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

  2. Visita questo URL nel tuo browser o utilizza cURL eseguendo il comando:

    curl https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP

    Dovresti visualizzare il messaggio "Hello, World!". . Prova a trasmettere un nome nella richiesta HTTP eseguendo questo comando:

    curl -X POST https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP -H "Content-Type:application/json"  -d '{"name":"NAME"}'

    Dovresti visualizzare il messaggio "Ciao, NAME!".

Visualizza i log

I log per Cloud Functions sono visualizzabili utilizzando Google Cloud CLI e UI di Cloud Logging.

Utilizzare lo strumento a riga di comando

Per visualizzare i log per la tua funzione con gcloud CLI, utilizza il metodo Comando logs read seguito da il nome della funzione:

gcloud functions logs read HelloHTTP

L'output dovrebbe essere simile al seguente:

LEVEL  NAME        EXECUTION_ID  TIME_UTC                 LOG
D      HelloHTTP  buv9ej2k1a7r  2019-09-20 13:23:18.910  Function execution started
D      HelloHTTP  buv9ej2k1a7r  2019-09-20 13:23:18.913  Function execution took 4 ms, finished with status code: 200

Usa la dashboard di Logging

Puoi anche visualizzare i log per Cloud Functions dal Console Google Cloud.