trini/u-boot-gitlab-ci-runner

Das U-Boot GitLab CI构建容器镜像

1. 镜像概述和主要用途

本镜像是专为GitLab CI runner环境设计的容器化解决方案，用于标准化和自动化Das U-Boot（通用引导加载程序）的构建流程。通过预配置构建依赖和工具链，解决不同CI runner环境中依赖差异导致的构建不一致问题，确保Das U-Boot的构建过程可重复、高效且环境无关。

2. 核心功能和特性

• 预配置构建环境：内置Das U-Boot构建所需的全套工具链（如交叉编译器、Make、Git、设备树编译器等）及依赖库（如libssl-dev、liblzma-dev等），无需额外安装。
• GitLab CI/CD无缝集成：支持GitLab CI runner的原生调用，可直接嵌入CI流水线配置文件（.gitlab-ci.yml）。
• 多版本兼容性：支持主流Das U-Boot版本（如v2020.01+）的构建，通过环境变量灵活指定目标版本。
• 轻量级设计：基于 Alpine 或 Debian Slim 基础镜像，最小化镜像体积，提升CI流水线执行效率。
• 构建产物管理：支持自定义输出目录，便于CI流水线中收集构建产物（如u-boot.bin、u-boot.img等）。

3. 使用场景和适用范围

• GitLab CI/CD流水线：作为Das U-Boot自动化构建的核心环节，嵌入持续集成/持续部署流程。
• 开发团队持续集成：用于开发过程中的快速构建验证，确保代码提交后可立即触发标准化构建。
• 多版本并行构建：通过GitLab CI的并行任务特性，利用本镜像同时构建多个Das U-Boot版本或目标平台。
• 统一构建环境：解决开发、测试、生产环境中工具链版本差异导致的“本地可构建，CI构建失败”问题。

4. 使用方法和配置说明

4.1 镜像拉取

从容器仓库拉取镜像（假设仓库为registry.example.com，实际使用时替换为实际仓库地址）：

bash
docker pull registry.example.com/das-uboot-build-ci:latest

4.2 GitLab CI/CD流水线配置

在GitLab项目中创建或修改.gitlab-ci.yml文件，集成本镜像到构建阶段：

yaml
stages:
  - build

uboot-build:
  stage: build
  image: registry.example.com/das-uboot-build-ci:latest
  variables:
    U_BOOT_VERSION: "v2023.10"  # 目标Das U-Boot版本
    BUILD_TARGET: "armv7"       # 目标平台（如armv7、aarch64、x86等）
    OUTPUT_DIR: "./build-output" # 构建产物输出目录
  script:
    - git clone https://git.denx.de/u-boot.git -b $U_BOOT_VERSION /u-boot-src
    - cd /u-boot-src
    - make ${BUILD_TARGET}_defconfig  # 加载目标平台默认配置
    - make -j$(nproc)                # 并行构建
    - mkdir -p $OUTPUT_DIR
    - cp u-boot.bin u-boot.img $OUTPUT_DIR/  # 复制产物到输出目录
  artifacts:
    paths:
      - $OUTPUT_DIR/  # 保存构建产物，供后续阶段使用
    expire_in: 1 week  # 产物保留时间

4.3 本地测试（docker run命令）

本地通过docker run命令模拟CI环境，验证构建流程：

bash
# 假设本地Das U-Boot源码目录为 ./u-boot-src，输出目录为 ./local-output
docker run -it --rm \
  -v $(pwd)/u-boot-src:/u-boot-src \  # 挂载本地源码目录
  -v $(pwd)/local-output:/output \    # 挂载输出目录
  -e U_BOOT_VERSION="v2023.10" \      # 指定版本
  -e BUILD_TARGET="armv7" \           # 指定目标平台
  registry.example.com/das-uboot-build-ci:latest \
  sh -c "cd /u-boot-src && make ${BUILD_TARGET}_defconfig && make -j$(nproc) && cp u-boot.bin u-boot.img /output/"

4.4 docker-compose配置示例

通过docker-compose.yml简化本地测试环境配置：

yaml
version: '3.8'

services:
  uboot-build:
    image: registry.example.com/das-uboot-build-ci:latest
    volumes:
      - ./u-boot-src:/u-boot-src  # 本地源码目录
      - ./local-output:/output    # 构建产物输出目录
    environment:
      - U_BOOT_VERSION=v2023.10
      - BUILD_TARGET=armv7
      - OUTPUT_DIR=/output
    command: >
      sh -c "cd /u-boot-src && 
             make $BUILD_TARGET_defconfig && 
             make -j$(nproc) && 
             cp u-boot.bin u-boot.img $OUTPUT_DIR/"

启动构建：

bash
docker-compose up

5. 环境变量说明

6. 注意事项

• 权限问题：本地测试时，挂载的宿主机目录需确保容器内用户（通常为root或ci-user）有读写权限，避免构建产物无法写入。
• 网络依赖：构建过程中需从Git仓库拉取Das U-Boot源码及可能的依赖包，确保CI runner或本地容器可访问外部网络。
• 版本兼容性：BUILD_TARGET需与指定的U_BOOT_VERSION兼容，建议参考Das U-Boot官方文档确认目标版本支持的平台。
• 产物验证：构建完成后建议通过artifacts在GitLab CI中保存产物，或本地检查输出目录下的u-boot.bin等文件完整性。