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 complementarios, compatibilidad con idiomas y la biblioteca Go Functions Framework, que admite e invoca tu función. Este entorno se identifica por la versión del idioma y se conoce como ID de tiempo de ejecución.

Preparación de la función

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

Runtimes de Go e imágenes base compatibles

Tiempo de ejecución	ID de entorno de ejecución	Pilas	Imagen base de tiempo de ejecución
Go 1.25 (solo vista previa)	go125	google-22 (predeterminado) google-22-full	google-22/go125 google-22-full/go125
Go 1.24	go124	google-22 (predeterminado) google-22-full	google-22/go124 google-22-full/go124
Go 1.23	go123	google-22 (predeterminado) google-22-full	google-22/go123 google-22-full/go123
Go 1.22	go122	google-22 (predeterminado) google-22-full	google-22/go122 google-22-full/go122
Go 1.21	go121	google-22 (predeterminado) google-22-full	google-22/go121 google-22-full/go121
Go 1.20	go120	google-22 (predeterminado) google-22-full	google-22/go120 google-22-full/go120
Go 1.19	go119	google-22 (predeterminado) google-22-full	google-22/go119 google-22-full/go119
Go 1.18	go118	google-22 (predeterminado) 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	Retirado	Retirado

Nota: La política de lanzamientos de Go indica que cada versión principal de Go se admite hasta que haya dos versiones principales más recientes. Por lo tanto, en función de cuándo se publiquen las versiones más recientes de Go, es posible que se pospongan fechas clave, como la de finalización del periodo de asistencia, la de obsolescencia y la de retirada.

Selecciona tu tiempo de ejecución

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

Puedes seleccionar una versión del tiempo de ejecución mediante la Google Cloud consola o la CLI de gcloud. Haga clic en la pestaña para ver las instrucciones sobre cómo usar la herramienta que elija:

gcloud

Especifica la imagen base de Go de tu función con la marca --base-image al desplegarla. Por ejemplo:

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

Sustituye:

• FUNCTION con el nombre de la función que vas a implementar. Puedes omitir este parámetro por completo, pero se te pedirá el nombre si lo haces.

• FUNCTION_ENTRYPOINT con el punto de entrada de tu función en el 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 completo que exista en el código fuente.

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

Consola

Puedes seleccionar una versión del tiempo de ejecución al crear o actualizar una función de Cloud Run en la Google Cloud consola. Para obtener instrucciones detalladas sobre cómo desplegar una función, consulta Desplegar funciones en Cloud Run.

Para seleccionar un tiempo de ejecución en la consola Google Cloud al crear una función, sigue estos pasos:

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

   Ir a Cloud Run

2. Haz clic en Escribir una función.

3. En la lista Runtime (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 redirigirá a la pestaña Fuente, donde podrás ver el código fuente de tu función. Haz clic en Guardar y volver a implementar.

Para obtener instrucciones detalladas sobre cómo actualizar la versión del tiempo de ejecución después de implementar la función, consulta Volver a implementar código fuente nuevo.

Estructura del código fuente

Para que las funciones de Cloud Run encuentren la definición de tu función, el código fuente debe seguir una estructura específica. Para obtener más información, consulta Escribir funciones de Cloud Run.

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 Especificar dependencias en Go.

Variables de entorno

El tiempo de ejecución de Go define automáticamente determinadas variables de entorno para que tu función las use según sea necesario. Para obtener más información, consulta Configurar variables de entorno.

Tipo de Context

El contextpaquetede Go define el Context tipo, que incluye plazos, señales de cancelación y otros valores de ámbito de solicitud entre límites de 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
}