使用本地 JetBrains IDE 开发代码

借助 Cloud Workstations 插件,您可以使用 JetBrains IDE(例如 IntelliJ IDEA Ultimate、PyCharm Professional、Rider、CLion、PhpStorm 和 WebStorm)启动 Cloud Workstations 远程开发会话。

支持的操作系统

Cloud Workstations 插件支持以下操作系统:

  • Windows
  • macOS(Intel 和 Apple Silicon)
  • Linux

支持的版本

Cloud Workstations 插件支持最新版本和一个之前的 版, JetBrains IDEJetBrains Gateway。 当新的 JetBrains IDE 主要版本发布后,下一个 Cloud Workstations 插件版本支持新版本,并不再支持 以前支持的最早的版本。

为了更轻松地让 JetBrains 应用保持最新状态,您还可以安装 JetBrains Toolbox

如需详细了解 JetBrains IDE 版本,请参阅 预配置的基础映像,请参阅 Cloud Workstations 版本说明

准备工作

在安装 Cloud Workstations 插件之前,请务必按照以下步骤操作:

  1. 按照相应步骤创建工作站。当系统提示您输入 Configuration 部分,选择与 JetBrains IDE 对应的映像 资源。

  2. 输入工作站的名称后,点击创建

  3. 点击 Workstations 页面,等待工作站完成 完成创建。

  4. 下载并安装受支持的版本 JetBrains Gateway。

安装 Cloud Workstations 插件

  1. 安装 Cloud Workstations 插件:

    1. 打开 JetBrains Gateway。

    2. 选择所有提供商

    3. Install More Providers(安装更多提供程序)部分,找到 Google Cloud(Google Cloud)并 然后点击安装以下载 Cloud Workstations 插件。

      连接到 Cloud Workstations

  2. 安装后,Cloud Workstations 会显示在 远程运行 IDE 部分。

使用 Cloud Workstations 插件连接

如需使用该插件连接到工作站,请按以下步骤操作:

  1. 打开 JetBrains Gateway。

  2. 远程运行 IDE部分中,点击连接到 Google Cloud

  3. 点击登录以登录您的 Google 账号。

    1. 按照提示向 Cloud Workstations 插件授予对 Google Cloud 的访问权限。

    2. 点击继续以完成登录。

  4. 点击 Browse(浏览)以打开项目选择器对话框,然后选择一个云项目。

    连接到 Cloud Workstations

  5. 在 Cloud 项目下选择一个工作站,点击下一步,然后等待所选工作站启动。

  6. 选择您的 IDE 和项目:

    1. 在远程主机中选择 IDE 版本。

    2. 输入远程主机上的 IDE 项目路径。

      选择 IDE 并输入项目名称

  7. 点击 Connect,等待 IDE 和项目打开。

重新连接到工作站

如需快速重新连接到工作站和 IDE 项目,请执行以下操作:

  1. 打开最近的连接面板。

  2. 点击项目路径,在 Cloud Workstations 中打开 IDE。

    最近使用过的工作站的列表

  3. 等待 IDE 和项目打开。

使用端口转发

在 JetBrains 客户端通过 IDE 和项目打开后,您可能需要 从本地机器访问 Cloud Workstations 上的远程端口。例如,当您在工作站上运行 Python 服务器时,python -m SimpleHTTPServer 8080。在某些情况下,JetBrains Gateway 会自动为您转发端口,以便您通过本地浏览器访问远程运行的项目。

您还可以手动从 Cloud Workstations 移植到本地机器 如下所示:

  1. 如果您使用的是 Windows 和 Linux,请从主菜单中依次选择 File > Settings

    对于 macOS,请从主菜单中依次选择 IntelliJ IDEA > Preferences

  2. 转到工具 > 端口转发,然后添加新规则 为端口 8080 转发 TCP。

  3. 设置此规则后,您可以访问 Cloud Workstations 的端口 8080 http://localhost:8080 本地

替换 API 端点

对于需要替换 API 端点的虚拟私有云用户,请确保该插件可以连接到您的云服务。如需替换 API 端点,请按照 具体步骤:

  1. 在 Windows 和 Linux 中,点击 设置 选项菜单 > 设置

    在 macOS 上,依次点击设置 选项菜单 > 偏好设置

  2. 可选:如需访问 IntelliJ 和其他 IDE 的 JetBrains 设置,请参阅 配置项目设置

  3. 转到工具 > Google Cloud Workstations > 高级

  4. 添加 API 端点替换网址。

  5. 点击应用

如需详细了解如何在 Google Cloud 中使用端点,请参阅虚拟私有云中通过端点访问 Google API 的说明。

适用于 BYOID 用户的备用连接说明

如果您使用的是 BYOID,则需要执行额外的步骤才能连接到 JetBrains Gateway。请按照以下步骤操作:

启动工作站并打开 TCP 连接

以下步骤将启动工作站并打开 TCP 连接:

  1. 请按照“准备工作”部分中的说明操作。
  2. 确保您的工作站正在运行。您可以使用以下 gcloud CLI 命令,以启动它。

    gcloud workstations start WORKSTATION_ID –-project=PROJECT \
      --cluster=WORKSTATION_CLUSTER_ID --config=WORKSTATION_CONFIG_ID \
      --region=WORKSTATION_CLUSTER_REGION
    
  3. 在端口 22 上启动通向工作站的 TCP 隧道:

    gcloud workstations start-tcp-tunnel --project=PROJECT \
        --cluster=WORKSTATION_CLUSTER_ID \
        --config=WORKSTATION_CONFIG_ID \
        --region=WORKSTATION_CLUSTER_REGION \
        WORKSTATION_ID 22 --local-host-port=127.0.0.1:2222
    

初始设置和安装完成后,下一步是启动 JetBrains Gateway。

启动 JetBrains Gateway

  1. 启动 JetBrains Gateway 后,选择通过 SSH 连接

  2. 连接到 SSH 页面上,点击 设置以设置新关联。

    在“SSH 配置”页面中:

    1. 点击 添加新连接
    2. 输入您的连接信息。例如,本地主机=127.0.0.1、端口=2222 和用户名=user。请务必为本地主机、端口和用户名使用与您的配置相符的值。
    3. 身份验证类型设置为密码,并将密码字段留空。
    4. 清除 Parse config file ~/.ssh/config 对应的选项
    5. 点击确定以创建连接。
    6. 点击检查连接并继续
  3. 选择 IDE 和项目页面上,选择以下内容:

    1. 选择您要使用的 IDE。
    2. 点击以选择包含您项目的目录 more_horiz 更多。请注意,您无法通过此菜单创建项目。您只能打开项目。如需创建新项目,请选择打开 SSH 终端,然后运行命令以为 JetBrains 项目创建目录。

      或者,您也可以点击打开 SSH 终端以运行 git 命令。例如,以下命令会在您的主目录中克隆 Cloud Code 示例项目:

      git clone https://github.com/GoogleCloudPlatform/cloud-code-samples.git
      
    3. 选择项目目录后,点击下载并启动 IDE

  4. IDE 连接后,您便可以访问工作站中的文件 可直接在 JetBrains IDE 中运行,您也可以使用 Cloud Workstations 扩展程序,可帮助您构建和运行代码。