使用 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

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

   启用 API

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

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

   启用 API

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. 可选：部署函数后，您可以执行以下操作：

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

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

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

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

调用函数

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

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

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

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

   • 从 JSON 文件导入参数：此选项会获取所选 JSON 文件的内容，将其转换为字符串，然后使用 -d '{ 传递。当您有函数的输入并希望保存时，此输入非常有用，可让您执行此输入而无需反复重新输入。

后续步骤

• 如需详细了解如何管理工作区或设置本地开发环境，请参阅使用 Cloud Functions 概览。

获取帮助

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