使用 Cloud Code for VS Code 创建和部署函数

本页面介绍如何使用 Cloud Functions 和 Cloud Code 创建、下载、部署和调用第 2 代 HTTP 函数。

准备工作

  1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

  2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  3. 确保您的 Google Cloud 项目已启用结算功能。

  4. 启用 Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub API。

    启用 API

    5.

  5. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  6. 确保您的 Google Cloud 项目已启用结算功能。

  7. 启用 Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub API。

    启用 API

    8.
  8. 安装 Git。 将示例复制到您的计算机需要使用 Git。
  9. 安装 Cloud Code 插件（如果尚未安装）。

创建一个函数

如果您之前创建过函数，则可以将现有函数下载到新工作区，然后在本地进行修改。

如需使用示例创建新函数，请按照以下步骤操作：

  1. 点击 Cloud Code，然后展开 Cloud Functions 部分。

  2. 点击 add 创建函数，然后选择一个模板。

  3. 转到要在其中创建新函数的路径，输入函数的名称，然后选择 Create New Application（创建新应用）。

    如果应用的文件夹没有自动显示在探索器中，请点击刷新和刷新。

    launch.json 文件包含您的函数所需的配置：

    {
  "configurations": [
    {
      "name": "Deploy Cloud Function",
      "type": "cloudcode.cloudfunctions",
      "request": "launch",
      "functionName": "function-hello-world",
      "gen": "GEN_2",
      "entryPoint": "helloHttp",
    }
  ]
}

如需详细了解如何在单个工作区中创建多个函数，请参阅在 VS Code 工作区中管理函数。

将现有函数下载到新工作区

如需将函数下载到新的工作区，请按以下步骤操作：

  1. 点击 Cloud Code，然后展开 Cloud Functions 部分。

  2. 展开您的 Google Cloud 项目代码段，右键点击您要下载的函数，然后选择 Download to new workspace。

  3. 出现提示时，输入新应用的名称，然后点击 Create New Application（创建新应用）。

    这会将函数下载到本地机器，并在 IDE 的新工作区中打开它。

部署函数

如需部署函数，请按以下步骤操作：

  1. 右键点击某个函数，然后选择部署函数。

  2. 在快速选择菜单中，选择要将函数部署到的 Google Cloud 项目。

  3. 选择要将函数部署到的区域。

  4. 选择运行时。

    函数的部署可能需要几分钟。在同步过程中，系统会显示 progress_activity 进度指示器。完成后，系统会显示 check_circle 对勾标记。如果失败，则会显示 error 错误标记。

    如果部署失败，请参阅输出标签页以查看错误消息。 点击该链接可转到 Google Cloud 控制台中的构建日志，并提供关于错误的更多详细信息。

    错误消息输出

  5. 可选：部署函数后，您可以执行以下操作：

    • 如需查看已部署函数的只读文件，请展开该函数，然后展开源代码文件夹。在这里，您可以在 .vscode、已部署的代码和 package.json 下查看 launch.json。

    • 如需在 Google Cloud 控制台中查看函数，请右键点击该函数并选择在 Cloud 控制台中打开，如果出现提示，请选择打开。

    • 如需修改函数的元数据，请右键点击该函数，然后选择在 Cloud Console 中修改元数据。

    • 如需查看已部署函数的日志，请右键点击该函数，然后选择查看日志。

调用函数

通过调用函数，您可以从 IDE 的内置终端在 Google Cloud 控制台中执行部署的函数。如需调用函数，请按以下步骤操作：

  1. 右键点击相应函数，然后选择 Invoke function via HTTP。

  2. 在显示的通过 HTTP 触发函数快捷选择中，选择以下两个选项之一：

    • 默认：系统会在 IDE 中打开一个终端，并运行一个命令，以在 Google Cloud 中执行该函数。

    • 从 JSON 文件导入参数：此选项接受所选 JSON 文件的内容，将其转换为字符串，并使用 -d '{ 传递。当您的函数有输入并想要保存时，这会非常有用，以便您执行输入而无需重复输入。

后续步骤

获取帮助

如需发送反馈，请在 GitHub 上报告问题，或者在 Stack Overflow 上提问。