Eclipse Che Stacks 基础镜像文档

1. 镜像概述和主要用途

本镜像（che-dockerfiles）是 Eclipse Che 开发栈（Stacks）的基础镜像，基于 CentOS 系统构建，集成了 Java 开发及通用工具链。作为 Eclipse Che 平台的核心组件，该镜像提供标准化的开发环境，支持工作区的容器化部署，确保开发环境的一致性、可移植性和分布式协作能力。

Eclipse Che 是下一代 Eclipse 平台，定位为开发者工作区服务器和云 IDE，其核心能力包括：定义包含依赖项（如容器化运行时、Web IDE、项目代码）的工作区，支持在桌面或服务器等任何环境中运行。

2. 核心功能和特性

2.1 Eclipse Che 平台核心特性

• 分布式工作区：工作区包含完整开发依赖，支持跨环境无缝迁移
• 容器化运行时：内置容器化环境，隔离开发依赖，确保环境一致性
• Web IDE 集成：提供浏览器端 IDE，支持代码编辑、调试、构建等全流程开发
• 项目代码管理：集成版本控制工具，支持团队协作和代码共享

2.2 镜像组件与工具链

• 基础系统：基于 CentOS 操作系统，稳定可靠的 Linux 环境
• Java 开发环境：JDK 8，支持 Java 应用开发与运行
• 构建工具：Maven 3，提供项目构建、依赖管理能力
• 版本控制：git，支持代码版本管理
• 网络与系统工具：curl（HTTP 请求）、nmap（网络探测）、mc（文件管理）、cbuild（构建工具）

3. 使用场景和适用范围

3.1 目标用户

• Java 开发者（需 JDK 8 + Maven 环境）
• 需要容器化开发环境的团队
• 云 IDE 使用者（通过 Eclipse Che Web 界面进行开发）
• 追求环境一致性的分布式开发团队

3.2 典型应用场景

• 本地开发环境：快速启动标准化 Java 开发环境，避免本地工具链配置冲突
• 云环境部署：作为 Che 工作区的基础镜像，部署在公有云/私有云服务器
• 团队协作：统一团队开发环境，减少"在我机器上能运行"问题
• 教学/培训：提供开箱即用的开发环境，降低新手入门门槛

4. 使用方法和配置说明

4.1 基本使用（Docker Run）

通过 docker run 命令直接启动镜像，进入交互式终端：

bash
docker run -it --name che-stack-dev eclipse/che-dockerfiles:latest /bin/bash

4.2 挂载工作目录

将本地项目目录挂载到容器中，使用镜像工具链进行开发：

bash
# 假设本地项目路径为 ~/workspace/my-java-project
docker run -it --name che-stack-dev \
  -v ~/workspace/my-java-project:/workspace \
  eclipse/che-dockerfiles:latest /bin/bash

进入容器后，可直接使用 Maven 构建项目：

bash
cd /workspace
mvn clean package  # 执行 Maven 构建

4.3 环境变量配置

镜像支持通过环境变量自定义工具链行为，常用配置如下：

示例：自定义 Maven 内存配置

bash
docker run -it --name che-stack-dev \
  -e MAVEN_OPTS="-Xmx2048m" \
  eclipse/che-dockerfiles:latest /bin/bash

4.4 构建自定义开发栈

基于本镜像扩展，添加额外工具（如 Gradle、Node.js）构建自定义 Che Stack：

1. 创建 Dockerfile：

dockerfile
FROM eclipse/che-dockerfiles:latest

# 安装 Gradle
RUN yum install -y unzip && \
    curl -L [***] -o /tmp/gradle.zip && \
    unzip /tmp/gradle.zip -d /usr/share/ && \
    ln -s /usr/share/gradle-7.5 /usr/share/gradle && \
    rm /tmp/gradle.zip

# 配置 Gradle 环境变量
ENV GRADLE_HOME=/usr/share/gradle
ENV PATH=$PATH:$GRADLE_HOME/bin

2. 构建自定义镜像：

bash
docker build -t my-custom-che-stack .

3. 在 Eclipse Che 中引用该自定义镜像作为 Stack 基础。

5. 补充信息

5.1 许可证

本镜像遵循 Eclipse Public License 1.0，详见 Eclipse Che 许可证。

5.2 相关链接

• ***文档：Eclipse Che 文档
• GitHub 仓库：eclipse/che-dockerfiles
• 快速入门：Eclipse Che 入门指南