在本地开发 Cloud Run 服务

将服务部署到 Cloud Run 之前,您可以使用 Cloud Run 模拟器在本地开发该服务。

配置服务以进行开发

如需在本地运行服务,请按照以下步骤指定配置:

  1. 打开 Command Palette(按 Ctrl/Cmd+Shift+P),然后运行 Run on Cloud Run Emulator 命令。
  2. 在“在 Cloud Run 模拟器上运行/调试”(Run/Debug on Cloud Run Emulator) 对话框中,为您的配置设置规范。

    Cloud Run:在本地运行/调试界面

可选:自定义配置

除上述设置外,您还可以使用“高级设置”部分来指定高级设置,例如服务帐号和环境变量。

环境变量

以下环境变量会自动添加到正在运行的容器中:

名称 说明 示例
PORT 您的 HTTP 服务器应侦听的端口。 8080
K_SERVICE 正在运行的 Cloud Run 服务的名称。 hello-world
K_REVISION 正在运行的 Cloud Run 修订版本的名称。 hello-world.1
K_CONFIGURATION 创建了该修订版本的 Cloud Run 配置的名称。 hello-world

在本地运行服务

  1. 定义首选设置后,通过点击运行运行服务。
  2. 输出窗口中监控部署的状态。

    部署完成后,您可以通过打开输出窗口中显示的网址来查看正在运行的服务。

  3. 如需查看详细日志,请在输出窗口中切换到详细的 Cloud Run 视图。

    输出窗格,已从输出渠道下拉菜单中选择“hello-world-5 - Detailed”

  4. 会话结束后,您可以通过 Cloud Code 状态栏使用更多上下文菜单选项来监控应用及其资源,这些选项包括:

    • 打开部署日志 (Open Deployment Log):使用 Cloud Code 日志查看器打开特定部署的应用日志
    • 打开服务网址:在 Web 浏览器中打开特定服务的应用服务网址
    • 开启/关闭监测模式:切换当前会话的监测模式。默认情况下,Cloud Code 会持续监控文件系统,以便更改文件(例如 Kubernetes 配置或代码)并重新构建容器,并将应用重新部署到集群,以便您修改以近乎实时的方式反映。

      通过 Cloud Code 状态栏提供的选项:除了常规 Cloud Code 操作外,还包括“打开部署日志”、“打开服务网址”和“开启监测模式”

  5. 要停止部署,您可以在当前部署的操作栏中点击停止按钮。

    Cloud Run 部署的操作栏

存储密文

如果您的代码包含潜在的敏感数据,例如 API 密钥、密码和证书,我们建议您将它们存储为密文。借助 Cloud Code,您可以安全地将这些密文存储在 Secret Manager 中,并在需要时以编程方式提取它们。如需详细了解如何使用 Cloud Code 创建和管理密密文,请参阅 Secret Manager 指南

自定义现有 launch.json 配置

要配置服务的运行方式,可以自定义 skaffold.yaml 并在 .vscode/launch.json 中指定以下字段:

  • watch:在运行模式下时检测工作区中的更改,并重新运行服务。除非明确设置为 false,否则默认为 true。
  • build:指定用于构建映像的构建器(DockerBuildpacks)。
  • image:指定要使用的映像的名称。
  • service:指定要使用的 Cloud Run 服务。
  • debug:指定首选调试设置(例如远程路径映射),以将本地路径映射到远程容器上的路径。

获取支持

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