使用 Go（第 1 代）创建和部署 HTTP Cloud Run 函数

注意：此内容仅适用于 Cloud Run functions（第 1 代），即原 Cloud Functions（第 1 代）。

如需了解本文档的 Cloud Run functions 版本，请参阅使用 Go 创建和部署 HTTP Cloud Run 函数。

本指南将引导您完成用 Go 运行时编写 Cloud Run functions 函数的过程。Cloud Run functions 函数有两种类型：

• HTTP 函数，通过标准 HTTP 请求调用。
• 事件驱动型函数，用于处理来自云基础设施的事件，例如 Pub/Sub 主题中收到消息或 Cloud Storage 存储桶发生更改。

本指南中的示例演示了如何创建简单的 HTTP 函数。

了解详情：如需了解详情，请参阅 HTTP 函数和事件驱动的函数。

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

8. 安装并初始化 gcloud CLI。
9. 更新并安装 gcloud 组件：

   gcloud components update

注意：需要命令提示符？您可以使用 Google Cloud Shell。Google Cloud Shell 命令行环境已经包含 Google Cloud CLI，因此您无需再进行安装。Google Compute Engine 虚拟机也预装了 Google Cloud CLI。
10. 准备开发环境。

    转到 Go 设置指南

创建一个函数

1. 在本地系统上为函数代码创建一个目录：

   Linux 或 Mac OS X

   mkdir ~/helloworld
   cd ~/helloworld
   

   Windows

   mkdir %HOMEPATH%\helloworld
   cd %HOMEPATH%\helloworld
   

2. 在 helloworld 目录中创建一个名为 hello_http.go 的文件，其中包含以下内容：

   
   // Package helloworld provides a set of Cloud Functions samples.
   package helloworld
   
   import (
   	"encoding/json"
   	"fmt"
   	"html"
   	"net/http"
   
   	"github.com/GoogleCloudPlatform/functions-framework-go/functions"
   )
   
   func init() {
   	functions.HTTP("HelloHTTP", HelloHTTP)
   }
   
   // HelloHTTP is an HTTP Cloud Function with a request parameter.
   func HelloHTTP(w http.ResponseWriter, r *http.Request) {
   	var d struct {
   		Name string `json:"name"`
   	}
   	if err := json.NewDecoder(r.Body).Decode(&d); err != nil {
   		fmt.Fprint(w, "Hello, World!")
   		return
   	}
   	if d.Name == "" {
   		fmt.Fprint(w, "Hello, World!")
   		return
   	}
   	fmt.Fprintf(w, "Hello, %s!", html.EscapeString(d.Name))
   }
   

   此示例函数会获取 HTTP 请求中提供的姓名并返回问候语；或者，如果没有提供姓名，则返回“Hello, World!”。

指定依赖项

此示例函数仅使用 Go 标准库软件包，因此除了仅导入软件包之外，您无需声明任何依赖项。

对于需要标准库以外的依赖项的函数，您必须通过 go.mod 文件或 vendor 目录提供依赖项。如需了解详情，请参阅指定 Go 依赖项。

部署该函数

如需使用 HTTP 触发器部署函数，请在 helloworld 目录中运行以下命令，根据您使用的版本，指定 go113 或 go111 作为 --runtime 标志的值：

gcloud functions deploy HelloHTTP --no-gen2 --runtime go121 --trigger-http --allow-unauthenticated

注意：默认情况下，Cloud Run functions 会在终端的当前目录中查找可部署的函数。通过 gcloud 部署函数时，请使用 --source 标志来指定其他函数源代码目录。

通过 --allow-unauthenticated 标志，您可以在不进行身份验证的情况下访问函数。如需进行身份验证，请省略此标志。

了解详情：如需了解详情，请参阅部署 Cloud Run functions。

测试函数

1. 当函数完成部署时，请记下 httpsTrigger.url 属性，或使用以下命令查找该属性：

   gcloud functions describe HelloHTTP
   

   该属性应如下所示：

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP

2. 在浏览器中访问此网址，或者通过运行以下命令使用 cURL：

   curl https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP

   您应该会看到一条“Hello, World!”消息。请运行以下命令，尝试通过 HTTP 请求传递姓名：

   curl -X POST https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP -H "Content-Type:application/json"  -d '{"name":"NAME"}'

   您应该会看到一条“Hello, NAME!”消息。

查看日志

您可以使用 Google Cloud CLI 和 Cloud Logging 界面查看 Cloud Run functions 的日志。

使用命令行工具

如需使用 gcloud CLI 查看函数的日志，请使用 logs read 命令，后跟函数名称：

gcloud functions logs read HelloHTTP

输出应类似于以下内容：

LEVEL  NAME        EXECUTION_ID  TIME_UTC                 LOG
D      HelloHTTP  buv9ej2k1a7r  2019-09-20 13:23:18.910  Function execution started
D      HelloHTTP  buv9ej2k1a7r  2019-09-20 13:23:18.913  Function execution took 4 ms, finished with status code: 200

注意：日志条目在创建以后通常会稍微延迟一点时间才会显示在 Cloud Logging 中。

使用 Logging 信息中心

您还可以通过 Google Cloud 控制台查看 Cloud Run functions 的日志。

了解详情：如需了解详情，请参阅写入、查看和响应日志。