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

本页介绍了如何将 Cloud Functions 与 Cloud Code 搭配使用,创建、下载、部署和调用第 2 代 HTTP 函数。

准备工作

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

    Go to project selector

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

  4. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

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

    Go to project selector

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

  7. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

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

创建一个函数

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

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

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

  2. 点击添加创建函数,然后选择一个模板。

  3. 前往您要创建新函数的路径,输入函数名称,然后选择 Create New Application(创建新应用)。

    如果应用的文件夹未自动显示在 Explorer 中,请点击刷新刷新

    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

    这会将函数下载到本地计算机,并在新的 工作区中。

部署函数

如需部署函数,请按以下步骤操作:

  1. 右键点击相应函数,然后选择部署函数

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

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

  4. 选择运行时。

    函数的部署可能需要几分钟时间。在执行过程中,系统会显示 progress_activity 进度指示器。完成后,系统会显示 check_circle 对勾标记。如果请求失败 error 错误标记。

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

    错误消息输出

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

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

    • 如需在 Google Cloud 控制台中查看函数,请右键点击 函数并选择在 Cloud Console 中打开,如果系统提示,请选择 Open

    • 要修改函数的元数据,请右键点击该函数并 选择在 Cloud 控制台中修改元数据

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

调用函数

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

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

  2. 在随即显示的 Trigger function via HTTP 快速选项中,选择以下两个选项之一:

    • 默认:终端会在 IDE 中打开,并运行命令以在 Google Cloud 中执行函数。

    • 从 JSON 文件导入参数:此选项会将 选定的 JSON 文件,将其转换为字符串,然后使用 -d '{。如果您向函数输入了内容并想将其保存,此功能非常有用,因为您无需重复输入即可执行该内容。

后续步骤

获取支持

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