RPM构建工具镜像文档

1. 镜像概述和主要用途

本镜像提供隔离的RPM包构建环境，集成rpmbuild、gcc等核心工具，旨在简化各类软件的RPM包创建流程。通过容器化方式，避免构建环境依赖冲突，支持快速、可重复的RPM打包操作，适用于多场景下的软件分发需求。

2. 核心功能和特性

完整构建工具链：内置rpmbuild、gcc、make等RPM构建必需工具，无需额外安装依赖。
多发行版支持：基于主流Linux发行版基础镜像（如CentOS、Fedora），适配不同系统的RPM规范。
环境隔离：容器化构建环境，避免宿主机依赖污染，确保构建一致性。
灵活定制：支持通过环境变量、卷挂载自定义构建路径、spec文件及源码位置。
轻量高效：优化镜像体积，缩短启动时间，提升构建效率。

3. 使用场景和适用范围

软件开发者：本地快速构建RPM包，验证.spec文件正确性。
系统管理员：批量创建定制化RPM（如内部工具、补丁包），简化服务器部署。
CI/CD集成：嵌入自动化流程（如GitLab CI、Jenkins），实现代码提交后自动生成RPM。
多版本兼容测试：通过切换基础镜像标签，测试不同发行版下的RPM兼容性。

4. 使用方法和配置说明

4.1 前提条件

已安装Docker Engine（20.10+）或Docker Desktop。
本地准备好RPM构建所需文件：
- .spec规格文件（定义包元信息、构建步骤等）。
- 软件源码包（如.tar.gz）或补丁文件。

4.2 获取镜像

通过Docker Hub或私有仓库拉取镜像（示例标签为centos7，其他标签参见镜像仓库说明）：

bash
docker pull [镜像仓库地址]/rpm-builder:centos7

4.3 基本使用示例（docker run）

4.3.1 基础构建流程

将本地.spec文件和源码挂载到容器内，执行构建命令：

bash
docker run -it --rm \
  -v $(pwd)/specs:/root/rpmbuild/SPECS \  # 挂载.spec文件目录
  -v $(pwd)/sources:/root/rpmbuild/SOURCES \  # 挂载源码/补丁目录
  -v $(pwd)/rpms:/root/rpmbuild/RPMS \  # 挂载输出RPM目录
  [镜像仓库地址]/rpm-builder:centos7 \
  rpmbuild -ba /root/rpmbuild/SPECS/your-package.spec

说明：
- /root/rpmbuild为容器内默认构建目录（符合rpmbuild规范结构）。
- RPMS目录会输出最终生成的RPM包，挂载到宿主机./rpms目录便于获取。

4.3.2 指定自定义构建目录

通过环境变量RPMBUILD_DIR修改默认构建路径：

bash
docker run -it --rm \
  -e RPMBUILD_DIR=/custom/build \  # 自定义容器内构建根目录
  -v $(pwd)/my-build:/custom/build \  # 挂载宿主机目录到自定义路径
  [镜像仓库地址]/rpm-builder:centos7 \
  rpmbuild -ba /custom/build/SPECS/your-package.spec

4.4 Docker Compose配置示例

适用于多步骤构建或需持久化缓存场景（如依赖包缓存）：

yaml
# docker-compose.yml
version: '3'
services:
  rpm-builder:
    image: [镜像仓库地址]/rpm-builder:centos7
    volumes:
      - ./specs:/root/rpmbuild/SPECS
      - ./sources:/root/rpmbuild/SOURCES
      - ./rpms:/root/rpmbuild/RPMS
      - rpm-cache:/root/rpmbuild/SRPMS  # 持久化缓存SRPM
    environment:
      - ARCH=x86_64  # 指定构建架构
      - SPEC_FILE=your-package.spec  # 默认spec文件名（可选）
    command: rpmbuild -ba /root/rpmbuild/SPECS/${SPEC_FILE}

volumes:
  rpm-cache:  # 缓存SRPM，加速重复构建

启动命令：docker-compose up

5. 配置参数与环境变量

环境变量	默认值	描述
`RPMBUILD_DIR`	`/root/rpmbuild`	容器内RPM构建根目录（需符合rpmbuild规范结构）。
`SPEC_FILE`	无	默认.spec文件名（需配合`rpmbuild`命令使用）。
`ARCH`	`x86_64`	构建目标架构（如`i386`、`arm64`，需基础镜像支持）。
`DISTRO`	基础镜像发行版	覆盖基础镜像的发行版标识（如`centos8`）。

6. 注意事项

权限问题：容器内默认使用root用户，挂载宿主机目录时需确保宿主机路径有读写权限（可通过-u $(id -u):$(id -g)指定用户ID，避免文件权限冲突）。
spec文件依赖：.spec中声明的BuildRequires依赖需确保在镜像中存在，缺失时可通过docker exec进入容器手动安装（如yum install -y [依赖包]）。
镜像标签选择：根据目标发行版选择对应标签（如fedora38、centos-stream9），确保RPM兼容性。