openmandriva/builder

OpenMandriva Builder 镜像文档

镜像概述和主要用途

OpenMandriva Builder 镜像是一个在 ABF ([***] 构建节点上运行 mock 以构建 RPM 文件的 Docker 镜像。该镜像提供了标准化的构建环境，简化了 OpenMandriva 软件包的构建流程，支持多种架构和平台版本。

核心功能和特性

• 基于 mock 工具构建 RPM 软件包
• 支持多架构构建，包括 x86_64、armv7hl、i586、i686、aarch64 和 riscv64
• 支持多种 OpenMandriva 平台版本，包括 cooker、4.0、rolling 和 rock
• 集成 QEMU 支持，实现跨架构构建
• 通过环境变量灵活配置构建参数

使用场景和适用范围

• OpenMandriva 软件包维护者构建 RPM 包
• 开发人员在本地测试软件包构建
• CI/CD 流程中集成自动化 RPM 构建
• 需要跨架构构建 OpenMandriva 软件包的场景

详细使用方法和配置说明

前提条件

• 已安装 Docker 环境
• Git 版本控制工具
• 对于 ARM 或 RISC-V 架构构建，需要安装 QEMU 相关组件

构建镜像

1. 克隆仓库

bash
git clone https://github.com/OpenMandrivaSoftware/docker-builder.git

2. 进入项目目录并创建构建器镜像

bash
cd docker-builder
sudo sh docker-brew-openmandriva/mkimage-dnf.sh --rootfs=/tmp/ --version=cooker --arch=x86_64 --with-builder

基本使用方法

运行 ABF 构建器

bash
docker run -ti --rm --privileged=true -h <yourname>.openmandriva.org \
        -e BUILD_TOKEN="your_token" \
        -e BUILD_ARCH="x86_64 armv7hl i586 i686 aarch64" \
        -e BUILD_PLATFORM="cooker,4.0,rolling,rock" openmandriva/builder

环境变量说明

ARM/RISC-V 架构构建

安装 QEMU 组件

bash
sudo dnf install qemu qemu-riscv64-static qemu-riscv64-static qemu-arm-static qemu-aarch64-static

重启 binfmt 服务

bash
sudo systemctl restart systemd-binfmt

运行 RISC-V 构建器示例

bash
docker run -ti --rm --privileged=true -h <yourname>.openmandriva.org \
        -e BUILD_TOKEN="your_token" \
        -e BUILD_ARCH="riscv64" \
        -e BUILD_PLATFORM="cooker,4.0,rolling,rock" openmandriva/builder

容器管理

移除已停止的容器

bash
docker rm -v $(docker ps -a -q -f status=exited)

非 Docker 环境下运行 build-rpm.py

警告：不建议在容器外运行此脚本

准备环境

1. 安装 mock 及相关依赖

bash
sudo dnf install -y mock git coreutils curl sudo rpmdevtools python-yaml

2. 配置 mock 权限

bash
sudo echo "%mock ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
sudo usermod -a -G mock $USER
sudo chown -R $USER:mock /etc/mock

运行构建脚本

bash
PACKAGE=htop GIT_REPO=git://github.com/OpenMandrivaAssociation/htop.git \
USE_EXTRA_TESTS=true PLATFORM_ARCH=x86_64 PLATFORM_NAME=cooker \
UNAME=fdrt EMAIL=*** USE_MOCK_CACHE= EXTRA_CFG_OPTIONS= \
REPO_NAMES='cooker_main_release cooker_main_updates' \
REPO_URL='[***] \
[***]\
PROJECT_VERSION=master FILE_STORE_ADDR=[***] \
/usr/bin/python build-rpm.py