Go 執行階段

總覽

Cloud Run 函式會在環境中執行，該環境包含作業系統版本、附加套件、語言支援，以及支援和叫用函式的 Functions Framework 程式庫。這個環境由語言版本識別，稱為「執行階段」。

如要瞭解一般執行階段，以及各個 Go 執行階段使用的 Ubuntu 版本，請參閱 Cloud Run functions 執行環境。

選取執行階段

Cloud Run functions 支援多個 Go 版本，詳情請參閱「執行階段支援」頁面。在部署期間，您可以針對函式選取偏好的 Go 執行階段。

gcloud

如果您使用 Google Cloud CLI，請使用 --runtime 參數指定執行階段，並選擇 Go 執行階段。例如：

gcloud functions deploy FUNCTION_NAME --no-gen2 --runtime go121 FLAGS...

FLAGS... 是在第一次部署函式時所傳送的引數。如要進一步瞭解必要和選用引數，請參閱部署 Cloud Run 函式。

控制台

如果您使用 Google Cloud 控制台，請參閱Google Cloud 控制台快速入門導覽課程，瞭解詳細操作說明。

函式準備

您可以直接從 Google Cloud 控制台準備函式，也可以在本地電腦上編寫函式並上傳。如要準備本機電腦以進行 Go 開發作業，請參閱「設定 Go 開發環境」。

如要快速開始使用 Go on Cloud Run functions，請參閱快速入門導覽課程。

原始碼結構

如要讓 Cloud Run 函式找到函式的定義，原始碼必須遵循特定結構。詳情請參閱編寫 Cloud Run 函式一文。

指定依附元件

以 Go 編寫的 Cloud Run 函式必須透過含 go.mod 檔案的 Go 模組或 vendor 目錄提供所有依附元件。詳情請參閱在 Go 中指定依附元件一文。

環境變數

Go 執行階段會自動為函式設定特定環境變數，供您視需要使用。詳情請參閱使用環境變數。

「Context」類型

Go 的 context 套件定義了 Context 類型，這種類型可在不同 API 和程序之間傳遞期限、取消訊號和其他依要求劃定範圍的值。

下列 Cloud Run 函式程式碼範例，說明 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
}