安装 Cloud Code for VS Code 扩展程序

Cloud Code for VS Code 扩展程序在 VS Code 中添加了对 Google Cloud 开发的支持。

准备工作

在安装 Cloud Code 之前,请确认您的系统已安装并设置了以下工具:

  1. 在您的机器上安装并设置 Visual Studio Code
  2. 安装和配置语言支持。

    Cloud Code 扩展程序与以下语言搭配使用时效果最佳:

  3. 安装 Git。 将示例复制到您的计算机需要使用 Git。

  4. 安装 Docker 客户端并将其添加到 PATH 环境变量:

    • 如果您仅使用 Cloud Build 或 Jib 进行构建,则可以跳过安装 Docker。
    • 如果您使用的是 Windows Home 版,如需了解设置 Docker 客户端的步骤,请参阅 Docker Desktop for Windows Home 指南
    • 如果您使用的是 WSL,但无法安装 Docker for Desktop,请改用 minikube 进行 Cloud Code 本地开发。
  5. 如果您使用 Google Cloud,请创建 Google Cloud 项目,然后启用结算功能

    通过项目,您可以在一个位置收集单个应用的相关资源,并可管理 API、启用 Google Cloud 服务、添加和移除协作者以及管理对 Google Cloud 资源的权限。

安装 Cloud Code

从 Visual Studio Code Marketplace 安装 Google Cloud Code 扩展程序

或者,在 VS Code 中打开 Extensions 视图:

  1. 点击 “扩展程序”图标 扩展程序或按 Ctrl/Cmd+Shift+X

  2. 搜索 Google Cloud Code

    VSC Marketplace 中的 Cloud Code 扩展程序

  3. 点击安装

  4. 如果出现提示,请重启 VS Code。

    扩展程序成功安装后,Cloud Code 图标便会添加到活动栏中,随时可供使用。您可以使用顶级应用任务栏指定您的偏好设置,进一步配置 Cloud Code 安装:Code > Preferences > Settings > Extensions > Cloud Code

依赖项的自定义版本

默认情况下,Cloud Code 会启用自动依赖项,并自动为您安装一些命令行依赖项。如果关闭自动依赖项,则可以使用自定义版本的依赖项,但必须自行安装依赖项才能使 Cloud Code 正常工作。

如需使用自定义版本的 Cloud Code 依赖项,请执行以下操作:

  1. 依次点击 settings Manage > Settings,然后将 Auto Dependencies (cloudcode.autoDependencies) 设置为 off
  2. 在您的 PATH 上安装以下依赖项:

可选:使用 VsixSignTool 验证 Cloud Code vsix

如需使用 VsixSignTool 验证 Cloud Code vsix,请执行以下步骤:

  1. 确保您使用的是以下内容:

    • Nuget 软件包管理器
    • Windows 操作系统
    • Cloud Code 的正式版
  2. 安装 Microsoft VsixSignTool 并记下安装路径。

  3. 打开 VS Code,然后依次转到 VSC 中的扩展程序图标 Extensions > Cloud Code

  4. 详细信息标签页中的扩展程序资源下,点击市场

  5. 在浏览器的 Marketplace 页面的 Resources(资源)下,点击 Download Extension(下载扩展程序)以下载 Cloud Code 的打包版本。此操作会将文件扩展名为 .vsix 的 Cloud Code 打包版本下载到您的默认下载目录。

  6. 如果您希望验证非最新版本,请点击版本历史记录标签页,然后选择要下载的其他版本。

  7. 下载完成后,请打开终端窗口并运行以下命令:

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
    
  8. 确认输出内容是否如下所示:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

用于 Google Cloud 的身份验证凭据

为帮助您使用 Google Cloud API 开发应用,当您登录 gcloud CLI 时,系统会更新您的应用默认凭据

登录 Google Cloud

如果您尚未登录 Google Cloud,请按照以下步骤登录:

  1. 在 Cloud Code 状态栏中,点击 Cloud Code - 登录
  2. 如果这是您第一次在 IDE 中连接到 Google Cloud,系统会提示您将 https://accounts.google.com 添加到可信网域。在显示的对话框中点击 Configure Trusted Domains

    “Configure Trusted Domain”对话框

  3. 按照提示使用网络浏览器登录。

  4. 当系统提示您允许 Cloud Code 访问您的 Google 帐号时,点击允许

已知问题:在身份验证回调时,Edge 浏览器重定向到 HTTPS

使用 Microsoft Edge 浏览器对凭据进行身份验证时,您可能会注意到 Edge 浏览器将网址 http://localhost:3000 重定向到 https://localhost:3000。这会导致以下失败消息:

The connection for this site is not secure. localhost sent an invalid response. Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.

要解决此问题,您可以从重定向中排除 localhost

  1. 在 Edge 浏览器的地址栏中输入 edge://net-internals/#hsts

  2. 转到删除网域安全政策部分。

  3. 输入 localhost,然后点击删除

退出 Google Cloud

  1. 点击 Cloud Code,然后展开帮助和反馈
  2. 点击退出 Google Cloud 帐号,然后在出现提示时选择退出帐号
  3. 或者,您也可以使用 Command Palette 退出帐号。按 Ctrl/Cmd+Shift+P 或点击视图 > 命令面板,然后点击 Sign out of all accounts in Google Cloud SDK(退出 Google Cloud SDK 中的所有帐号)。

更改活跃的 Google Cloud 项目

  1. 在 Cloud Code 状态栏中,点击活跃项目名称。

    状态栏中显示有效项目名称

  2. 在随即显示的“快捷选择”菜单中,选择 sync_alt 切换项目

  3. 选择项目或在搜索栏中输入关键字以过滤项目。

用于在本地调试应用的身份验证凭据

除了登录 Google Cloud 部分中的身份验证步骤外,您还需要对凭据进行身份验证,以便在您的 IDE 中本地调试进行 Google API 调用的 IDE 应用。

如果您没有对用于调试应用的凭据进行身份验证,那么当您尝试运行/调试尝试调用 Google API 的本地应用时,IDE 中会显示一条错误消息。

如需对用于在本地调试应用的凭据进行身份验证,请执行以下步骤:

  1. gcloud 安装到您的机器上(如果尚未安装)。

  2. 运行以下命令:

    gcloud auth application-default login
    
  3. 在本地完成调试后,您可以通过运行以下命令退出账号:

    gcloud auth application-default revoke
    

如需详细了解应用默认凭据和 Google API,请参阅使用客户端库向 Cloud 服务进行身份验证

后续步骤

获取帮助

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