使用 Cloud Shell 创建和部署函数

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

---

如需直接在 Cloud Shell Editor 中按照此任务的分步指南来执行操作，请点击操作演示：

操作演示

---

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

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

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

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

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

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

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 应用作为示例应用的类型。

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. 右键点击该函数，然后选择通过 HTTP 调用函数。

2. 在显示的通过 HTTP 触发函数快速选择菜单中，选择不使用参数进行调用。

   终端会在 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 资源管理器中，右键点击函数名称，然后选择在 Cloud Console 中打开。

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

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

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

   转到“项目”页面

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

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

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

后续步骤

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