espressopp/buildenv

镜像概述

Espresso++ Build environment 是专为Espresso++项目设计的Docker镜像，集成了项目开发、编译和构建所需的全套工具链、依赖库及环境配置。该镜像旨在消除"在我机器上能运行"的环境差异问题，标准化开发流程，确保团队成员及CI/CD系统使用一致的构建环境，从而简化项目构建流程并提升开发效率。

核心功能和特性

• 完整工具链集成：预安装Espresso++编译器、调试工具、链接器及构建工具（如make、cmake），无需手动配置开发环境
• 依赖库预配置：包含Espresso++项目常用依赖库（基础算法库、网络库、数据处理库等），避免繁琐的依赖安装过程
• 环境标准化：基于统一基础镜像（如Ubuntu LTS）构建，确保不同环境下的构建行为一致性
• 即开即用：拉取镜像后可直接启动容器进行项目构建，降低环境搭建门槛
• 轻量级设计：采用精简基础镜像，在保证功能完整性的同时减小镜像体积，提升容器启动速度

使用场景和适用范围

• 开发人员本地开发：快速搭建标准化开发环境，无需在个人机器手动配置工具链
• CI/CD流水线构建：集成到Jenkins、GitLab CI、GitHub Actions等自动化流程，确保构建结果一致性
• 多版本兼容性测试：通过不同标签的镜像版本（如latest、v1.0）测试项目在不同Espresso++版本下的兼容性
• 团队协作：统一团队开发环境，避免因个人配置差异导致的代码构建问题

使用方法和配置说明

拉取镜像

从Docker仓库拉取最新版本镜像：

bash
docker pull espresso++-build-env:latest

如需指定版本，可替换latest为具体版本标签（如v1.2.0）。

基本使用（docker run）

启动交互式容器并挂载本地项目目录：

bash
docker run -it --rm \
  -v /本地项目绝对路径:/project \  # 挂载本地项目到容器内/project目录
  -w /project \                    # 设置工作目录为/project
  espresso++-build-env:latest \
  /bin/bash                        # 启动bash终端

在容器终端内执行构建命令（如make、cmake --build .等）。

Docker Compose配置

创建docker-compose.yml文件简化多服务配置：

yaml
version: '3'
services:
  build-env:
    image: espresso++-build-env:latest
    volumes:
      - ./:/project                # 挂载当前目录到容器/project
    working_dir: /project
    tty: true                      # 保持终端连接

启动服务并进入容器：

bash
docker-compose up -d
docker-compose exec build-env /bin/bash

配置参数和环境变量

支持通过环境变量自定义构建行为，使用-e参数指定：

示例：使用调试模式构建

bash
docker run -it --rm \
  -v /本地项目路径:/project \
  -e LOG_LEVEL=debug \
  -e CXXFLAGS="-O0 -g" \
  espresso++-build-env:latest \
  make

注意事项

• 本地项目路径需使用绝对路径，避免挂载失败
• 如需持久化构建缓存，可额外挂载缓存目录（如-v ./build-cache:/root/.cache）
• 不同版本镜像可能存在工具链差异，建议在项目文档中明确指定镜像版本