pizzafactory0contorno/bazel

Bazel Eclipse/Che7 Workspace 镜像

一、镜像概述和主要用途

概述

本镜像为基于 Eclipse/Che7 的工作区镜像，预集成 Bazel 构建工具，旨在为开发者提供一个开箱即用、环境一致的 Bazel 应用构建环境。镜像整合了 Eclipse/Che7 云 IDE 的便捷性与 Bazel 的高效构建能力，无需本地配置即可快速开展基于 Bazel 的项目开发与构建工作。

主要用途

• 为开发者提供隔离、一致的 Bazel 构建环境，消除"本地环境不一致"问题
• 作为 Eclipse/Che7 云 IDE 的工作区模板，支持直接在浏览器中进行 Bazel 项目开发
• 简化团队协作流程，确保所有成员使用统一的 Bazel 版本及构建工具链
• 支持快速集成到 CI/CD 流程，作为自动化构建的标准环境

二、核心功能和特性

核心功能

1. 预配置 Bazel 环境：内置最新稳定版 Bazel 及依赖工具链，无需手动安装配置
2. Eclipse/Che7 集成：与 Eclipse/Che7 云 IDE 深度整合，支持代码编辑、构建、调试一体化
3. 多语言支持：支持 Bazel 原生支持的语言生态（Java、C++、Python、Go、JavaScript 等）
4. 隔离构建环境：基于 Docker 容器隔离，避免构建依赖与本地环境冲突
5. 持久化工作区：支持挂载本地项目目录，确保代码与构建缓存持久化存储

特性

• 版本可控：可通过环境变量指定 Bazel 版本，灵活适配不同项目需求
• 轻量级设计：基于 Alpine 或 Debian slim 基础镜像，优化镜像体积
• 权限兼容：支持自定义用户 ID，避免容器内文件权限与宿主机冲突
• 工具链完整：包含 Git、Make、CMake 等辅助开发工具，满足复杂构建需求
• 可扩展性：支持通过配置文件或环境变量扩展构建工具链（如添加自定义 Bazel 规则）

三、使用场景和适用范围

使用场景

1. 团队协作开发：团队成员通过 Eclipse/Che7 访问统一工作区，确保构建环境一致性
2. 云 IDE 开发：在浏览器中直接编写、构建 Bazel 项目，无需本地安装开发环境
3. CI/CD 自动化构建：作为 CI 流程中的构建环境镜像，实现"构建即代码"
4. 多版本项目维护：通过指定不同 Bazel 版本，同时维护多个依赖不同 Bazel 版本的项目
5. 快速上手学习：新手开发者无需复杂配置即可体验 Bazel 构建流程

适用范围

• 项目类型：基于 Bazel 构建的 Java、C++、Python、Go、Android 等项目
• 开发环境：Eclipse/Che7 云 IDE 环境、本地 Docker 环境、Kubernetes 集群
• 用户群体：使用 Bazel 的开发团队、依赖云 IDE 的远程开发者、需要标准化构建环境的 CI/CD 工程师

四、使用方法和配置说明

4.1 基本使用流程

1. 在 Eclipse/Che7 中选择本镜像作为工作区模板，自动加载预配置环境
2. 通过 IDE 界面克隆或上传 Bazel 项目代码（通常包含 WORKSPACE 和 BUILD 文件）
3. 在终端中执行 bazel build //path/to/target 进行构建，或通过 IDE 集成的构建按钮触发
4. 构建产物默认生成在容器内 /workspace/bazel-bin 目录，可通过挂载宿主机目录持久化

4.2 Docker 环境直接运行

若需在本地 Docker 环境独立运行（非 Eclipse/Che7 集成场景），可使用以下命令：

bash
docker run -d \
  --name bazel-che7-workspace \
  -p 8080:8080 \  # 暴露 Che7 Web 访问端口
  -v /本地项目目录:/workspace \  # 挂载宿主机项目目录
  -e BAZEL_VERSION=6.4.0 \  # 指定 Bazel 版本（可选，默认最新稳定版）
  -e USER_ID=$(id -u) \  # 同步宿主机用户 ID，避免权限问题
  eclipse/che7-bazel-workspace:latest

访问 http://localhost:8080 即可打开 Eclipse/Che7 IDE，工作区已自动加载 /workspace 目录下的项目。

4.3 docker-compose 配置示例

yaml
version: '3.8'
services:
  bazel-workspace:
    image: docker.xuanyuan.run/eclipse/che7-bazel-workspace:latest
    container_name: bazel-che7-workspace
    ports:
      - "8080:8080"  # Che7 Web 界面端口
      - "9876:9876"  # 可选，调试端口
    volumes:
      - ./my-bazel-project:/workspace  # 挂载本地 Bazel 项目
      - bazel-cache:/root/.cache/bazel  # 持久化 Bazel 构建缓存，加速重复构建
    environment:
      - BAZEL_VERSION=6.4.0
      - WORKSPACE_DIR=/workspace
      - USER_ID=1000
      - GROUP_ID=1000
    restart: unless-stopped

volumes:
  bazel-cache:  # 命名卷存储 Bazel 缓存

4.4 核心配置参数说明

环境变量配置

持久化与数据管理

• 项目代码：通过 -v /本地目录:/workspace 挂载，确保代码持久化且可在宿主机编辑
• 构建缓存：Bazel 缓存默认位于 /root/.cache/bazel，建议通过命名卷或宿主机目录挂载持久化，避免重复构建时重新下载依赖
• IDE 配置：Eclipse/Che7 配置存储在 /home/user/.che，如需保留个性化设置可额外挂载此目录

五、高级配置与扩展

5.1 自定义 Bazel 工具链

若项目需要特定版本的编译器（如 GCC、JDK），可通过修改容器内 /etc/bazelrc 或挂载自定义 bazelrc 文件实现：

bash
# 挂载自定义 bazelrc 配置
docker run ... -v /本地/bazelrc:/etc/bazelrc ...

5.2 集成 CI/CD 流程

在 GitLab CI/CD 中使用示例（.gitlab-ci.yml）：

yaml
build:
  image: docker.xuanyuan.run/eclipse/che7-bazel-workspace:latest
  script:
    - bazel build //src/main:my-app  # 执行构建命令
    - bazel test //src/test:my-app-test  # 执行测试
  variables:
    BAZEL_VERSION: "6.4.0"
  cache:
    paths:
      - /root/.cache/bazel  # 缓存 Bazel 依赖，加速下次构建

六、注意事项

1. 权限问题：容器默认使用 root 用户运行，如需非 root 用户，需通过 USER_ID 和 GROUP_ID 环境变量同步宿主机用户 ID，并确保挂载目录权限正确
2. Bazel 版本兼容性：不同项目可能依赖特定 Bazel 版本，需通过 BAZEL_VERSION 显式指定，避免版本不兼容导致构建失败
3. 网络隔离：若构建需访问外部依赖（如 Maven 仓库），需确保容器网络通畅，或通过 HTTP_PROXY 配置代理
4. 资源限制：Bazel 构建可能消耗较多 CPU/内存，建议通过 --cpus、--memory 参数限制容器资源，避免影响宿主机性能