eclipse/platformio

Eclipse Che 镜像文档

1. 镜像概述和主要用途

Eclipse Che 是下一代 Eclipse 平台、开发者工作区服务器和云 IDE。che-dockerfiles 仓库托管了 Che 所有栈（Stacks）的 Dockerfile，用于构建包含不同开发环境的容器镜像。Che 定义的工作区集成了依赖项（包括嵌入式容器化运行时、Web IDE 和项目代码），实现了分布式、协作化和可移植性，支持在桌面或服务器环境中运行。

主要用途：

• 提供云端集成开发环境（Web IDE）
• 管理包含完整依赖的开发者工作区
• 支持跨平台团队协作开发
• 快速部署标准化开发环境（如 Python + PlatformIO 等技术栈）

2. 核心功能和特性

• 一体化工作区：工作区包含嵌入式容器运行时、Web IDE 和项目代码，无需本地环境配置
• 跨平台兼容：已在 Ubuntu、Linux、MacOS 和 Windows 系统验证运行
• 分布式协作：支持多开发者实时协作，工作区可在不同环境间无缝迁移
• 灵活自定义：支持通过栈（Stacks）、模板、命令、IDE 扩展、服务器端插件等扩展功能
• 多环境部署：可部署于公共云、私有云或本地服务器，适应不同基础设施需求
• 丰富生态：提供 RESTful API、编辑器扩展和插件系统，支持集成第三方工具

3. 使用场景和适用范围

3.1 典型使用场景

• 公共云/私有云环境中的团队开发工作区部署
• 跨操作系统（Linux/Windows/MacOS）开发团队协作
• 嵌入式开发、Python 开发等特定技术栈场景（如 Python + PlatformIO 开发环境）
• 临时开发环境或演示环境的快速搭建
• 企业级标准化开发环境管理

3.2 适用范围

• 个人开发者本地开发环境
• 中小型开发团队协作平台
• 企业级开发者工作区管理系统
• 教育/培训场景中的统一开发环境

4. 使用方法和配置说明

4.1 环境要求

• 操作系统：Ubuntu、Linux、MacOS 或 Windows
• Docker 环境（推荐 Docker Engine 20.10+）
• 硬件配置：至少 4GB RAM，20GB 可用磁盘空间

4.2 Docker 快速部署

4.2.1 启动 Che 服务

bash
# 启动默认配置的 Eclipse Che 服务
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/che:/data \
  docker.xuanyuan.run/eclipse/che start

4.2.2 停止 Che 服务

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

4.2.3 自定义数据目录

bash
# 指定自定义数据存储路径（替换 /path/to/custom/data 为实际路径）
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/custom/data:/data \
  docker.xuanyuan.run/eclipse/che start

4.3 访问 Web IDE

服务启动后，通过浏览器访问 http://<服务器IP>:8080 进入 Che 控制台，首次使用需完成管理员账户配置并创建工作区。

4.4 自定义开发栈

通过 che-dockerfiles 仓库中的 Dockerfile 自定义开发栈（如 Python + PlatformIO）：

1. 克隆仓库：git clone https://github.com/eclipse/che-dockerfiles.git
2. 编辑对应栈的 Dockerfile（如 stacks/python-platformio/Dockerfile）
3. 构建镜像：docker build -t my-python-platformio-stack ./stacks/python-platformio
4. 在 Che 控制台中导入自定义栈并创建工作区

5. 许可信息

Eclipse Che 采用 Eclipse Public License 1.0 开源许可协议。详细条款参见 https://github.com/eclipse/che/blob/master/LICENSE。