O ambiente de execução do Go

A função do Cloud Run é executada em um ambiente que consiste em uma versão do sistema operacional com pacotes complementares, suporte a linguagens e a biblioteca do Go Functions Framework que dá suporte e invoca a função. Esse ambiente é identificado pela versão da linguagem e é conhecido como ID do ambiente de execução.

Preparação de funções

É possível preparar uma função diretamente do console do Google Cloud ou gravá-la na máquina local e fazer upload dela. Para preparar a máquina local para desenvolvimento do Go, consulte Como configurar um ambiente de desenvolvimento do Go.

Ambientes de execução Go e imagens de base compatíveis

Ambiente de execução	ID do ambiente de execução	Pilhas	Imagem de base do ambiente de execução
Go 1.25	go125	google-22 (padrão) google-22-full	google-22/go125 google-22-full/go125
Go 1.24	go124	google-22 (padrão) google-22-full	google-22/go124 google-22-full/go124
Go 1.23	go123	google-22 (padrão) google-22-full	google-22/go123 google-22-full/go123
Go 1.22	go122	google-22 (padrão) google-22-full	google-22/go122 google-22-full/go122
Go 1.21	go121	google-22 (padrão) google-22-full	google-22/go121 google-22-full/go121
Go 1.20	go120	google-22 (padrão) google-22-full	google-22/go120 google-22-full/go120
Go 1.19	go119	google-22 (padrão) google-22-full	google-22/go119 google-22-full/go119
Go 1.18	go118	google-22 (padrão) 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	Desativado	Desativado

Observação: a política de versões do Go indica que cada versão principal é compatível até que haja duas versões principais mais recentes. Assim, dependendo de quando as versões mais recentes do Go forem disponibilizadas publicamente, as datas importantes, como fim do suporte, suspensão e desativação, poderão ser adiadas.

Selecionar o ambiente de execução

É possível selecionar um dos ambientes de execução do Go compatíveis para a função durante a implantação.

É possível selecionar uma versão de tempo de execução usando o console do Google Cloud ou a CLI gcloud. Clique na guia para ver instruções sobre como usar a ferramenta de sua preferência:

gcloud

Especifique a imagem de base do Go para sua função usando a flag --base-image ao implantá-la. Exemplo:

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

Substitua:

• FUNCTION pelo nome da função que você está implantando. É possível omitir esse parâmetro inteiramente, mas será solicitado o nome, se você omiti-lo.

• FUNCTION_ENTRYPOINT: o ponto de entrada da função no código-fonte. Esse é o código que o Cloud Run executa quando é executada. O valor dessa sinalização precisa ser um nome de função ou de classe totalmente qualificada no código-fonte.

Para instruções detalhadas sobre como implantar uma função usando a CLI gcloud, consulte Implantar funções no Cloud Run.

Console

É possível selecionar uma versão do ambiente de execução ao criar ou atualizar uma função do Cloud Run no console Google Cloud . Para instruções detalhadas sobre como implantar uma função, consulte Implantar funções no Cloud Run.

Para selecionar um ambiente de execução no console Google Cloud ao criar uma função, siga estas etapas:

1. No console Google Cloud , acesse a página do Cloud Run:

   Acessar o Cloud Run

2. Clique em Escrever uma função.

3. Na lista Ambiente de execução, selecione uma versão do ambiente de execução do Go.

4. Clique em Criar e aguarde o Cloud Run criar o serviço usando uma revisão do marcador de posição.

5. O console vai redirecionar você para a guia Origem, em que você pode ver o código-fonte da sua função. Clique em Salvar e implantar novamente.

Para instruções detalhadas sobre como atualizar a versão do ambiente de execução depois que a função for implantada, consulte Reimplantar novo código-fonte.

Estrutura do código-fonte

Para que as funções do Cloud Run encontrem a definição da sua função, seu código-fonte precisa seguir uma estrutura específica. Consulte Escrever funções do Cloud Run para mais informações.

Especificar as dependências

O Cloud Run functions no Go precisa fornecer todas as respectivas dependências com módulos Go e um arquivo go.mod ou com um diretório vendor. Para mais informações, consulte Especificar dependências no Go.

Variáveis de ambiente

O ambiente de execução do Go define automaticamente certas variáveis de ambiente para que sua função use conforme necessário. Para detalhes, consulte Configurar variáveis de ambiente.

Context tipo

O pacote context do Go define o tipo de Context, que transporta prazos, sinais de cancelamento e outros valores do escopo de solicitações entre limites de APIs e entre processos.

O código a seguir mostra um exemplo de acesso ao contexto por um cliente do 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
}