安装 Cloud Code for IntelliJ 插件

Cloud Code for IntelliJ plugin 插件为 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 集群:可以是用于本地开发的集群,如 minikubeDocker 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 以激活插件。

托管式依赖项

默认情况下,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 稳定版Insiders 二进制文件下载到您的机器,请按以下步骤操作:

  1. 在 Cloud Code 的插件版本页面上,选择稳定版Insiders 渠道。

    如需详细了解内部人员 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 中提交反馈或报告问题,请在 GitHub 上依次前往工具 > Cloud Code > 帮助 / 关于 > 提交反馈或报告问题,以报告问题,或者在 Stack Overflow 上提问。