使用 Cloud Code for Cloud Shell 创建第 2 代 Cloud Run functions 函数

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

Cloud Code 是一个扩展程序，可将许多 Google Cloud 服务（例如 Google Kubernetes Engine 和 Cloud Run）直接整合到 IDE 中，因此您无需上下文切换即可开发应用。Cloud Shell Editor 中默认会提供 Cloud Code。

您可以在 VS Code（还支持创建和部署函数）或 IntelliJ 以及其他受支持的 JetBrains IDE（不支持 Cloud Run 函数）中安装 Cloud Code 扩展程序。

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

操作演示

准备工作

  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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

连接到 Google Cloud

在本部分中，您将启动 Cloud Shell 编辑器，连接到 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。

    状态栏中的“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。

    Cloud Code 状态栏按钮

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

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

  4. 在示例 Cloud Run 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",
    }
]
}

部署函数

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

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

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

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

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

  5. 选择 Node.js 22。

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

    如果部署失败，请参阅输出（视图 > 输出）视图以查看错误消息。点击相应链接即可转到 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 进行确认，然后点击关停。

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

后续步骤