aursu/rpmbuild 镜像技术文档

镜像概述和主要用途

aursu/rpmbuild 是基于 CentOS 的 RPM 构建基础镜像集合，提供 RPM 包构建、YUM 仓库管理及 Web 访问功能。该镜像系列支持不同版本的 CentOS 系统（6、7、8），适用于构建自定义 RPM 包、维护私有 YUM 仓库及提供仓库 HTTP 访问服务。

核心功能和特性

镜像标签说明

核心服务功能

1. webrepo
   提供 YUM 仓库的 HTTP 访问服务，包含以下仓库地址：

   • CentOS 6 自定义仓库：[***]
   • CentOS 7 自定义仓库：[***]

2. centos6repo/centos7repo/centos8repo
   分别为 CentOS 6/7/8 生成 YUM 仓库元数据，周期性运行（周期由 DELAY_PERIOD 控制，默认 60 秒）。每次运行时检查以下条件，满足其一则重新生成元数据：

   • 过去 12 小时内有新包上传
   • repodata 目录缺失

使用场景和适用范围

• RPM 包构建：开发人员使用 6-build/7-build 镜像在隔离环境中构建 CentOS 6/7 兼容的 RPM 包。
• 私有 YUM 仓库管理：通过 createrepo 镜像维护自定义 RPM 仓库元数据，结合 webrepo 提供内部网络访问。
• 企业软件分发：通过 webrepo 和仓库元数据服务，为内部 CentOS 服务器提供统一的软件包更新源。

详细使用方法和配置说明

依赖说明

依赖基础镜像仓库：[***]

环境变量

部署示例

1. 启动 webrepo 服务（提供 HTTP 仓库访问）

bash
docker run -d \
  --name webrepo \
  -p 80:80 \
  -v /path/to/centos6/rpms:/var/www/html/centos/6/custom \
  -v /path/to/centos7/rpms:/var/www/html/centos/7/custom \
  aursu/rpmbuild:webrepo

参数说明：

• -p 80:80：映射容器 80 端口到主机，提供 HTTP 访问。
• -v：挂载主机 RPM 包目录到容器内仓库路径，确保仓库内容持久化。

2. 启动 centos6repo 服务（生成 CentOS 6 仓库元数据）

bash
docker run -d \
  --name centos6repo \
  -e DELAY_PERIOD=300 \  # 每 5 分钟检查一次（默认 60 秒）
  -v /path/to/centos6/rpms:/rpm6 \
  aursu/rpmbuild:createrepo

参数说明：

• -e DELAY_PERIOD=300：自定义检查周期为 300 秒（5 分钟）。
• -v /path/to/centos6/rpms:/rpm6：挂载 CentOS 6 RPM 包目录到容器内 /rpm6 卷。

3. Docker Compose 组合部署（完整仓库服务）

创建 docker-compose.yml：

yaml
version: '3'

services:
  webrepo:
    image: aursu/rpmbuild:webrepo
    ports:
      - "80:80"
    volumes:
      - centos6_rpms:/var/www/html/centos/6/custom
      - centos7_rpms:/var/www/html/centos/7/custom
    depends_on:
      - centos6repo
      - centos7repo

  centos6repo:
    image: aursu/rpmbuild:createrepo
    environment:
      - DELAY_PERIOD=300
    volumes:
      - centos6_rpms:/rpm6

  centos7repo:
    image: aursu/rpmbuild:createrepo
    environment:
      - DELAY_PERIOD=300
    volumes:
      - centos7_rpms:/rpm7

volumes:
  centos6_rpms:  # 持久化 CentOS 6 RPM 包
  centos7_rpms:  # 持久化 CentOS 7 RPM 包

启动服务：

bash
docker-compose up -d

构建 RPM 包示例（使用 7-build 镜像）

bash
# 挂载本地 RPM 源码目录到容器，执行构建
docker run -it --rm \
  -v /path/to/rpm/SPECS:/root/rpmbuild/SPECS \
  -v /path/to/rpm/SOURCES:/root/rpmbuild/SOURCES \
  -v /path/to/output/rpms:/root/rpmbuild/RPMS \
  aursu/rpmbuild:7-build \
  rpmbuild -ba /root/rpmbuild/SPECS/your-package.spec

说明：

• /path/to/rpm/SPECS：本地存放 .spec 文件的目录。
• /path/to/rpm/SOURCES：本地存放源码包（如 .tar.gz）的目录。
• /path/to/output/rpms：构建后的 RPM 包输出目录。