opensciencegrid/koji-builder Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Koji构建器(kojid)镜像文档

概述

本镜像提供基于OSG(Open Science Grid)补丁版本Koji的Koji构建器(kojid)服务。Koji是一个功能强大的构建系统，主要用于RPM包的构建和管理，而kojid作为Koji系统的核心组件，负责接收并执行来自Koji Hub的构建任务。本镜像集成了OSG项目维护的特定补丁，优化了在科学计算环境及相关场景下的兼容性和功能。

核心功能与特性

• 构建任务执行：接收并处理来自Koji Hub的RPM构建任务，执行编译、打包等操作
• OSG补丁集成：包含OSG项目维护的Koji补丁，支持科学计算环境特有的构建需求
• 任务队列管理：自动从Koji Hub拉取构建任务，按优先级处理并汇报任务状态
• 构建环境隔离：支持使用chroot或容器化方式隔离构建环境，确保构建一致性
• 与Koji生态兼容：遵循Koji标准协议，可与Koji Hub、Koji Web等组件无缝集成

使用场景与适用范围

• 科学计算环境（如OSG网格）中的软件包构建与分发
• 需要OSG特定补丁功能的Koji构建系统部署
• 企业或研究机构内部的RPM包自动化构建平台
• 对构建过程有严格隔离和可追溯性要求的场景

使用方法与配置说明

前置条件

1. 已部署Koji Hub服务，并可通过网络访问
2. 已准备Koji客户端证书和配置文件（用于与Koji Hub通信）
3. Docker引擎版本1.13.0及以上

Docker Run示例

bash
docker run -d \
  --name koji-builder \
  -v /path/to/koji.conf:/etc/koji.conf:ro \
  -v /path/to/client-cert:/etc/pki/koji/client.crt:ro \
  -v /path/to/client-key:/etc/pki/koji/client.key:ro \
  -e KOJI_HUB_URL=[***] \
  -e KOJI_PROFILE=osg \
  opensciencegrid/koji-builder

环境变量配置

配置文件挂载

与Koji Hub连接验证

启动容器后，可通过以下命令检查构建器是否成功连接到Koji Hub：

bash
docker exec -it koji-builder koji moshimoshi

若返回moshimoshi，表示连接成功。

日志查看

构建器日志默认输出到stdout，可通过Docker日志命令查看：

bash
docker logs -f koji-builder

注意事项

• 客户端证书和密钥文件需设置适当权限（建议容器内权限为600）
• 确保Koji Hub与构建器之间的网络连通性，开放必要端口（通常为443）
• 构建任务执行可能需要较大磁盘空间，建议为容器配置持久化存储或挂载外部卷
• OSG补丁版本可能与官方Koji版本存在差异，部署前需确认与Koji Hub版本兼容性