opensauce04/azahar-build-environment

Azahar构建与CI/CD专用Docker环境

镜像概述

本Docker镜像为专用构建环境，旨在简化Azahar模拟器二进制文件的构建流程，并提供CI/CD（持续集成/持续部署）任务的执行支持。通过预配置必要的开发工具链与依赖组件，确保开发团队在统一环境中进行构建操作，避免因本地环境差异导致的构建问题。

核心功能与特性

• 预配置构建工具链：集成编译Azahar模拟器所需的编译器、链接器、依赖库及构建系统（如Make、CMake等），无需手动安装配置
• CI/CD任务兼容性：支持自动化构建、测试、打包等CI/CD流程，可直接集成至Jenkins、GitLab CI、GitHub Actions等主流流水线工具
• 环境一致性：通过容器化确保开发、测试、生产环境的配置统一，消除"本地可运行，部署后异常"的环境依赖问题
• 轻量级优化：基于精简基础镜像构建，减小体积并提升启动速度，适配CI/CD场景下的快速任务执行需求

使用场景

• Azahar模拟器开发：开发团队本地或远程构建Azahar模拟器的Debug/Release版本二进制文件
• 自动化CI/CD流水线：作为流水线中的构建阶段执行环境，实现代码提交后自动触发构建、测试流程
• 跨平台构建支持：配合多架构基础镜像，可支持在单一宿主环境中构建多平台（如x86_64、ARM）的Azahar模拟器二进制文件
• 临时构建环境：为临时开发、代码审查或问题排查提供独立、干净的构建环境，避免污染本地开发环境

使用方法与配置说明

基础使用（本地构建）

通过docker run命令启动容器并执行构建任务：

bash
# 挂载本地Azahar项目目录至容器内工作区，执行构建命令
docker run --rm \
  -v /本地路径/azahar-project:/workspace \  # 挂载项目源码目录
  -w /workspace \                            # 设置工作目录
  azahar-build-env:latest \                  # 镜像名称（请替换为实际镜像标签）
  make release                               # 执行构建命令（根据项目构建脚本调整）

参数说明：

• --rm：任务完成后自动删除容器，避免残留
• -v /本地路径/azahar-project:/workspace：将本地Azahar项目源码目录挂载至容器内/workspace路径
• -w /workspace：指定容器内工作目录为项目挂载路径
• make release：示例构建命令，需根据项目实际构建脚本（如cmake --build、go build等）调整

CI/CD流水线集成示例（GitLab CI）

在.gitlab-ci.yml中配置构建阶段：

yaml
stages:
  - build

build_azahar:
  stage: build
  image: azahar-build-env:latest  # 直接使用本镜像作为执行环境
  script:
    - cd /builds/your-org/azahar-project  # 进入GitLab CI默认项目路径
    - mkdir build && cd build             # 创建构建目录
    - cmake .. -DCMAKE_BUILD_TYPE=Release  # 执行CMake配置（示例）
    - make -j$(nproc)                     # 多线程构建
  artifacts:
    paths:
      - build/bin/azahar-emulator*        # 保存构建产物供后续阶段使用
    expire_in: 1 week                     # 产物保留时间

高级配置（自定义构建参数）

通过环境变量传递自定义构建参数，例如指定构建输出路径或编译选项：

bash
docker run --rm \
  -v /本地路径/azahar-project:/workspace \
  -w /workspace \
  -e OUTPUT_DIR=/workspace/custom-output \  # 自定义输出目录环境变量
  -e CXXFLAGS="-O3 -Wall" \                 # 自定义编译器 flags
  azahar-build-env:latest \
  /bin/bash -c "mkdir -p $OUTPUT_DIR && make install DESTDIR=$OUTPUT_DIR"

注意事项

• 宿主机需确保Docker引擎版本≥19.03（推荐20.10+），以支持最新容器特性
• 挂载目录时需注意宿主机与容器内的文件权限，必要时通过-u $(id -u):$(id -g)参数指定用户ID，避免权限冲突
• 构建大型项目时建议通过--memory和--cpus参数限制容器资源使用，避免影响宿主系统性能