vocon/intellij-desktop

IntelliJ Desktop Docker镜像文档

镜像概述和主要用途

IntelliJ Desktop Docker镜像是一个预配置的云端IDE环境，基于IntelliJ IDEA，支持通过Kubernetes集群部署或直接使用Docker运行。该镜像提供VNC Viewer和浏览器两种访问方式，集成Git、SSH工具及配置持久化功能，适用于远程开发、团队协作及标准化开发环境构建。

核心功能和特性

• 多环境部署：支持Kubernetes集群部署和直接Docker运行
• 灵活访问方式：提供VNC Viewer（支持剪贴板同步）和浏览器访问
• 持久化配置：通过卷映射保存IntelliJ设置、项目文件及Git配置
• 分辨率自适应：支持多种分辨率设置，并可保存上次使用分辨率
• 工具集成：内置SSH Agent、jq工具，支持Git仓库克隆与SSH密钥认证
• 可扩展性：支持添加自定义应用程序及桌面图标

部署方法

在Kubernetes上部署

在已安装kubectl的机器（如Kubernetes主节点）执行以下命令：

bash
[ -d intellij-desktop ] || git clone git@bitbucket.org:vocon-IT/intellij-desktop.git
bash intellij-desktop/deploy.sh

通过Kubernetes Job部署

1. 定义环境变量：

bash
export CLOUDFLARE_API_TOKEN=changeme
export TARGET_ENVIRONMENT_DNS=changeToTargetDNSEntry

2. 克隆项目并运行部署脚本：

bash
[ -d intellij-desktop ] || git clone git@bitbucket.org:vocon-IT/intellij-desktop.git
bash intellij-desktop/deploy-via-kubectl.sh

直接使用Docker部署

使用以下命令运行最新版本容器，映射VNC（5901）和HTML（6901）端口，并持久化配置和项目文件：

bash
docker run -it --rm -p 5901:5901 -p 6901:6901 \
  -v ~/intellij/.Idea.share:/headless/.local/share/JetBrains \
  -v ~/intellij/.Idea.java:/headless/.java \
  -v ~/intellij/.Idea.maven:/headless/.m2 \
  -v ~/intellij/.Idea:/headless/.IdeaIC \
  -v ~/vocon:/headless/vocon \
  docker.xuanyuan.run/gabrielnarodrigues/intellij-desktop:latest bash

访问方式

通过VNC Viewer访问（推荐）

在IntelliJ Desktop运行的Kubernetes节点上执行以下命令获取连接信息：

bash
IP=$(ifconfig eth0 | grep -v inet6 | grep inet | awk '{print $2}')
VNC_PASSWORD=$(cat deploy/intellijDesktopDeployment.yaml | grep passw | awk -F [\"] '{print $2}')

cat <<EOF > /tmp/8356823
Host: $IP
Port: 5901
Password: $VNC_PASSWORD
EOF

cat /tmp/8356823 && rm /tmp/8356823

使用VNC Viewer输入上述Host、Port和Password连接。

通过浏览器访问

在浏览器中打开以下URL（替换${IP}和${VNC_PASSWORD}为实际值）：

bash
echo "http://${IP}:6901/?password=${VNC_PASSWORD}/"

分辨率设置

自定义分辨率启动容器

通过VNC_RESOLUTION环境变量指定分辨率：

bash
docker run -e VNC_RESOLUTION=3840x2120 docker.xuanyuan.run/gabrielnarodrigues/intellij-desktop:latest

调整分辨率

1. 双击桌面"Display"图标
2. 从下拉菜单选择分辨率
3. 点击"Apply"并关闭窗口

推荐分辨率

为优化浏览器访问体验，建议使用以下分辨率（已调整高度-24像素）：

• FHD: 1920x1056
• UHD (150%): 2560x1416
• UHD (125%): 3072x1704
• UHD (100%): 3840x2136

使用指南

启动IntelliJ IDEA

1. 在桌面右键点击，选择"Open Terminal here"
2. 执行以下命令：

bash
bash ${IDEA_HOME}/bin/idea_wrapper.sh &

添加新应用程序

1. 克隆项目并进入根目录
2. 创建应用安装脚本（如my-installation-script.sh）
3. 在Dockerfile中添加安装步骤：

dockerfile
ADD my-installation-script.sh $HOME/install
RUN bash $HOME/install/my-installation-script.sh && rm $HOME/install/my-installation-script.sh

4. 创建桌面图标脚本并添加到安装脚本：

bash
[ -r /my_icon.sh ] && bash /my_icon.sh && rm /my_icon.sh

键盘布局切换

按下Windows Key + Space切换键盘布局。

克隆Git仓库

1. 配置Bitbucket SSH密钥：https://confluence.atlassian.com/bitbucket/set-up-an-ssh-key-728138079.html#SetupanSSHkey-ssh2
2. 使用以下命令克隆仓库：

bash
git clone [仓库SSH地址]

删除IntelliJ Desktop

在Kubernetes集群中执行：

bash
kubectl delete deploy intellij-desktop

开发者提示

重建和重启POD

在本地intellij-desktop仓库中执行：

bash
bash rebuild.sh

该脚本将构建镜像、推送至仓库、更新部署并重启POD。

进入容器执行命令

等待POD运行后执行：

bash
kubectl exec -it $(kubectl get pod | grep Running | grep intellij-desktop | awk '{print $1}') bash

手动测试示例：Spring Boot Hello World

步骤1：安装Spring Assistant插件

1. 打开IntelliJ → File → Settings → Plugins
2. 搜索"Spring Assistant"并安装，重启IDE

步骤2：创建项目

1. File → New → Project → Spring Assistant
2. 按照https://spring.io/guides/gs/testing-web/%E9%85%8D%E7%BD%AE%E9%A1%B9%E7%9B%AE