GSP602

概览

Go 是一种开源编程语言，可用于轻松构建简单、可靠且高效的软件。使用 Cloud Shell 时，系统已安装 Go。

Cloud Run functions 是一种用于构建和连接云服务的无服务器执行环境。借助 Cloud Run functions，您可以编写单一用途的函数，并将其关联到从云基础架构和服务发出的事件。当所监控的事件发生时，就会触发您的函数。您的代码将在 Cloud Run 的全托管式环境中执行。您无需预配任何基础架构，也不必费心管理任何服务器。

您可以使用受支持的编程语言编写 Cloud Run 函数。您可以将函数在任意受支持语言的标准运行时环境中运行，从而轻松实现移植和本地测试。

在本实验中，您将使用 Go 创建一个 Cloud Run 函数。通过 HTTP 调用该函数时，它将显示由 Renee French 设计的 Go Gopher 图像。

学习内容

• 如何编写 Go 版 HTTP Cloud Run 函数。
• 如何测试 Go 版 HTTP Cloud Run 函数。
• 如何运行本地 Go HTTP 服务器来试用函数。

前提条件

本实验假设您已熟悉 Go。虽然实验中提供了 Go 代码的说明，但对于 Go 的初学者而言，这些说明可能不够详尽。

设置和要求

点击“开始实验”按钮前的注意事项

请阅读以下说明。实验是计时的，并且您无法暂停实验。计时器在您点击开始实验后即开始计时，显示 Google Cloud 资源可供您使用多长时间。

此实操实验可让您在真实的云环境中开展实验活动，免受模拟或演示环境的局限。为此，我们会向您提供新的临时凭据，您可以在该实验的规定时间内通过此凭据登录和访问 Google Cloud。

为完成此实验，您需要：

• 能够使用标准的互联网浏览器（建议使用 Chrome 浏览器）。

注意：请使用无痕模式（推荐）或无痕浏览器窗口运行此实验。这可以避免您的个人账号与学生账号之间发生冲突，这种冲突可能导致您的个人账号产生额外费用。

• 完成实验的时间 - 请注意，实验开始后无法暂停。

注意：请仅使用学生账号完成本实验。如果您使用其他 Google Cloud 账号，则可能会向该账号收取费用。

如何开始实验并登录 Google Cloud 控制台

1. 点击开始实验按钮。如果该实验需要付费，系统会打开一个对话框供您选择支付方式。左侧是“实验详细信息”窗格，其中包含以下各项：

   • “打开 Google Cloud 控制台”按钮
   • 剩余时间
   • 进行该实验时必须使用的临时凭据
   • 帮助您逐步完成本实验所需的其他信息（如果需要）

2. 点击打开 Google Cloud 控制台（如果您使用的是 Chrome 浏览器，请右键点击并选择在无痕式窗口中打开链接）。

   该实验会启动资源并打开另一个标签页，显示“登录”页面。

   提示：将这些标签页安排在不同的窗口中，并排显示。

   注意：如果您看见选择账号对话框，请点击使用其他账号。

3. 如有必要，请复制下方的用户名，然后将其粘贴到登录对话框中。

   {{{user_0.username | "<用户名>"}}}

   您也可以在“实验详细信息”窗格中找到“用户名”。

4. 点击下一步。

5. 复制下面的密码，然后将其粘贴到欢迎对话框中。

   {{{user_0.password | "<密码>"}}}

   您也可以在“实验详细信息”窗格中找到“密码”。

6. 点击下一步。

   重要提示：您必须使用实验提供的凭据。请勿使用您的 Google Cloud 账号凭据。 注意：在本实验中使用您自己的 Google Cloud 账号可能会产生额外费用。

7. 继续在后续页面中点击以完成相应操作：

   • 接受条款及条件。
   • 由于这是临时账号，请勿添加账号恢复选项或双重验证。
   • 请勿注册免费试用。

片刻之后，系统会在此标签页中打开 Google Cloud 控制台。

注意：如需访问 Google Cloud 产品和服务，请点击导航菜单，或在搜索字段中输入服务或产品的名称。

激活 Cloud Shell

Cloud Shell 是一种装有开发者工具的虚拟机。它提供了一个永久性的 5GB 主目录，并且在 Google Cloud 上运行。Cloud Shell 提供可用于访问您的 Google Cloud 资源的命令行工具。

1. 点击 Google Cloud 控制台顶部的激活 Cloud Shell 。

2. 在弹出的窗口中执行以下操作：

   • 继续完成 Cloud Shell 信息窗口中的设置。
   • 授权 Cloud Shell 使用您的凭据进行 Google Cloud API 调用。

如果您连接成功，即表示您已通过身份验证，且项目 ID 会被设为您的 Project_ID 。输出内容中有一行说明了此会话的 Project_ID：

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud 是 Google Cloud 的命令行工具。它已预先安装在 Cloud Shell 上，且支持 Tab 自动补全功能。

3. （可选）您可以通过此命令列出活跃账号名称：

gcloud auth list

4. 点击授权。

输出：

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. （可选）您可以通过此命令列出项目 ID：

gcloud config list project

输出：

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注意：如需查看在 Google Cloud 中使用 gcloud 的完整文档，请参阅 gcloud CLI 概览指南。

设置区域和可用区

某些 Compute Engine 资源位于区域和可用区内。区域是指某个地理位置，您可以在其中运行自己的资源。每个区域包含一个或多个可用区。

在 Cloud Shell 中运行以下 Cloud Shell 命令，设置实验的默认区域和可用区：

gcloud config set compute/zone "{{{project_0.default_zone|ZONE}}}" export ZONE=$(gcloud config get compute/zone) gcloud config set compute/region "{{{project_0.default_region|REGION}}}" export REGION=$(gcloud config get compute/region)

确保已启用 Cloud Run functions API

• 在 Cloud Shell 中运行以下命令，以启用 Cloud Run functions API。启用后，您便可在本实验的后续步骤中部署 Cloud Run 函数。

gcloud services enable cloudfunctions.googleapis.com

下载并设置代码

1. 在 Cloud Shell 终端中，使用 curl 下载包含本实验代码的 zip 文件：

curl -LO https://github.com/GoogleCloudPlatform/golang-samples/archive/main.zip

2. 使用 unzip 解压缩代码。这会解压缩一个目录 (golang-samples-main)，其中包含用于 cloud.google.com 的 Go 代码示例：

unzip main.zip

3. 切换到包含本实验代码的目录：

cd golang-samples-main/functions/codelabs/gopher

gopher 目录中包含以下目录和文件：

$ tree . ├── cmd │ └── main.go # 用于在本地运行函数的二进制文件。 ├── go.mod # Go 模块定义。 ├── gophercolor.png # Gopher 图像！ ├── gopher.go # 包含函数的 Go 文件。 └── gopher_test.go # Go 测试文件。

任务 1. Go 版 HTTP Cloud Run 函数简介

Go 版 HTTP Cloud Run 函数编写为 http.HandlerFunc 函数，这是 Go 标准库中定义的接口。该函数必须满足以下条件：

• 可导出，即函数可在其他包中被调用。名称以大写字母开头即被视为导出。
• 符合 http.HandlerFunc 类型，即函数的形式为 func(http.ResponseWriter, *http.Request)（有关如何使用 Go 编写完整 Web 应用的详细指南，请参阅编写 Web 应用教程）。

例如，下面是一个“Hello, world”函数：

package gopher import ( "fmt" "net/http" ) // HelloWorld 函数输出 "Hello, world." func HelloWorld(w http.ResponseWriter, r *http.Request) { fmt.Fprintln(w, "Hello, world.") } 注意：您可以在 Cloud Shell Editor 中打开该文件（点击**打开编辑器**），然后通过左侧的文件树打开 golang-samples-main/functions/codelabs/gopher/hello.go 文件。

将该函数部署为 HTTP Cloud Run 函数

1. 在 functions/codelabs/gopher 目录中，使用 gcloud functions deploy 命令部署该函数：

gcloud functions deploy HelloWorld --gen2 --runtime go123 --trigger-http --region {{{project_0.default_region | REGION}}}

2. 系统询问是否允许未经身份验证调用新函数时，请输入 Y。

此过程需要一到两分钟。

输出：

Deploying function (may take a while - up to 2 minutes)...done. availableMemoryMb: 256 entryPoint: HelloWorld httpsTrigger: url: https://region-my-project.cloudfunctions.net/HelloWorld ...

点击检查我的进度以验证是否完成了以下目标： 创建 HelloWorld HTTP Cloud Run 函数

注意：部署期间发生错误？请检查：

• Cloud Run functions API 是否已启用？如果未启用，系统会显示一条错误消息，并提供一个可用于启用该 API 的链接。此外，您也可以运行 gcloud services enable cloudfunctions.googleapis.com 命令启用该 API。
• 确保当前工作目录（即您运行 gcloud 命令所在的目录）包含 .go 文件。您可以使用 cd golang-samples/functions/codelabs/gopher 命令切换到该目录。
• 函数名称是否正确？函数名称应为 HelloWorld，也就是您要部署的 Go 函数名称。
• 如果仍然收到权限遭拒错误，请等待几分钟后重试。
• 部署完成后，如果在访问已部署函数的网址时遇到 **403 禁止访问**错误，请运行以下命令，授予函数公开访问权限：gcloud functions add-iam-policy-binding HelloWorld \ --member="allUsers" \ --role="roles/cloudfunctions.invoker" \ --region= 完成 IAM 政策绑定后，使用前面的部署命令重新部署该函数。

3. 复制输出中显示的 httpsTrigger 网址。它应如下所示：

https://<REGION>-$GOOGLE_CLOUD_PROJECT.cloudfunctions.net/HelloWorld

4. 若要测试 HelloWorld 函数，请使用 curl 命令访问刚才输出的网址：

curl https://<REGION>-$GOOGLE_CLOUD_PROJECT.cloudfunctions.net/HelloWorld

输出：

Hello, world.

您已成功编写并部署了一个 HTTP Cloud Run 函数！

任务 2. 编写 Gopher HTTP Cloud Run 函数

现在，我们来让“Hello, world”函数更有趣一些，让它在每次收到请求时输出一张 Gopher 图像。

以下代码块展示了实现这一功能的代码。您可以在 Cloud Shell 中查看该代码，路径为 golang-samples-master/functions/codelabs/gopher/gopher.go。

// 包 gopher 包含一个用于显示 Gopher 图像的 HTTP 函数。 package gopher import ( "fmt" "io" "net/http" "os" ) // Gopher 函数用于输出 Gopher 图像。 func Gopher(w http.ResponseWriter, r *http.Request) { // 读取 Gopher 图片文件。 f, err := os.Open("gophercolor.png") if err != nil { http.Error(w, fmt.Sprintf("Error reading file: %v", err), http.StatusInternalServerError) return } defer f.Close() // 将 Gopher 图像写入响应写入器。 if _, err := io.Copy(w, f); err != nil { http.Error(w, fmt.Sprintf("Error writing response: %v", err), http.StatusInternalServerError) } w.Header().Add("Content-Type", "image/png") }

• 该文件以包声明和注释开头。所有 Go 代码都写在一个包内，顶部有类似这样的声明。

• import 块列出了该文件依赖的其他包。在文件的其余部分，这些包将通过其名称进行调用。例如，若要使用 http 包中的 ResponseWriter 类型，应写作 http.ResponseWriter。

• 接下来是 Gopher 函数声明。

• 该函数首先通过 os.Open 函数读取 gophercolor.png 文件（参考示例代码）。

• 然后，它会检查读取文件时是否出错。文件损坏或在上传时不小心被遗漏都可能导致读取错误。

• 它使用 io.Copy 将 Gopher 图像复制到 w，即 http.ResponseWriter 参数。写入 w 的所有内容都会随 HTTP 响应一同发送。

• 如果写入响应时没有出错，函数将正常返回。

1. 与部署“Hello, world”函数的方式相同，使用 gcloud functions deploy 命令和函数名称 Gopher 部署函数：

gcloud functions deploy Gopher --gen2 --runtime go123 --trigger-http --region {{{project_0.default_region | REGION}}}

2. 系统询问是否允许未经身份验证调用新函数时，请输入 Y。

3. 若要测试函数，请访问上一条命令输出中的函数网址。如果部署成功，您将在浏览器中看到 Gopher 图像！

下一步是添加测试，以确保函数继续正常运行。

点击检查我的进度以验证是否完成了以下目标： 创建 Gopher HTTP Cloud Run 函数

任务 3. 编写测试

Go 版 HTTP Cloud Run 函数使用标准库中的 testing 和 httptest 包进行测试。测试函数无需运行模拟器或其他模拟环境，只需使用常规 Go 代码即可。

以下是 Gopher 函数的测试示例：

package gopher import ( "net/http" "net/http/httptest" "testing" ) func TestGopher(t *testing.T) { rr := httptest.NewRecorder() req := httptest.NewRequest("GET", "/", nil) Gopher(rr, req) if rr.Result().StatusCode != http.StatusOK { t.Errorf("Gopher StatusCode = %v, want %v", rr.Result().StatusCode, http.StatusOK) } }

• Go 测试的编写方式与其他 Go 文件相同。测试文件开头包括包声明和导入语句。
• 测试声明的形式为 func MyTest(t *testing.T)。该函数必须已导出，并接收一个类型为 *testing.T 的参数。
• 测试使用 httptest 包创建用于测试的响应和请求对象。
• 它会调用 Gopher 函数。
• 在调用 Gopher 函数之后，测试会检查 HTTP 响应代码，以确保未发生任何错误。

1. 若要在本地运行这些测试，请使用 cd 命令切换到包含待测试文件的目录：

cd ~/golang-samples-main/functions/codelabs/gopher

2. 在 golang-samples-main/functions/codelabs/gopher 目录中，运行 go test 命令：

go test -v

输出：

=== RUN TestGopher --- PASS: TestGopher (0.00s) PASS ok github.com/GoogleCloudPlatform/golang-samples/functions/codelabs/gopher 0.037s 注意：测试未通过？

• 查看错误消息，看看其中是否提供了任何有用信息。
• 您是否位于 gopher.go 和 gopher_test.go 文件所在的目录 (golang-samples-main/functions/codelabs/gopher)？

接下来，您将创建一个二进制文件（在 Go 中为 package main），以便在本地运行函数，并在浏览器中试用。

任务 4. 在本地运行函数

若要在本地运行 HTTP 函数，您需要创建一个 HTTP 服务器，并将函数注册为其处理程序。（有关如何使用 Go 编写完整 Web 应用的详细指南，请参阅编写 Web 应用教程）。

您可以在函数的子目录中为函数编写一个 HTTP 服务器。

按照 Go 惯例，将该目录命名为 cmd，并在其中创建一个名为 main.go 的文件。

// cmd 命令将启动一个 HTTP 服务器。 package main import ( "fmt" "log" "net/http" "github.com/GoogleCloudPlatform/golang-samples/functions/codelabs/gopher" ) func main() { http.HandleFunc("/", gopher.Gopher) fmt.Println("Listening on localhost:8080") log.Fatal(http.ListenAndServe(":8080", nil)) }

• 该文件使用 package main 作为包。main 包将构建为一个可运行的二进制文件。
• 该文件会导入 github.com/GoogleCloudPlatform/golang-samples/functions/codelabs/gopher，其路径基于与函数文件同目录的 go.mod 文件中的 module 行确定。在编写函数时，您可以自由命名模块。
• func main() 是该二进制文件的入口点。它将 gopher.Gopher 函数注册为 HTTP 处理程序，并使用 http.ListenAndServe 启动服务器。

1. 若要在本地构建并运行该二进制文件，请运行以下命令：

go123MODULES=on # 启用 Go 模块。 go build -o start ./cmd ./start

输出：

Listening on localhost:8080

2. 由于函数会从当前工作目录加载 gophercolor.png 图像，因此您必须从 gophercolor.png 文件所在目录启动二进制文件。-o start 标志表示将输出的二进制文件命名为 start。./cmd 表示要构建位于 cmd 目录中的二进制文件。

3. 现在，使用 Cloud Shell 的网页预览功能在浏览器中测试服务器。

• 点击“网页预览”按钮 。
• 从显示的菜单中选择端口 8080。

Cloud Shell 会在新的浏览器窗口中，通过其代理服务打开预览网址。网页预览功能会限制访问权限，仅允许您的用户账号通过 HTTPS 进行访问。

如果一切正常，您应该会看到 Go Gopher！

注意：看不到 Gopher？请检查：

• 您是否位于 gopher.go 和 gopher_test.go 文件所在的目录 (golang-samples-main/functions/codelabs/gopher)？
• 服务器是否已启动？请确保使用 go build -o start ./cmd 命令构建服务器，然后运行 ./start 命令启动服务器。成功启动后，系统应输出 Listening on localhost:8080。
• 在打开网页预览时，您是否选择了正确的端口？请务必选择 8080，即服务器正在监听的端口。

任务 5. 清理

结束本实验时，您使用的所有资源将被删除。使用自己的环境时，您应始终删除不必要的资源，以节省成本，践行良好的云资源管理实践。

1. 按 CTRL+C 停止提供网址服务。

2. 完成 Cloud Run 函数测试后，您可以使用 gcloud 命令将其删除：

gcloud functions delete Gopher --region {{{project_0.default_region | REGION}}} gcloud functions delete HelloWorld --region {{{project_0.default_region | REGION}}}

您也可以在控制台中删除该函数。

恭喜！

现在，您已经知道如何使用 Go 版 Cloud Run 函数了！在本实验中，您学习了如何编写 Go 版 HTTP Cloud Run 函数、如何测试函数，以及如何在本地运行函数。

Google Cloud 培训和认证

…可帮助您充分利用 Google Cloud 技术。我们的课程会讲解各项技能与最佳实践，可帮助您迅速上手使用并继续学习更深入的知识。我们提供从基础到高级的全方位培训，并有点播、直播和虚拟三种方式选择，让您可以按照自己的日程安排学习时间。各项认证可以帮助您核实并证明您在 Google Cloud 技术方面的技能与专业知识。

上次更新手册的时间：2025 年 9 月 25 日

上次测试实验的时间：2025 年 9 月 25 日

版权所有 2025 Google LLC 保留所有权利。Google 和 Google 徽标是 Google LLC 的商标。其他所有公司名和产品名可能是其各自相关公司的商标。

提供关于本实验的反馈