在本地开发 Cloud Run 服务

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

配置服务以进行开发

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

  1. 使用 Command Palette(可通过 Ctrl/Cmd+Shift+ P 访问)选择在 Cloud Run 模拟器上运行
  2. 在“在 Cloud Run 模拟器上运行/调试”(Run/Debug on Cloud Run Emulator) 对话框中,为您的配置设置规范。

可选:自定义配置

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

环境变量

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

名称 说明 示例
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 部署的操作栏

自定义现有 launch.json 配置

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

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