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.

Entornos de ejecución y imágenes base de Go compatibles

Entorno de ejecución	ID de entorno de ejecución	Pilas	Imagen base del entorno de ejecución
Go 1.23 (solo versión preliminar)	go123	google-22 (predeterminada) google-22-full	google-22/go123 google-22-full/go123
Go 1.22	go122	google-22 (predeterminada) google-22-full	google-22/go122 google-22-full/go122
Go 1.21	go121	google-22 (predeterminada) google-22-full	google-22/go121 google-22-full/go121
Go 1.20	go120	google-22 (predeterminada) google-22-full	google-22/go120 google-22-full/go120
Go 1.19	go119	google-22 (predeterminada) google-22-full	google-22/go119 google-22-full/go119
Go 1.18	go118	google-22 (predeterminada) 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	Fuera de servicio	Fuera de servicio

Nota: En la política de versiones de Go, se indica que cada versión principal de Go es compatible hasta que haya dos versiones principales más recientes. Es posible que las fechas de claves no estén disponibles hasta que las versiones más recientes de Go estén disponibles de forma pública.

Selecciona tu entorno de ejecución

Puedes seleccionar uno de los entornos de ejecución de Go compatibles para tu función durante la implementación.

Puedes seleccionar una versión del entorno de ejecución con la consola de Google Cloud o la CLI de gcloud. Haz clic en la pestaña para obtener instrucciones sobre el uso de la herramienta que elijas:

gcloud

Especifica la imagen base de Go para tu función con la marca --base-image mientras la implementas. Por ejemplo:

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

Reemplaza lo siguiente:

• Reemplaza FUNCTION por el nombre de la función que implementas. Puedes omitir este parámetro por completo, pero se te solicitará el nombre si lo haces.

• FUNCTION_ENTRYPOINT por el punto de entrada a tu función en tu código fuente. Este es el código que ejecuta Cloud Run cuando se ejecuta tu función. El valor de esta marca debe ser un nombre de función o un nombre de clase completamente calificado que exista en tu código fuente.

Para obtener instrucciones detalladas sobre cómo implementar una función con la CLI de gcloud, consulta Implementa funciones en Cloud Run.

Console

Puedes seleccionar una versión del entorno de ejecución cuando creas o actualizas una función de Cloud Run en la consola de Google Cloud. Si deseas obtener instrucciones detalladas para implementar una función, consulta Implementa funciones en Cloud Run.

Para seleccionar un entorno de ejecución en la consola de Google Cloud cuando creas una función, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Cloud Run:

   Ir a Cloud Run

2. Haz clic en Escribe una función.

3. En la lista Entorno de ejecución, selecciona una versión del entorno de ejecución de Go.

4. Haz clic en Crear y espera a que Cloud Run cree el servicio con una revisión de marcador de posición.

5. La consola te redireccionará a la pestaña Fuente, en la que puedes ver el código fuente de tu función. Haz clic en Guardar y volver a implementar.

Si deseas obtener instrucciones detalladas para actualizar la versión del entorno de ejecución después de implementar la función, consulta Cómo volver a implementar un código fuente nuevo.

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
}