Il runtime di Go

La tua funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo con pacchetti aggiuntivi, supporto dei linguaggi e la libreria del framework di Functions per Go che supporta e richiama la tua funzione. Questo ambiente è identificato dalla versione del linguaggio ed è noto come ID runtime.

Preparazione della funzione

Puoi preparare una funzione direttamente dalla console Google Cloud , oppure puoi scriverla sulla tua macchina locale e caricarla. Per preparare la macchina locale per lo sviluppo con Go, consulta Configurazione di un ambiente di sviluppo Go.

Runtime Go e immagini di base supportati

Runtime	ID runtime	Stack	Immagine di base runtime
Go 1.26 (anteprima)	go126	google-24 (predefinito) google-24-full	google-24/go126 google-24-full/go126
Go 1.25	go125	google-22 (predefinito) google-22-full	google-22/go125 google-22-full/go125
Go 1.24	go124	google-22 (predefinito) google-22-full	google-22/go124 google-22-full/go124
Go 1.23	go123	google-22 (predefinito) google-22-full	google-22/go123 google-22-full/go123
Go 1.22	go122	google-22 (predefinito) google-22-full	google-22/go122 google-22-full/go122
Go 1.21	go121	google-22 (predefinito) google-22-full	google-22/go121 google-22-full/go121
Go 1.20	go120	google-22 (predefinito) google-22-full	google-22/go120 google-22-full/go120
Go 1.19	go119	google-22 (predefinito) google-22-full	google-22/go119 google-22-full/go119
Go 1.18	go118	google-22 (predefinito) google-22-full	google-22/go118 google-22-full/go120
Go 1.16	go116	google-18-full	google-18-full/go116
Go 1.13	go113	google-18-full	google-18-full/go113
Go 1.11	go111	Dismesso	Dismesso

Nota: la policy di rilascio di Go prevede che ogni release principale di Go sia supportata finché non vengono rilasciate due nuove release principali. Pertanto, a seconda di quando le versioni più recenti di Go vengono rese pubblicamente disponibili, le date chiave come quella di fine del supporto, di ritiro e di dismissione potrebbero essere posticipate.

Seleziona il runtime

Puoi selezionare uno dei runtime Go supportati per la tua funzione durante il deployment.

Puoi selezionare una versione del runtime utilizzando la console Google Cloud o gcloud CLI. Fai clic sulla scheda per visualizzare le istruzioni sull'utilizzo dello strumento che preferisci:

gcloud

Specifica l'immagine di base Go per la tua funzione utilizzando il flag --base-image durante il deployment della funzione. Ad esempio:

gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image go125

Sostituisci:

• FUNCTION con il nome della funzione di cui stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome se lo ometti.

• FUNCTION_ENTRYPOINT con l'entry point della funzione nel codice sorgente. Questo è il codice che Cloud Run esegue quando viene eseguita la funzione. Il valore di questo flag deve essere un nome di funzione o un nome di classe completo esistente nel codice sorgente.

Per istruzioni dettagliate sul deployment di una funzione utilizzando gcloud CLI, consulta Esegui il deployment di funzioni in Cloud Run.

Console

Puoi selezionare una versione del runtime quando crei o aggiorni una funzione Cloud Run nella console Google Cloud . Per istruzioni dettagliate sul deployment di una funzione, consulta Esegui il deployment di funzioni in Cloud Run.

Per selezionare un runtime nella console Google Cloud quando crei una funzione:

1. Nella console Google Cloud , vai alla pagina Cloud Run:

   Vai a Cloud Run

2. Fai clic su Scrivi una funzione.

3. Nell'elenco Runtime, seleziona una versione del runtime Go.

4. Fai clic su Crea e attendi che Cloud Run crei il servizio utilizzando una revisione segnaposto.

5. La console ti reindirizzerà alla scheda Origine, dove potrai visualizzare il codice sorgente della funzione. Fai clic su Salva e ridistribuisci.

Per istruzioni dettagliate sull'aggiornamento della versione del runtime dopo il deployment della funzione, consulta Eseguire nuovamente il deployment del nuovo codice sorgente.

Struttura del codice sorgente

Affinché Cloud Run Functions trovi la definizione della tua funzione, il codice sorgente deve seguire una struttura specifica. Per saperne di più, consulta Scrivi funzioni Cloud Run.

Specifica le dipendenze

Le funzioni Cloud Run in Go devono fornire tutte le dipendenze con i moduli Go e un file go.mod o con una directory vendor. Per saperne di più, consulta Specifica le dipendenze in Go.

Variabili di ambiente

Il runtime Go imposta automaticamente alcune variabili di ambiente che la tua funzione può utilizzare in base alle esigenze. Per maggiori dettagli, vedi Configurare le variabili di ambiente.

Tipo di Context

Il pacchetto context di Go definisce il tipo di Context, che contiene scadenze, indicatori di annullamento e altri valori relativi alla richiesta tra i limiti dell'API e tra i processi.

Il seguente codice mostra un esempio di accesso al contesto da parte di un client Pub/Sub:

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

import (
	"context"
	"fmt"
	"log"

	"github.com/GoogleCloudPlatform/functions-framework-go/functions"
	"github.com/cloudevents/sdk-go/v2/event"
)

func init() {
	functions.CloudEvent("HelloPubSub", helloPubSub)
}

// MessagePublishedData contains the full Pub/Sub message
// See the documentation for more details:
// https://cloud.google.com/eventarc/docs/cloudevents#pubsub
type MessagePublishedData struct {
	Message PubSubMessage
}

// PubSubMessage is the payload of a Pub/Sub event.
// See the documentation for more details:
// https://cloud.google.com/pubsub/docs/reference/rest/v1/PubsubMessage
type PubSubMessage struct {
	Data []byte `json:"data"`
}

// helloPubSub consumes a CloudEvent message and extracts the Pub/Sub message.
func helloPubSub(ctx context.Context, e event.Event) error {
	var msg MessagePublishedData
	if err := e.DataAs(&msg); err != nil {
		return fmt.Errorf("event.DataAs: %w", err)
	}

	name := string(msg.Message.Data) // Automatically decoded from base64.
	if name == "" {
		name = "World"
	}
	log.Printf("Hello, %s!", name)
	return nil
}