Environnement d'exécution Go

Votre fonction Cloud Run s'exécute dans un environnement composé d'une version de système d'exploitation avec des packages de modules complémentaires, de langages acceptés ainsi que de la bibliothèque du framework Functions Go qui prend en charge et appelle votre fonction. Cet environnement est identifié par la version de langage et est appelé l'ID d'exécution.

Préparation de la fonction

Vous pouvez préparer une fonction directement depuis la Google Cloud console, ou l'écrire sur votre ordinateur local et l'importer. Pour savoir comment préparer votre ordinateur local pour le développement Go, consultez Configurer un environnement de développement Go.

Environnements d'exécution Go et images de base compatibles

Sélectionner votre environnement d'exécution

Vous pouvez sélectionner l'un des environnements d'exécution Go compatibles pour votre fonction lors du déploiement.

Vous pouvez sélectionner une version d'environnement d'exécution à l'aide de la Google Cloud console ou de la gcloud CLI. Cliquez sur l'onglet correspondant pour obtenir des instructions sur l'utilisation de l'outil de votre choix :

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

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

Les fonctions Cloud Run écrites en Go doivent fournir toutes leurs 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 Configurer 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 suivant illustre un exemple d'accès contextuel par 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
}