方法指南

编写 Cloud Functions 函数

• 概览

  简要介绍如何编写 Cloud Functions 函数。

• HTTP 函数

  通过标准 HTTP 请求调用 Cloud Functions 函数。

• 后台函数

  某些 Cloud Functions 运行时（Node.js、Python、Java 和 Go）使用后台函数来处理云基础架构产生的事件，例如 Cloud Pub/Sub 主题中收到消息或 Google Cloud Storage 存储分区发生更改。

• CloudEvent 函数

  其他 Cloud Functions 运行时（例如 Ruby 和 .NET）使用 CloudEvent 函数来处理云基础架构产生的事件，例如 Cloud Pub/Sub 主题中收到消息或 Google Cloud Storage 存储分区发生更改。

• 指定 Node.js 依赖项

  了解如何为使用 Node.js 编写的 Cloud Functions 函数指定依赖项。

• 指定 Python 依赖项

  了解如何为使用 Python 编写的 Cloud Functions 函数指定依赖项。

• 指定 Go 依赖项

  了解如何为使用 Go 编写的 Cloud Functions 函数指定依赖项。

• 指定 Java 依赖项

  了解如何为使用 Java 编写的 Cloud Functions 函数指定依赖项。

• 指定 .NET 依赖项

  了解如何为使用 .NET 语言编写的 Cloud Functions 函数指定依赖项。

• 指定 Ruby 依赖项

  了解如何为使用 Ruby 编写的 Cloud Functions 函数指定依赖项。

• 指定 PHP 依赖项

  了解如何为使用 PHP 编写的 Cloud Functions 函数指定依赖项。

部署 Cloud Functions 函数

• 概览

  简要了解如何部署 Cloud Functions 函数。

• 通过本地机器部署

  通过本地计算机部署 Cloud Functions 函数。

• 通过源代码控制系统部署

  通过 Google Cloud Source Repositories 部署 Cloud Functions 函数。

• 通过 Cloud Console 部署

  通过 Cloud Console 部署 Cloud Functions 函数。

调用 Cloud Functions 函数

• 概览

  简要介绍如何调用 Cloud Functions 函数。

• HTTP 触发器

  使用 HTTP 方法触发 Cloud Functions 函数。

• Cloud Pub/Sub 触发器

  通过 Pub/Sub 主题异步触发 Cloud Functions 函数。

• Cloud Storage 触发器

  触发 Cloud Functions 函数来响应 Google Cloud Storage 发出的更改通知。

• 直接调用 Cloud Functions 函数

  了解如何通过 gcloud 命令行工具和 Cloud Console 手动调用 Cloud Functions 函数。

• Cloud Firestore 触发器

  触发 Cloud Functions 函数来响应 Firestore 事件。

• Google Analytics for Firebase 触发器

  触发 Cloud Functions 函数来响应 Google Analytics for Firebase 事件。

• Firebase Realtime Database 触发器

  触发 Cloud Functions 函数来响应 Firebase Realtime Database 事件。

• Firebase Authentication 触发器

  触发 Cloud Functions 函数来响应 Firebase 身份验证事件。

• 使用 Cloud Logging 的第二方触发器

  触发 Cloud Functions 函数以响应来自生成 Cloud Logging 审核日志的 Google Cloud Platform 服务的事件。

• 使用 Cloud Scheduler 触发 Cloud Functions 函数

  使用 Cloud Scheduler 和 Cloud Pub/Sub 触发器按预定时间调用 Cloud Functions 函数。这样，您就可以将 Cron 作业设置为按特定时间间隔定期运行。

测试 Cloud Functions 函数

• 测试基础知识

  了解如何使用 Cloud Functions 创建单元测试、系统测试和集成测试。

• 测试 HTTP 函数

  了解如何测试 HTTP Cloud Functions 函数。Cloud Functions 函数可以是 HTTP 函数，也可以是事件驱动函数。

• 测试事件驱动函数

  了解如何测试事件驱动型 Cloud Functions 函数。如果您希望间接调用 Cloud Functions 函数来响应事件（例如 Cloud Pub/Sub 主题中收到消息、Cloud Storage 存储分区发生更改或 Firebase 事件），则可以使用事件驱动函数。

• CI/CD

  了解如何配置持续集成和部署 (CI/CD) 流水线，以持续运行 Cloud Functions 函数测试。

Cloud Functions 网络

• 连接到 VPC 网络

  了解如何使用无服务器 VPC 访问通道，将您的函数连接到 VPC 网络中的资源。

• 连接到共享 VPC 网络

  了解如何使用无服务器 VPC 访问通道，将您的函数连接到共享 VPC 网络中的资源。

• 配置网络设置

  通过 Cloud Functions 网络设置，控制各个函数之间的网络入站流量和出站流量。

确保 Cloud Functions 函数的安全

• 通过 IAM 管理访问权限

  了解如何使用 IAM 为您的函数提供基于身份的访问权限控制。管理开发者查看、创建、更新和删除函数的能力，并控制是否需要通过身份验证才能调用函数。

• 对开发者、函数和最终用户进行身份验证

  了解如何对函数的调用方进行身份验证。

• 函数身份

  了解您的函数在运行时使用的身份，如何配置此身份并更改其权限，以及如何获取身份和访问令牌以安全地调用其他函数或 Cloud API。

• 使用 VPC Service Controls

  了解如何将 VPC Service Control 与 Cloud Functions 结合使用，从而加强函数的安全性并防止数据渗漏。

监控 Cloud Functions 函数

• 概览

  简要介绍如何监控 Cloud Functions 函数。

• 写入和查看日志

  将日志与 Cloud Functions 函数搭配使用。

• 报告错误

  报告 Cloud Functions 函数中的错误。

• 查看受监控的指标

  查看 Cloud Functions 函数受监控的指标。

• 使用 Cloud Audit Logging

  了解 Cloud Audit Logging 中由 Cloud Functions 创建的默认日志和可选日志。

迁移 Cloud Functions 函数

• 将 Cloud Functions 函数迁移到较新版本的 Node.js 运行时

  了解较新版本的 Node.js 运行时中的变化，以及如何更新 Node.js 函数以便在较新版本的运行时中运行。

最佳做法

• 提示与技巧

  了解编写、测试和部署 Cloud Functions 函数的最佳做法。

• 重试事件驱动的函数

  了解如何启用失败时重试事件驱动的函数。

• 优化网络

  了解如何优化函数连接网络的方式，以尽可能降低用尽 DNS 或连接配额的可能性。

配置 Cloud Functions

• 使用实例数上限

  使用实例数上限功能限制函数为了响应传入请求而扩缩的程度。

• 使用实例数下限

  使用实例数下限功能，以避免应用冷启动并缩短应用延迟时间。

• 使用 Secret

  搭配使用 Secret Manager 和 Cloud Functions，安全地存储和访问 API 密钥或密码等敏感信息。

• 使用环境变量

  定义可供您的 Cloud Functions 函数代码在运行时访问的环境变量。

与 Cloud 数据库集成

• 连接到 Cloud SQL

  使用 Cloud Functions 执行环境中提供的本地插槽接口将 Cloud Functions 连接到 Cloud SQL 实例。

• 连接到 Cloud Spanner

  将 Cloud Functions 函数连接到 Cloud Spanner。

• 连接到 Firestore

  将 Cloud Functions 函数连接到 Firestore。

在本地测试

• Functions 框架

  先使用 Cloud Functions 框架在本地机器上运行和调试您的 Cloud Functions 函数，然后再将其部署到生产环境中。