了解如何使用 API 创建、部署、调用和下载 HTTP Cloud Run 函数 使用 Cloud Code 的 Cloud Run 函数 Cloud Shell Editor
如需遵循有关此任务的分步指导,请直接在 Cloud Shell Editor 中点击操作演示:
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
连接到 Google Cloud
在本部分中,您将启动 Cloud Shell Editor, Google Cloud,然后选择 Google Cloud 项目。
如需连接到 Google Cloud,请按以下步骤操作:
如果系统提示您授权 Cloud Code 使用您的凭据进行 Google Cloud API 调用并且您同意相应条款,请点击授权。
如果您尚未连接到 Google Cloud,请在 Cloud Code 状态栏中点击 Connect to Google Cloud。
如果系统提示您授权 Cloud Code 使用您的凭据进行 Google Cloud API 调用并且您同意相应条款,请点击授权。
如果您尚未选择 Google Cloud 项目,请在 Cloud Code 状态栏中点击 Select a Google Cloud Project(选择 Google Cloud 项目)。
如果您已选择 Google Cloud 项目,则会在 Cloud Code 状态栏中看到项目名称,并且可继续创建函数。
在显示的选择 Google Cloud 项目快速选择菜单中,选择您的 Google Cloud 项目。
该项目会加载并变为 Cloud Shell Editor 中的活跃项目。通过点击 Cloud Code 状态栏中的活跃项目名称并选择其他项目,您可以随时切换此项目。
创建函数
将 Cloud Shell Editor 用作创建和部署函数的环境。编辑器会预加载云开发所需的工具。
如需使用示例创建新函数,请按照以下步骤操作:
在 Cloud Code 状态栏中,点击 Cloud Code。
在显示的快速选择菜单中,选择新应用。
选择 Cloud Functions application 作为示例应用的类型。
在示例 Cloud Run 函数应用列表中,选择 Node.js:Hello World。
选择一个文件夹作为应用位置,然后点击 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 中:
点击 Cloud Code,然后展开 Cloud Functions 探索器。
点击一个函数,然后点击
部署函数。在快速选择菜单中,选择要将函数部署到的 Google Cloud 项目。
选择函数将部署到的区域。
选择 Node.js 22。
函数的部署可能需要几分钟时间。如果部署仍在进行中,您将看到
进度图标。完成后,您会看到 成功图标 如果成功,则 错误图标,如果系统运行失败,则会显示 警告图标 如果部署失败并恢复为以前成功的部署,则会发生该错误。如果部署失败,请参阅输出(视图 > 输出) 查看错误消息。点击相应链接即可转到 Google Cloud 控制台中的构建日志,并提供有关错误的更多详细信息。
(可选)部署函数后,您可以执行以下操作:
如需查看已部署的函数的只读文件,请展开该函数,然后展开源代码文件夹。您可以在此处查看
.vscode
下的launch.json
、已部署的代码和package.json
。如需在 Google Cloud 控制台中查看该函数,请右键点击该函数,然后选择在 Cloud 控制台中打开,如果出现提示,请选择打开。
如需修改函数的元数据,请右键点击相应函数,然后选择在 Cloud 控制台中修改元数据。
如需查看已部署的函数的日志,请右键点击该函数,然后选择查看日志。
调用函数
调用函数后,您就可以在 从 Cloud Shell Editor 的终端打开 Google Cloud 控制台。如需调用函数,请按照以下步骤操作:
右键点击相应函数,然后选择 Invoke function via HTTP。
在显示的 Trigger function via HTTP 快速菜单中,选择 Invoke with no arguments。
终端会在 IDE 中打开,并运行命令以在 Google Cloud 中执行函数。
可选:将现有函数下载到新工作区
如需将现有函数下载到新工作区,请按照以下步骤操作:
点击 Cloud Code,然后展开 Cloud Functions 探索器。
展开您的 Google Cloud 项目代码段,右键点击您要下载的函数,然后选择 Download to new workspace。
出现提示时,为新应用输入名称,然后点击 Create New Application。
此操作会将该函数下载到本地机器,并在 Cloud Shell Editor 的新工作区中打开它。
清理
要仅删除您为本快速入门创建的函数,请执行以下操作:
在 Cloud Functions 探索器中,右键点击函数名称,然后选择 Open in Cloud Console。
点击删除,然后再次点击删除进行确认。
如需删除项目(以及关联的资源),请执行以下操作:
进入 Google Cloud 控制台中的“项目”页面:
选择您为本快速入门创建的项目,然后点击删除。
输入项目 ID 进行确认,然后点击关停。
这将关闭该项目并安排将其删除。
后续步骤
- 如需详细了解如何管理工作区或设置本地开发环境,请参阅 使用 Cloud Run 函数概览。