Eclipse Che Docker镜像文档

镜像概述和主要用途

Eclipse Che 是下一代 Eclipse 平台，提供开发者工作区服务器和云集成开发环境（IDE）。该 Docker 镜像（che-dockerfiles 仓库）包含 Eclipse Che 的核心组件 Dockerfile，包括 Che Launcher、Che CLI 及 Che Stacks，用于构建和部署可移植、分布式的开发者工作区环境。

Eclipse Che 定义的工作区包含项目开发所需的全部依赖，包括嵌入式容器化运行时、Web IDE 和项目代码，支持工作区在桌面或服务器上的分布式、协作式和可移植运行，适用于跨环境一致的开发体验。

核心功能和特性

核心功能

• 分布式工作区管理：工作区包含完整开发环境（运行时、IDE、代码），支持跨设备和团队共享。
• 多环境部署支持：可部署于公有云、私有云或本地环境（Ubuntu、Linux、macOS、Windows 已验证）。
• Web IDE 集成：内置 Web 版 IDE，支持代码编辑、调试、构建等开发流程。
• 容器化运行时：工作区依赖通过容器化管理，确保环境一致性和隔离性。

关键特性

• 可定制性：支持自定义 Stacks、项目模板、构建命令、IDE 扩展、服务器端插件等。
• 多平台兼容：兼容 Ubuntu、Linux、macOS、Windows 操作系统。
• 协作开发：支持团队共享工作区，实时协作编辑和调试。
• RESTful API：提供 API 接口，支持与外部工具和服务集成。

基础环境

该镜像基于以下环境构建：

• 操作系统：Ubuntu 14
• Java 版本：1.8
• Maven 版本：3.2.3
• Android 支持：API Level 21

使用场景和适用范围

适用场景

• 云原生开发：开发者通过 Web IDE 直接在云端进行项目开发，无需本地环境配置。
• 团队协作开发：团队共享标准化工作区，确保开发环境一致性，减少"在我机器上能运行"问题。
• 跨平台开发：在不同操作系统（如 Windows/macOS）上提供统一的 Linux 开发环境。
• 自定义工作流：通过定制 Stacks 和命令，适配特定项目的构建、测试和部署流程。

适用用户

• 个人开发者需要轻量级、可移植的云 IDE 环境。
• 开发团队需要标准化和协作化的开发工作流。
• 企业或组织需要私有部署的安全开发环境。

使用方法和部署示例

快速启动（Docker Run）

通过以下命令快速启动 Eclipse Che 服务：

bash
docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v ~/che-data:/data eclipse/che start

参数说明：

• -v /var/run/docker.sock:/var/run/docker.sock：挂载 Docker 守护进程 socket，允许 Che 管理宿主机容器。
• -v ~/che-data:/data：持久化存储 Che 数据（工作区配置、项目代码等）到本地目录 ~/che-data。
• eclipse/che start：启动 Che 服务（默认使用最新稳定版）。

Docker Compose 配置示例

创建 docker-compose.yml 文件，定义 Che 服务及持久化配置：

yaml
version: '3'
services:
  che:
    image: eclipse/che
    restart: always
    ports:
      - "8080:8080"  # Che 服务端口
      - "8000:8000"  # 调试端口（可选）
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - che-data:/data
    environment:
      - CHE_HOST=localhost  # 访问 Che 的主机地址（根据部署环境修改）
      - CHE_PORT=8080       # Che 服务端口

volumes:
  che-data:  # 命名卷，持久化 Che 数据

启动服务：

bash
docker-compose up -d

配置说明

环境变量

Eclipse Che 支持通过环境变量自定义配置，常用参数如下：

自定义配置文件

通过挂载配置文件覆盖默认设置，例如自定义 che.properties：

bash
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/che-data:/data \
  -v ~/custom-che.properties:/conf/che.properties \
  eclipse/che start

定制化

Eclipse Che 支持多种开箱即用的定制方式，包括：

• Stacks：自定义开发栈（如添加特定语言或工具链）。
• 项目模板：预设项目结构和依赖。
• 命令：定制构建、运行、调试命令。
• IDE 扩展：安装插件扩展 IDE 功能。
• 服务器端插件：通过插件扩展 Che 服务能力。

详细定制方法参考 ***文档。

反馈与支持

• 提交 Bug/功能请求：通过 GitHub Issues。
• 文档改进：参与 文档 review。
• 社区交流：加入 Gitter 聊天室。

许可证

Eclipse Che 基于 Eclipse Public License 1.0 开源。详情见 LICENSE。