Si vous créez une fonction, consultez le guide de démarrage rapide de la console sur Cloud Run. Le contenu de cette page ne s'applique qu'aux anciennes fonctions existantes créées avec l'API Cloud Functions v1.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Environnement d'exécution Go
Présentation
Votre fonction Cloud Run s'exécute dans un environnement composé d'une version de système d'exploitation, de packages complémentaires, d'une compatibilité avec les langages et de la bibliothèque du framework des fonctions compatible avec votre fonction.
Cet environnement est identifié par la version de langage et est appelé l'environnement d'exécution.
Pour en savoir plus sur les environnements d'exécution en général et découvrir la version d'Ubuntu utilisée par chaque environnement d'exécution Go, consultez la page Environnement d'exécution Cloud Run Functions.
Sélectionner votre environnement d'exécution
Cloud Run Functions est compatible avec plusieurs versions de Go, répertoriées sur la page Compatibilité des environnements d'exécution. Vous pouvez sélectionner l'environnement d'exécution Go pour votre fonction lors du déploiement.
gcloud
Si vous utilisez Google Cloud CLI, spécifiez l'environnement d'exécution à l'aide du paramètre --runtime avec l'environnement d'exécution Go de votre choix.
Exemple :
FLAGS... fait référence aux arguments transmis lors du premier déploiement de votre fonction. Pour en savoir plus sur les arguments obligatoires et facultatifs, consultez la section Déployer une fonction Cloud Run.
Vous pouvez préparer une fonction directement depuis la console Google Cloud , ou l'écrire sur votre ordinateur local et l'importer. Pour préparer votre machine locale au développement Go, consultez la section Configurer un environnement de développement Go.
Pour commencer à utiliser Go sur Cloud Run Functions rapidement, consultez le guide de démarrage rapide.
Structure du code source
Pour que Cloud Run Functions trouve la définition de votre fonction, votre code source doit respecter une structure spécifique. Pour en savoir plus, consultez la page Écrire des fonctions Cloud Run.
Spécifier des dépendances
Cloud Run Functions dans Go doit fournir toutes ses dépendances avec des modules Go et un fichier go.mod, ou avec un répertoire vendor. Pour plus d'informations, consultez la page Spécifier des dépendances en Go.
Variables d'environnement
Votre environnement d'exécution Go définit automatiquement certaines variables d'environnement pour que votre fonction puisse les utiliser si nécessaire. Pour en savoir plus, consultez la page Utiliser des variables d'environnement.
Type : Context
Le package context de Go définit le type de Context, qui contient des échéances, des signaux d'annulation et d'autres valeurs couvertes par les requêtes au-delà des limites de l'API et entre les processus.
Le code de fonction Cloud Run suivant illustre un exemple d'accès au contexte par 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}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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 }"]]