bwdh/bob

Bob the builder Docker镜像文档

镜像概述和主要用途

Bob the builder是一个轻量级Docker镜像，集成了常用的构建工具和环境，旨在提供一致、可复用的构建环境，解决因开发环境差异导致的构建问题。该镜像适用于自动化项目构建流程，可无缝集成到CI/CD管道，或作为本地开发的统一构建工具环境。

主要用途：

• 统一开发团队的本地构建环境
• 作为CI/CD流程（如Jenkins、GitHub Actions）中的构建步骤执行环境
• 简化跨平台项目的构建流程
• 快速部署临时构建工具环境，无需本地安装依赖

核心功能和特性

核心功能

• 集成多语言/框架构建工具（如make、cmake、npm、maven等）
• 提供标准化的构建命令执行环境
• 支持自定义构建脚本和配置文件挂载
• 轻量级镜像设计，减少资源占用

主要特性

• 环境一致性：消除"在我机器上能运行"的环境差异问题
• 多工具集成：预装主流构建工具，无需额外安装
• 易于扩展：支持通过环境变量和挂载文件自定义构建流程
• 跨平台兼容：支持Linux/Windows/macOS等主流操作系统的Docker环境
• 快速启动：优化镜像层，缩短容器启动和构建准备时间

使用场景和适用范围

适用场景

• 开发团队本地构建环境统一
• CI/CD流水线中的自动化构建步骤
• 开源项目的自动化构建和测试流程
• 需要频繁切换构建工具版本的场景
• 临时构建任务的快速环境部署

适用范围

• 前端项目构建（依赖npm、yarn等工具）
• 后端服务编译（依赖maven、gradle、go build等）
• 嵌入式项目构建（依赖cmake、arm-none-eabi-gcc等）
• 跨平台应用打包（需多架构构建工具支持的场景）
• 小型到大型软件开发项目的构建流程

使用方法和配置说明

基本使用步骤

1. 拉取镜像

bash
docker pull bob-the-builder:latest

2. 基本构建命令执行

将本地项目目录挂载到容器内，并执行构建命令：

bash
# 示例：使用make构建当前目录项目
docker run -v $(pwd):/app -w /app bob-the-builder:latest make

# 示例：使用npm构建前端项目
docker run -v $(pwd):/app -w /app bob-the-builder:latest npm run build

3. 自定义构建环境

通过环境变量指定构建参数：

bash
# 示例：指定Maven构建配置文件
docker run -v $(pwd):/app -w /app -e MAVEN_OPTS="-Xmx512m" bob-the-builder:latest mvn clean package

Docker Compose配置示例

创建docker-compose.yml文件，集成到项目构建流程：

yaml
version: '3'
services:
  builder:
    image: bob-the-builder:latest
    volumes:
      - ./:/app
      - ~/.m2:/root/.m2  # 挂载Maven本地仓库缓存
    working_dir: /app
    environment:
      - BUILD_TARGET=production
      - LOG_LEVEL=info
    command: mvn clean package -DskipTests

执行构建：

bash
docker-compose run builder

配置参数说明

高级使用：自定义构建脚本

创建本地构建脚本custom-build.sh：

bash
#!/bin/bash
echo "Starting custom build for target: $BUILD_TARGET"
npm install
npm run lint
npm run build -- --target=$BUILD_TARGET

挂载并执行自定义脚本：

bash
docker run -v $(pwd):/app -w /app -e BUILD_TARGET=production bob-the-builder:latest sh custom-build.sh

注意事项

• 本地项目目录挂载时需确保权限正确，避免容器内无写入权限
• 对于大型项目，建议挂载工具缓存目录（如Maven的~/.m2、npm的~/.npm）以加速重复构建
• 生产环境使用时建议指定具体镜像版本（如bob-the-builder:1.2.0）而非latest，确保构建稳定性
• 如需添加额外构建工具，可基于此镜像创建自定义Dockerfile进行扩展