fmidev/smartmet-cibase-8

docker-smartmet-cibase 镜像文档

镜像概述和主要用途

docker-smartmet-cibase 是一个基于 CentOS 的 Docker 镜像，专为 CI（持续集成）环境中的构建和测试任务设计，作为基础镜像使用。它解决了在最小化 CentOS 系统上构建时需额外配置仓库、更新系统及处理依赖的问题，通过预集成必要组件和工具，提供标准化、便捷的 CI 构建环境。

核心功能和特性

相比基础 CentOS 系统，该镜像具有以下增强：

• 系统更新：包含所有可用更新（每日重建以保持时效性）
• 仓库配置：
  • 启用 EPEL 仓库
  • 集成 FMI（芬兰气象研究所）特定公共仓库
• 构建优化：
  • 包含构建各类模块时发现的版本锁定（versionlocks）及必要 workaround（与服务器端一致）
  • 预安装常用必要工具包（如 make、sudo 等）
• 开发便利：
  • 本地构建和 shell 模式的钩子（hooks）
  • 集成 ci-build 包装工具（见下文详细说明）

Ci-build 工具

工具用途

ci-build 是一个运行在构建/测试镜像内的工具，用于简化 CI 环境中常见的构建和测试流程，主要功能包括：

• 检测 FMI 办公网络中的代理设置
• 收集构建生成的 RPM 文件至标准 dist 目录
• 通过 #TestRequires 扩展安装测试依赖
• 收集已安装库以确保 make test 可正常运行
• 执行 make test 命令

使用方法

标准构建流程

bash
# 安装构建依赖
ci-build deps

# 构建并收集 RPM 包
ci-build rpm

标准测试流程

1. 使用 sudo yum 等命令安装待测试文件（ci-build 不处理此步骤，需手动执行）
2. 准备测试环境（安装测试依赖）：

   bash
   ci-build testprep
   

3. 运行测试：

   bash
   ci-build test
   

测试禁用功能（临时）

若源码树的 .circleci 目录中存在 disable-tests-in-ci 文件，ci-build 将禁用测试执行：ci-build test 会返回成功但不执行任何操作。此功能为临时解决方案，用于处理测试不兼容或在 CI 环境中无法运行的模块，建议长期修复测试而非依赖此文件。

本地 shell 模式帮助功能

该镜像提供了针对本地 shell 模式的增强，便于在本地系统模拟 CI 环境进行构建和测试验证。核心功能包括：

• 处理 FMI 网络环境中的代理配置
• 确保容器内运行的构建进程与主机用户 uid 一致，避免因绑定挂载工作目录导致的权限问题（如主机无法删除容器内 root 用户创建的文件）

详细使用方法可参考 smartmet-build-utils 模块。

使用场景和适用范围

• CI 环境构建：作为基础镜像用于各类模块的自动化构建和测试
• 本地开发调试：在本地模拟 CI 环境，复现和解决构建/测试问题
• 统一构建环境：确保不同开发和 CI 环境中的构建结果一致性，减少环境差异导致的问题

使用方法和配置说明

Docker 运行示例

进入本地 shell 模式（用于模拟 CI 环境测试）：

bash
# 挂载当前工作目录至容器内的 /workspace，进入交互式 shell
docker run -it --rm -v $(pwd):/workspace smartmet-cibase /bin/bash

ci-build 工具使用步骤

1. 安装构建依赖：

   bash
   ci-build deps
   

   自动解析并安装构建所需的依赖包。

2. 构建 RPM 包：

   bash
   ci-build rpm
   

   执行构建流程，并将生成的 RPM 文件收集至 dist 目录。

3. 测试准备：

   bash
   ci-build testprep
   

   根据 #TestRequires 扩展安装测试所需依赖。

4. 运行测试：

   bash
   ci-build test
   

   执行 make test 并收集测试结果（若存在 disable-tests-in-ci 文件则跳过测试）。