Entorno de ejecución de Go

Tu función de Cloud Run se ejecuta en un entorno que consta de una versión del sistema operativo con paquetes de complementos, compatibilidad con lenguajes y la biblioteca de Go Functions Framework que admite e invoca la función. Este entorno se identifica mediante la versión del lenguaje y se conoce como el ID del entorno de ejecución.

Preparación de funciones

Puedes preparar una función directamente desde la consola de Google Cloud o escribirla en tu máquina local y subirla. Para preparar tu máquina local para el desarrollo en Go, consulta Configura un entorno de desarrollo de Go.

Selecciona tu entorno de ejecución

Las funciones de Cloud Run admiten varias versiones de Go, que se enumeran en la página Entornos de ejecución y las imágenes base de lenguajes compatibles. Puedes seleccionar el entorno de ejecución de Go que prefieras para tu función durante la implementación.

gcloud

Para usar funciones de Cloud Run para implementar una función HTTP con gcloud CLI, consulta Implementa con Google Cloud CLI.

Console

Si usas la consola de Google Cloud, selecciona el entorno de ejecución cuando creas y cuando implementas tu función. Consulta la guía de inicio rápido de la consola de Google Cloud para obtener instrucciones detalladas.

Estructura del código fuente

Para que Cloud Run Functions encuentre la definición de tu función, tu código fuente debe seguir una estructura específica. Consulta Escribe funciones de Cloud Run para obtener más información.

Especificar dependencias

Las funciones de Cloud Run en Go deben proporcionar todas sus dependencias con módulos de Go y un archivo go.mod o con un directorio vendor. Para obtener más información, consulta Especifica dependencias en Go.

Variables de entorno

El entorno de ejecución de Go configura automáticamente ciertas variables de entorno para que tu función las use según sea necesario. Para obtener más información, consulta Cómo configurar variables de entorno.

Tipo Context

El paquete context de Go define el tipo de Context, que lleva fechas límite, indicadores de cancelación y otros valores de alcance de la solicitud en todos los límites de la API y entre procesos.

En el siguiente código se muestra un ejemplo de acceso al contexto por parte de un cliente de 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
}