内部构建与开发镜像文档

镜像概述

本Docker镜像专为内部构建和开发场景设计，旨在提供标准化的开发与构建环境，解决团队协作中因环境差异导致的配置问题，简化开发流程并确保构建一致性。

核心功能和特性

• 环境标准化：内置统一的开发工具链和依赖版本，确保团队成员使用一致的开发环境
• 构建工具集成：包含常用构建工具（如Make、CMake、Gradle等）及编译环境
• 轻量级设计：基于精简基础镜像构建，减少资源占用并加快启动速度
• 灵活配置：支持通过环境变量和卷挂载自定义构建参数和工作目录

使用场景和适用范围

• 开发团队内部搭建本地开发环境
• 执行项目构建脚本（如编译、打包、测试等流程）
• 作为CI/CD流水线中的构建阶段基础镜像
• 快速复现构建问题，统一排查环境相关错误

使用方法和配置说明

基本使用示例

通过docker run命令启动容器，挂载本地代码目录并执行构建命令：

bash
docker run -v /path/to/local/project:/workspace -w /workspace internal-build-dev:latest make build

环境变量配置

支持以下环境变量自定义构建行为：

示例：指定debug模式构建并输出详细日志

bash
docker run -e BUILD_TARGET=debug -e LOG_LEVEL=debug \
  -v /local/project:/workspace -w /workspace \
  internal-build-dev:latest make build

卷挂载建议

为实现数据持久化和文件共享，建议挂载以下目录：

• /workspace: 项目代码目录（必选），用于存放源码和构建产物
• /build-cache: 构建缓存目录（可选），加速重复构建过程

示例：挂载缓存目录

bash
docker run -v /local/project:/workspace \
  -v /local/build-cache:/build-cache \
  -e CACHE_DIR=/build-cache \
  internal-build-dev:latest make build

注意事项

• 该镜像为内部私有镜像，需通过企业私有仓库拉取（如Harbor、AWS ECR等）
• 最低Docker引擎版本要求：19.03+（支持多阶段构建和BuildKit特性）
• 敏感信息（如API密钥、证书）需通过环境变量或外部文件挂载传入，禁止硬编码至镜像中