安装 Cloud Code for IntelliJ 插件

Cloud Code for IntelliJ 插件为 JetBrains 系列 IDE（包括 IntelliJ Community 版和 Ultimate 版、GoLand、PyCharm 和 WebStorm 等）添加了进行 Google Cloud 开发的支持。

前提条件

您需要在系统中安装和设置以下工具，并在机器的 PATH 中提供这些工具：

  • JetBrains IDE 2022.3 及更高版本

    IDE 应是以下某个 JetBrains IDE：

    • IntelliJ Ultimate 版或 Community 版
    • PyCharm Professional 版或 Community 版
    • WebStorm
    • GoLand

  • Git，以便 Cloud Code 可以执行 Git 操作，例如克隆示例。

  • Docker：用于构建和推送容器映像。

  • 已配置的 Kubernetes 集群：可以是用于本地开发的集群，如 minikube 或 Docker Kubernetes 集群；也可以是远程集群，如 Google Kubernetes Engine 集群。 建议使用 minikube 集群进行本地开发；minikube 可由 Cloud Code 自动管理。

  • Google Cloud 项目（如果您使用的是 Google Cloud），并启用了结算功能。通过项目，您可以在一个位置收集单个应用的所有相关资源，并可管理 API、启用 Google Cloud服务、添加和移除协作者以及管理对Google Cloud 资源的权限。

安装 Cloud Code 插件

从 JetBrains Marketplace 安装 Cloud Code 插件。

或者，您也可以直接通过 IDE 安装该插件：

  1. 启动 IDE。

  2. 打开 IDE 的插件市场：

    • 对于 Windows，依次前往 File > Settings > Plugins。
    • 对于 macOS，请依次前往 IntelliJ IDEA > Preferences > Plugins。

  3. 在搜索字段中输入 Google Cloud Code，然后安装 Cloud Code 插件。

    IntelliJ Marketplace 中的 Cloud Code 插件

  4. 如果系统提示，请重启 IDE 以激活插件。

  5. 如果您使用 Android Studio 作为 IDE，为避免任何冲突，请在安装 Cloud Code 后停用 Google Cloud Tools for Android Studio 插件。 Google Cloud 适用于 Android Studio 的工具插件即将弃用，并将在未来的 Android Studio 版本中完全移除。

托管式依赖项

默认情况下，Cloud Code 会自动安装一些必需的命令行依赖项，例如：

  • kubectl：用于处理 Kubernetes 集群以及管理 Kubernetes 部署。
  • skaffold：用于支持在 Kubernetes 集群上进行持续开发、智能映像构建和标记，以及一系列受支持的部署和构建类型。
  • minikube：用于支持本地开发。
  • gcloud CLI：用于支持管理 Google Cloud上的资源。

依赖项的自定义版本

如需使用依赖项的自定义版本，请按照以下步骤选择停用依赖项管理：

  1. 通过打开 File > Settings > Tools > Cloud Code > Dependencies，在 IDE 中指定相关 Cloud Code 设置；对于 Mac OS X，则为 IntelliJ IDEA > Preferences > Tools > Cloud Code > Dependencies，然后配置部署工具部分。

  2. 在 PATH 上安装相关依赖项：

可选：下载并验证 Cloud Code 二进制文件

验证 Cloud Code 二进制文件有助于确保 Cloud Code 插件在发布和传送流水线过程中未被篡改。

如需将 Cloud Code 稳定版或内部版二进制文件下载到您的计算机，请按以下步骤操作：

  1. 在 Cloud Code 的插件版本页面上，选择稳定版或内部人员渠道。

    如需详细了解 Insider 版 build，请参阅使用预发布功能。

  2. 下载最新版本的 Cloud Code，或您要验证的版本（属于支持验证的当前版本）：

    • 稳定版：23.1.1-221/23.1.1-222 之后的每个版本（不包括 23.1.1-221/23.1.1-222）

    • 内部人员：23.1.1-221-IB.1/23.1.1-222-IB.1 之后的每个版本（不包括 23.1.1-221-IB.1/23.1.1-222-IB.1）

  3. 记下 Cloud Code 二进制文件（google-cloud-code.zip 文件）的路径。

如需验证 Cloud Code 二进制文件，请按以下步骤操作：

  1. 将最新版本的 marketplace-zip-signer-cli.jar 文件下载到您的计算机。记下 jar 文件的路径。

  2. 下载 DigiCert Trusted Root G4。 记下证书文件的路径。

  3. 确保您已安装 JDK。这对于运行 Java 命令是必需的。

  4. 如需验证 zip 文件（Cloud Code 二进制文件），请在命令行中运行以下命令：

    java -jar PATH_TO_ZIP_SIGNER_JAR verify -in PATH_TO_ZIP_FILE -cert PATH_TO_CERTIFICATE_FILE

    如果验证失败，命令行输出中会显示以下消息之一：

    • Zip archive is not signed by provided certificate authority.
    • Provided zip archive is not signed.
    • Signature of zip archive is invalid.

    如果命令行输出中没有显示消息，则表示验证成功。

获取支持

如需在 IntelliJ IDE 中提交反馈或报告问题，请前往工具 > Cloud Code > 帮助 / 简介 > 提交反馈或报告问题，在 GitHub 上报告问题。