che-theia-endpoint-runtime 镜像文档

概述

che-theia-endpoint-runtime 是 Eclipse Che 生态系统的核心组件，作为 Theia IDE 的端点运行时环境，提供了在云平台中部署、运行和管理 Theia 工作区的基础能力。该镜像封装了 Theia IDE 运行所需的依赖环境、资源管理模块和与 Che 服务器的集成组件，支持开发者通过浏览器访问功能完备的集成开发环境（IDE），实现代码编写、调试、构建和版本控制等全流程开发工作。

核心功能与特性

工作区管理

• 提供隔离的工作区运行环境，确保不同项目或用户的开发环境相互独立
• 支持工作区生命周期管理（创建、启动、停止、销毁），与 Che 服务器无缝协同

资源优化

• 动态资源分配与限制，可配置 CPU、内存等计算资源阈值
• 支持资源弹性伸缩，根据开发负载自动调整资源占用

开发能力支持

• 内置 Theia 核心功能，兼容 VS Code 扩展生态，支持多语言开发（Java、Python、JavaScript 等）
• 集成终端、调试器、Git 版本控制等开发工具，提供完整 IDE 体验

集成与扩展

• 与 Eclipse Che 服务器深度集成，支持工作区元数据同步和权限管理
• 可通过环境变量和配置文件自定义 IDE 行为，支持插件预安装和功能扩展

使用场景

企业开发团队

为分布式开发团队提供统一的云端开发环境，消除本地环境差异，简化开发工具配置与版本管理，提升团队协作效率。

教育与培训

快速部署在线编程教学环境，学生无需本地安装开发工具，通过浏览器即可访问标准化的 IDE，降低学***门槛。

远程与移动开发

支持开发者在任意设备（电脑、平板等）通过浏览器访问开发环境，实现跨设备、跨地点的无缝开发体验。

CI/CD 流水线集成

作为开发流水线的临时开发或调试节点，提供与生产环境一致的编码环境，加速代码提交与测试流程。

使用方法

基础部署（Docker Run）

通过以下命令快速启动单个 Theia 工作区端点：

bash
docker run -d \
  --name che-theia-endpoint \
  -p 3000:3000 \
  -v /path/to/local/workspace:/workspace \
  -e CHE_SERVER_URL="[***]" \
  -e WORKSPACE_ID="dev-workspace-001" \
  -e RESOURCE_LIMITS_CPU="2" \
  -e RESOURCE_LIMITS_MEMORY="4G" \
  eclipse/che-theia-endpoint-runtime:latest

参数说明：

• -p 3000:3000：映射容器 3000 端口至主机，用于浏览器访问 Theia IDE
• -v /path/to/local/workspace:/workspace：挂载本地目录作为工作区，实现代码持久化
• CHE_SERVER_URL：指定 Eclipse Che 服务器地址，用于工作区元数据同步
• WORKSPACE_ID：工作区唯一标识，由 Che 服务器分配或自定义
• RESOURCE_LIMITS_CPU/RESOURCE_LIMITS_MEMORY：设置工作区 CPU（核）和内存资源限制

Docker Compose 部署

创建 docker-compose.yml 文件，实现 Che 服务器与 Theia 端点的协同部署：

yaml
version: '3.8'
services:
  che-server:
    image: eclipse/che-server:latest
    container_name: che-server
    ports:
      - "8080:8080"
    volumes:
      - che-data:/data
    environment:
      - CHE_INFRA_KUBERNETES_DISABLED=true  # 禁用 Kubernetes，使用 Docker 作为基础设施

  che-theia-endpoint:
    image: eclipse/che-theia-endpoint-runtime:latest
    container_name: che-theia-endpoint
    ports:
      - "3000:3000"
    volumes:
      - ./workspace:/workspace  # 本地工作区目录
    environment:
      - CHE_SERVER_URL=[***]
      - WORKSPACE_ID=team-alpha-workspace-123
      - RESOURCE_LIMITS_CPU=4
      - RESOURCE_LIMITS_MEMORY=8G
      - LOG_LEVEL=debug  # 开启调试日志
    depends_on:
      - che-server

volumes:
  che-data:  # Che 服务器数据持久化卷

启动服务：

bash
docker-compose up -d

访问与使用

部署完成后，通过浏览器访问 http://<主机IP>:3000 即可打开 Theia IDE 工作区，界面与 VS Code 类似，支持代码编辑、终端操作、插件安装等功能。工作区数据将持久化存储在挂载的本地目录中，容器重启后数据不丢失。

环境变量配置