fmidev/smartmet-cibase-7

docker-smartmet-cibase

镜像概述和主要用途

docker-smartmet-cibase是一个基于CentOS的Docker镜像，专为CI（持续集成）构建和测试环境设计，作为基础镜像使用。其核心目标是简化smartmet相关模块的构建流程，通过预配置必要的系统更新、仓库和工具，避免在最小化CentOS系统上手动配置额外依赖和环境的繁琐步骤。

核心功能和特性

与基础CentOS相比，该镜像包含以下增强和新增内容：

• 系统更新：集成所有可用更新（每日重建，确保时效性）
• 仓库配置：启用EPEL仓库及部分FMI（芬兰气象研究所）特定公共仓库
• 版本锁定：包含构建各模块时所需的版本锁定及问题解决方法（与服务器端配置一致）
• 预安装工具：包含构建过程中常用的基础工具（如make、sudo等）
• 本地构建支持：提供本地构建和shell模式的优化钩子
• ci-build工具：集成CI构建流程管理工具，自动化依赖安装、RPM构建、测试准备等步骤

使用场景和适用范围

适用于需要在CI环境中构建和测试smartmet相关模块的场景，尤其适合FMI内部项目。同时支持本地环境模拟CI构建流程，便于开发者在本地验证构建和测试逻辑，无需单独部署CentOS系统。

详细使用方法和配置说明

Ci-build工具

ci-build工具用于在Docker镜像内部管理CI构建和测试的关键步骤，自动化常见流程：

核心功能

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

标准使用流程

构建流程：

1. 安装构建依赖：ci-build deps
2. 构建并收集RPM：ci-build rpm

测试流程：

1. 通过sudo yum等命令安装待测试文件（需手动执行，ci-build不处理）
2. 安装测试依赖：ci-build testprep
3. 执行测试：ci-build test（实际运行make test）

线程限制

为避免内存过度使用，RPM构建过程中的线程数会受到限制。工具会自动检测是否运行在CircleCI服务器上，当前在CircleCI环境下限制为3个进程。经验表明，增加线程数可能导致部分模块编译错误，未来可能支持配置化。

其他功能

工具包含针对CI过程中发现的各类问题的检查和解决方法，具体可参考ci-build.sh内部注释。

测试步骤禁用功能（临时）

目前，在源代码树的.circleci目录下创建disable-tests-in-ci文件可禁用测试。此时ci-build test仍会执行，但始终返回成功且不执行任何实际测试。

背景：部分模块存在测试不工作或在CI环境中无法运行的情况，此功能作为短期解决方案。长期目标是修复这些测试，确保至少部分测试可在CI中运行。该文件的存在表明相关模块尚未完成必要依赖配置和测试适配，便于后续定位和移除。

本地shell模式的帮助功能

镜像提供包装器和优化配置，提升本地shell模式的使用体验。shell模式的主要用途是在本地模拟CI环境，验证构建和测试流程，无需单独部署CentOS系统。

核心优化

• 自动处理代理配置
• 以与宿主机相同的UID运行shell及构建进程，避免因绑定挂载（通常为工作目录）导致的权限问题（如root用户构建后宿主机无法删除文件）

使用方法

详细使用说明可参考smartmet-build-utils模块。