使用 Go(第 1 代)创建和部署 HTTP Cloud Run functions 函数
本指南将引导您完成用 Go 运行时编写 Cloud Run functions 函数的过程。Cloud Run functions 函数有两种类型:
- HTTP 函数,通过标准 HTTP 请求调用。
- 事件驱动型函数,用于处理来自云基础设施的事件,例如 Pub/Sub 主题中收到消息或 Cloud Storage 存储桶发生更改。
本指南中的示例演示了如何创建简单的 HTTP 函数。
准备工作
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Functions and Cloud Build APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Functions and Cloud Build APIs.
- 安装并初始化 gcloud CLI。
- 更新并安装
gcloud
组件:gcloud components update
- 准备开发环境。
创建一个函数
在本地系统上为函数代码创建一个目录:
Linux 或 Mac OS X
mkdir ~/helloworld cd ~/helloworld
Windows
mkdir %HOMEPATH%\helloworld cd %HOMEPATH%\helloworld
在
helloworld
目录中创建一个名为hello_http.go
的文件,其中包含以下内容:此示例函数会获取 HTTP 请求中提供的姓名并返回问候语;或者,如果没有提供姓名,则返回“Hello, World!”。
指定依赖项
此示例函数仅使用 Go 标准库软件包,因此除了仅导入软件包之外,您无需声明任何依赖项。
对于需要标准库以外的依赖项的函数,您必须通过 go.mod
文件或 vendor
目录提供依赖项。如需了解详情,请参阅指定 Go 依赖项。
部署该函数
如需使用 HTTP 触发器部署函数,请在 helloworld
目录中运行以下命令,根据您使用的版本,指定 go113
或 go111
作为 --runtime
标志的值:
gcloud functions deploy HelloHTTP --no-gen2 --runtime go122 --trigger-http --allow-unauthenticated
通过 --allow-unauthenticated
标志,您可以在不进行身份验证的情况下访问函数。如需进行身份验证,请省略此标志。
测试函数
当函数完成部署时,请记下
httpsTrigger.url
属性,或使用以下命令查找该属性:gcloud functions describe HelloHTTP
该属性应如下所示:
https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloHTTP
在浏览器中访问此网址,或者通过运行以下命令使用 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
使用 Logging 信息中心
您还可以通过 Google Cloud 控制台查看 Cloud Run functions 的日志。