Se stai creando una nuova funzione, consulta la guida rapida della console su Cloud Run. I contenuti di questa pagina si applicano solo alle funzioni legacy esistenti create con l'API Cloud Functions v1.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Runtime di Go
Panoramica
La tua funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo più pacchetti aggiuntivi, supporto linguistico e la libreria Functions Framework che supporta e richiama la tua funzione.
Questo ambiente è identificato dalla versione della lingua ed è noto come
runtime.
Cloud Run Functions supporta diverse versioni di Go, elencate nella pagina
Supporto dei runtime. Puoi selezionare il runtime Go preferito per la tua funzione durante il deployment.
gcloud
Se utilizzi Google Cloud CLI, specifica il runtime
utilizzando il parametro --runtime con il runtime Go che preferisci.
Ad esempio:
FLAGS... si riferisce agli argomenti passati durante il primo
deployment della funzione. Per maggiori informazioni sugli argomenti obbligatori e
facoltativi, consulta
Deploy di una funzione Cloud Run.
Console
Se utilizzi la console Google Cloud , consulta la
guida rapida alla console per
istruzioni dettagliate.Google Cloud
Preparazione della funzione
Puoi preparare una funzione direttamente dalla console Google Cloud o scriverla sulla tua macchina locale e caricarla. Per preparare la tua macchina locale per lo sviluppo in Go,
vedi Configurazione di un ambiente di sviluppo Go.
Per iniziare rapidamente a utilizzare Go su Cloud Run Functions, consulta la
guida rapida.
Struttura del codice sorgente
Affinché le funzioni Cloud Run trovino la definizione della tua funzione, il codice sorgente deve seguire una struttura specifica. Per saperne di più, consulta
Scrittura di funzioni Cloud Run.
Specifica delle 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 ulteriori informazioni,
consulta Specificare 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
Utilizzare le variabili di ambiente.
Tipo di Context
Il pacchetto context di Go definisce il Context
tipo, che include scadenze, indicatori di annullamento e altri valori
ambito della richiesta tra i limiti delle API e tra i processi.
Il seguente codice delle funzioni Cloud Run mostra un esempio di accesso al contesto da parte di un
client Pub/Sub:
// Package helloworld provides a set of Cloud Functions samples.packagehelloworldimport("context""fmt""log""github.com/GoogleCloudPlatform/functions-framework-go/functions""github.com/cloudevents/sdk-go/v2/event")funcinit(){functions.CloudEvent("HelloPubSub",helloPubSub)}// MessagePublishedData contains the full Pub/Sub message// See the documentation for more details:// https://cloud.google.com/eventarc/docs/cloudevents#pubsubtypeMessagePublishedDatastruct{MessagePubSubMessage}// PubSubMessage is the payload of a Pub/Sub event.// See the documentation for more details:// https://cloud.google.com/pubsub/docs/reference/rest/v1/PubsubMessagetypePubSubMessagestruct{Data[]byte`json:"data"`}// helloPubSub consumes a CloudEvent message and extracts the Pub/Sub message.funchelloPubSub(ctxcontext.Context,eevent.Event)error{varmsgMessagePublishedDataiferr:=e.DataAs(&msg);err!=nil{returnfmt.Errorf("event.DataAs: %w",err)}name:=string(msg.Message.Data)// Automatically decoded from base64.ifname==""{name="World"}log.Printf("Hello, %s!",name)returnnil}
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[[["\u003cp\u003eCloud Run functions utilize a runtime environment that includes the operating system, language support, and the Functions Framework library.\u003c/p\u003e\n"],["\u003cp\u003eYou can choose a specific Go runtime version for your Cloud Run function during deployment, as listed in the Runtime support documentation.\u003c/p\u003e\n"],["\u003cp\u003eDependencies for Go Cloud Run functions must be provided via Go modules with a \u003ccode\u003ego.mod\u003c/code\u003e file or a \u003ccode\u003evendor\u003c/code\u003e directory.\u003c/p\u003e\n"],["\u003cp\u003eThe source code for Cloud Run functions needs to adhere to a defined structure to ensure the function's definition can be located correctly.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eContext\u003c/code\u003e type from Go's \u003ccode\u003econtext\u003c/code\u003e package is used within Cloud Run functions for managing deadlines, cancellation signals, and request-scoped values, as shown in the Pub/Sub example.\u003c/p\u003e\n"]]],[],null,["# The Go Runtime\n==============\n\nOverview\n--------\n\nYour Cloud Run function runs in an environment consisting of an operating\nsystem version plus add-on packages, language support, and\nthe Functions Framework library that supports and invokes your function.\nThis environment is identified by the language version, and is known as the\nruntime.\n\nFor information about runtimes in general, and to learn which Ubuntu version\neach Go runtime uses, see the\n[Cloud Run functions execution environment](/functions/1stgendocs/concepts/execution-environment#go).\n\nSelect your runtime\n-------------------\n\nCloud Run functions supports several versions of Go, listed on the\n[Runtime support](/functions/1stgendocs/runtime-support#go) page. You can\nselect the preferred Go runtime for your function during deployment. \n\n### gcloud\n\nIf you're using the Google Cloud CLI, specify the runtime\nby using the `--runtime` parameter with the Go runtime of your choice.\nFor example: \n\n```bash\ngcloud functions deploy FUNCTION_NAME --no-gen2 --runtime go121 FLAGS...\n```\n\n\u003cvar translate=\"no\"\u003eFLAGS\u003c/var\u003e`...` refers to arguments passed during the first\ndeployment of your function. For more information regarding required and\noptional arguments, see\n[Deploy a Cloud Run function](/functions/1stgendocs/deploy#basics).\n\n### Console\n\nIf you're using the Google Cloud console, see the\n[Google Cloud console quickstart](/functions/1stgendocs/console-quickstart-1st-gen) for\ndetailed instructions.\n\nFunction preparation\n--------------------\n\nYou can prepare a function directly from the Google Cloud console or write it on your\nlocal machine and upload it. To prepare your local machine for Go development,\nsee [Setting Up a Go Development Environment](/go/docs/setup).\n\nTo get started quickly with Go on Cloud Run functions, see the\n[Quickstart](/functions/1stgendocs/create-deploy-gcloud-1st-gen).\n\nSource code structure\n---------------------\n\nFor Cloud Run functions to find your function's definition, your\nsource code must follow a specific structure. See\n[Writing Cloud Run functions](/functions/1stgendocs/writing#structuring_source_code)\nfor more information.\n\nSpecifying dependencies\n-----------------------\n\nCloud Run functions in Go must provide all of their dependencies either with\nGo modules and a `go.mod` file, or with a `vendor` directory. For more information,\nsee [Specifying dependencies in Go](/functions/1stgendocs/writing/specifying-dependencies-go).\n\nEnvironment variables\n---------------------\n\nYour Go runtime automatically sets certain environment variables for your function\nto use as needed. For details, see\n[Using Environment Variables](/functions/1stgendocs/configuring/env-var#newer_runtimes).\n\n`Context` type\n--------------\n\n[Go's `context` package](https://golang.org/pkg/context/) defines the `Context`\ntype, which carries deadlines, cancellation signals, and other request-scoped\nvalues across API boundaries and between processes.\n\nThe following Cloud Run functions code shows an example of context access by a\nPub/Sub client: \n\n\n // Package helloworld provides a set of Cloud Functions samples.\n package helloworld\n\n import (\n \t\"context\"\n \t\"fmt\"\n \t\"log\"\n\n \t\"github.com/GoogleCloudPlatform/functions-framework-go/functions\"\n \t\"github.com/cloudevents/sdk-go/v2/event\"\n )\n\n func init() {\n \tfunctions.CloudEvent(\"HelloPubSub\", helloPubSub)\n }\n\n // MessagePublishedData contains the full Pub/Sub message\n // See the documentation for more details:\n // https://cloud.google.com/eventarc/docs/cloudevents#pubsub\n type MessagePublishedData struct {\n \tMessage PubSubMessage\n }\n\n // PubSubMessage is the payload of a Pub/Sub event.\n // See the documentation for more details:\n // https://cloud.google.com/pubsub/docs/reference/rest/v1/PubsubMessage\n type PubSubMessage struct {\n \tData []byte `json:\"data\"`\n }\n\n // helloPubSub consumes a CloudEvent message and extracts the Pub/Sub message.\n func helloPubSub(ctx context.Context, e event.Event) error {\n \tvar msg MessagePublishedData\n \tif err := e.DataAs(&msg); err != nil {\n \t\treturn fmt.Errorf(\"event.DataAs: %w\", err)\n \t}\n\n \tname := string(msg.Message.Data) // Automatically decoded from base64.\n \tif name == \"\" {\n \t\tname = \"World\"\n \t}\n \tlog.Printf(\"Hello, %s!\", name)\n \treturn nil\n }"]]