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

本页介绍了如何将 Cloud Functions 与 Cloud Code 搭配使用,创建、下载、部署和调用第 2 代 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.

    Go to project selector

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

  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. Make sure that billing is enabled for your Google Cloud project.

  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 上提问。