ucountit/build

retailtrend 构建环境镜像

镜像概述

retailtrend构建环境镜像是专为零售趋势相关项目设计的Docker镜像，集成了项目开发、编译、打包全流程所需的工具链和依赖环境。通过标准化构建环境，该镜像旨在消除"在我机器上能运行"的问题，确保团队成员及CI/CD流程中使用一致的构建环境，提升开发效率和构建可靠性。

核心功能与特性

• 预配置工具链：包含零售趋势项目开发所需的编译器、打包工具、版本控制工具等
• 依赖管理：内置项目特定依赖库，无需手动安装
• 环境隔离：通过Docker容器化技术，与主机环境完全隔离，避免依赖冲突
• 跨平台兼容：支持Linux、macOS、Windows等主流操作系统的Docker环境
• CI/CD集成：可直接集成到Jenkins、GitLab CI等持续集成平台
• 轻量级设计：基于精简基础镜像，优化镜像大小，提升加载速度

使用场景

• 本地开发环境：开发者无需在本地手动配置复杂依赖，直接通过容器启动开发环境
• 自动化构建流程：在CI/CD pipeline中作为构建节点，执行代码编译、测试、打包操作
• 团队协作：统一团队开发环境，确保代码在不同开发者机器上表现一致
• 临时测试环境：快速搭建隔离的测试环境，验证构建流程变更

使用方法

基本使用

通过以下命令启动构建环境容器：

bash
docker run -it --rm \
  -v /path/to/your/project:/workspace \
  retailtrend/build-env:latest \
  /bin/bash

参数说明：

• -v /path/to/your/project:/workspace：将本地项目目录挂载到容器内的/workspace工作目录
• -it：交互式终端模式，方便执行命令
• --rm：容器退出后自动删除，避免残留

执行构建命令

进入容器后，可在/workspace目录下执行项目构建命令：

bash
# 示例：执行项目编译
cd /workspace
make build

# 示例：运行单元测试
make test

# 示例：生成打包文件
make package

自定义配置

如需自定义构建环境，可通过环境变量或挂载配置文件实现：

环境变量配置

bash
docker run -it --rm \
  -v /path/to/your/project:/workspace \
  -e BUILD_TYPE=release \
  -e VERSION=1.0.0 \
  retailtrend/build-env:latest \
  /bin/bash

支持的主要环境变量：

• BUILD_TYPE：构建类型，可选值：debug（默认）、release
• VERSION：项目版本号，用于打包命名
• LOG_LEVEL：日志输出级别，可选值：info、debug、warn、error

挂载自定义配置文件

如需覆盖默认工具配置（如编译器选项、打包规则），可将自定义配置文件挂载到容器对应路径：

bash
docker run -it --rm \
  -v /path/to/your/project:/workspace \
  -v /path/to/custom/makefile:/workspace/Makefile \
  retailtrend/build-env:latest \
  /bin/bash

集成CI/CD示例（GitLab CI）

在.gitlab-ci.yml中使用该镜像：

yaml
stages:
  - build

build_project:
  stage: build
  image: retailtrend/build-env:latest
  script:
    - cd /workspace
    - make clean
    - make build
    - make package
  artifacts:
    paths:
      - /workspace/dist/*.tar.gz
  only:
    - main
    - develop

版本信息

• 镜像标签：latest（最新稳定版）、dev（开发版）、vX.Y.Z（特定版本）
• 基础镜像：基于Alpine Linux或Ubuntu（根据具体版本而定）
• 工具版本：包含GCC 11+、CMake 3.20+、Python 3.9+等（具体版本以镜像实际包含为准）

注意事项

• 确保本地Docker环境版本不低于19.03，以支持最新容器特性
• 挂载项目目录时，确保本地用户对挂载目录有读写权限
• 生产环境建议使用特定版本标签（如v1.0.0）而非latest，确保构建稳定性
• 如需持久化容器状态，可移除--rm参数或使用数据卷挂载