使用 Cloud Shell 创建和部署函数

了解如何在 Cloud Shell Editor 中使用 Cloud Functions 和 Cloud Code 创建、部署、调用和下载第 2 代 HTTP 函数。

---

如需在 Cloud Shell Editor 中直接遵循有关此任务的分步指导，请点击操作演示：

操作演示

---

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

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

连接到 Google Cloud

在本部分中，您将启动 Cloud Shell Editor，连接到 Google Cloud，然后选择一个 Google Cloud 项目。

如需连接到 Google Cloud，请按以下步骤操作：

1. 启动 Cloud Shell Editor。

2. 如果系统提示您授权 Cloud Code 使用您的凭据进行 Google Cloud API 调用并且您同意相应条款，请点击授权。

3. 如果您尚未连接到 Google Cloud，请在 Cloud Code 状态栏中点击 Connect to Google Cloud。

   

4. 如果系统提示您授权 Cloud Code 使用您的凭据进行 Google Cloud API 调用并且您同意相应条款，请点击授权。

5. 如果尚未选择 Google Cloud 项目，请在 Cloud Code 状态栏中点击选择 Google Cloud 项目。

   如果您已选择 Google Cloud 项目，则会在 Cloud Code 状态栏中看到项目名称，并且可继续创建函数。

6. 在显示的选择 Google Cloud 项目快速选择菜单中，选择您的 Google Cloud 项目。

   该项目会加载并变为 Cloud Shell Editor 中的活跃项目。通过点击 Cloud Code 状态栏中的活跃项目名称并选择其他项目，您可以随时切换此项目。

创建函数

将 Cloud Shell Editor 用作创建和部署函数的环境。编辑器会预加载云开发所需的工具。

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

1. 在 Cloud Code 状态栏中，点击 Cloud Code。

   

2. 在显示的快速选择菜单中，选择新应用。

3. 选择 Cloud Functions application 作为示例应用的类型。

4. 在示例 Cloud Functions 应用列表中，选择 Node.js: Hello World。

5. 选择一个文件夹作为应用位置，然后点击 Create New Application（创建新应用）。

   Cloud Shell Editor 将在新工作区中加载您的应用。重新加载完毕后，您可以使用探索器视图访问您的应用。

   launch.json 文件（位于 .vscode 文件夹中）包含您的函数所需的配置：

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

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

部署函数

现在您已经创建了函数，接下来可以按照以下步骤将其部署到 Cloud Shell 中：

1. 点击 Cloud Code，然后展开 Cloud Functions 探索器。

2. 点击一个函数，然后点击 部署函数。

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

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

5. 选择 Node.js 20。

   函数的部署可能需要几分钟。如果部署仍在进行中，您将看到 进度图标。完成后，如果成功，您会看到 成功图标；如果失败，您会看到 错误图标；如果部署失败并还原为之前成功的部署，您会看到 警告图标。

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

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

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

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

   • 如需修改函数的元数据，请右键点击相应函数，然后选择在 Cloud 控制台中修改元数据。

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

调用函数

调用函数后，您可以通过 Cloud Shell Editor 的终端在 Google Cloud 控制台中执行已部署的函数。如需调用函数，请按照以下步骤操作：

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

2. 在显示的 Trigger function via HTTP 快速菜单中，选择 Invoke with no arguments。

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

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

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

1. 点击 Cloud Code，然后展开 Cloud Functions 探索器。

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

3. 出现提示时，为新应用输入名称，然后点击 Create New Application。

   此操作会将该函数下载到本地机器，并在 Cloud Shell Editor 的新工作区中打开它。

清理

如需仅删除您为本快速入门创建的函数，请执行以下操作：

1. 在 Cloud Functions 探索器中，右键点击函数名称，然后选择 Open in Cloud Console。

2. 点击删除，然后再次点击删除进行确认。

如需删除项目（和关联的资源），请执行以下操作：

1. 进入 Google Cloud 控制台中的“项目”页面：

   转到“项目”页面

2. 选择您为本快速入门创建的项目，然后点击删除。

3. 输入项目 ID 进行确认，然后点击关停。

   这将关闭该项目并安排将其删除。

后续步骤

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