manageiq/rpm_build

ManageIQ RPM Build

镜像概述和主要用途

本镜像包含用于构建ManageIQ设备和容器镜像的RPM包的代码。其主要功能包括克隆源码仓库、执行bundle install、编译UI资产等必要任务、创建tarball以及构建RPM（可在容器内本地构建或通过Copr构建）。

核心功能和特性

生成的RPM包

关键目录说明

• /usr/lib/systemd/system/：包含systemd服务文件
• /var/www/miq/vmdb：包含应用程序文件
• /opt/manageiq/manageiq-appliance：包含链接到/etc/的文件
• /opt/manageiq/manifest：包含清单文件

使用场景和适用范围

适用于需要构建ManageIQ相关RPM包的开发者和运维人员，尤其适合以下场景：

• 构建官方发布版本的RPM包
• 基于自定义代码（如拉取请求中的代码）构建RPM包
• 在本地环境或通过Copr服务构建RPM包

使用方法和配置说明

获取构建RPM的容器镜像

可选择下载最新构建镜像或本地构建新镜像：

sh
# 下载最新通用版本
docker pull manageiq/rpm_build:latest

# 下载特定版本（如jansa）
docker pull manageiq/rpm_build:latest-jansa

# 本地构建镜像
docker build --pull --tag $USER/rpm_build:latest .

构建发布版

通过命令行传递GitHub标签/分支（如--git-ref jansa）。基础用法的更多选项可参考build.rb。

示例命令

sh
# 构建lasker版本并更新RPM仓库
docker run --rm manageiq/rpm_build:latest build --git-ref lasker --update-rpm-repo

# 对于旧版本（git-ref已存储在config/options.yml中）
docker run --rm manageiq/rpm_build:jansa-3 build --update-rpm-repo

构建自定义发布版

当需要基于拉取请求中的代码构建RPM时，可按以下步骤操作：

定义构建参数

通过options.yml配置仓库和标签/分支。典型配置仅覆盖源码和引用，示例如下：

1. 创建配置目录并编辑options.yml：

sh
mkdir OPTIONS
vi OPTIONS/options.yml

2. 配置内容示例（使用kbrock仓库的feature1分支）：

yaml
---
product_name:      manageiq
repos:
  ref:             master
  manageiq:
    url:           https://github.com/kbrock/manageiq.git
    ref:           feature1
  manageiq_appliance:
    url:           https://github.com/kbrock/manageiq-appliance.git
    ref:           feature1

3. 通过-v $(pwd)/OPTIONS:/root/OPTIONS将配置目录挂载到容器中。

高级配置

• 自定义NPM仓库：在options.yml中设置npm_registry键
• Copr构建RPM：
  • 在options.yml中设置rpm.repo_name键
  • 通过-v <copr token file>:/root/.config/copr挂载Copr令牌文件
• RPM缓存：通过-v <dir>:/root/rpm_cache挂载目录保存RPM缓存，未缓存的RPM将先下载到缓存

获取构建产物

构建过程生成两类产物：

• /root/BUILD/rpm_spec/*.tar.gz
• /root/BUILD/rpms/x86_64/manageiq-*.rpm

方法1：挂载卷接收产物

sh
docker run --rm -v `pwd`/OPTIONS:/root/OPTIONS -v `pwd`/BUILD:/root/BUILD manageiq/rpm_build:latest build

方法2：复制产物到本地

sh
CONTAINER='my-build-container'
docker run --name ${CONTAINER} -v `pwd`/OPTIONS:/root/OPTIONS manageiq/rpm_build:latest build
docker cp ${CONTAINER}:/root/BUILD/rpms/x86_64/ ./rpms/
docker rm ${CONTAINER}

版本说明

分支morphy对应v13版本，版本格式说明如下：

许可证

本代码以开源形式提供，遵循Apache License 2.0条款。