fmidev/smartmet-cibase-8 Docker Image Overview

fmidev/smartmet-cibase-8

fmidev

基于CentOS的Docker镜像，作为CI构建和测试的基础，集成每日更新、EPEL及FMI特定仓库、预安装必要工具和ci-build工具，简化CI环境中的构建流程与依赖管理。

0 次下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

中文简介版本下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

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

标准测试流程

使用 sudo yum 等命令安装待测试文件（ci-build 不处理此步骤，需手动执行）

准备测试环境（安装测试依赖）：

bash
ci-build testprep

运行测试：
```
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 工具使用步骤

安装构建依赖：
```
bash
ci-build deps
```
自动解析并安装构建所需的依赖包。
构建 RPM 包：
```
bash
ci-build rpm
```
执行构建流程，并将生成的 RPM 文件收集至 dist 目录。
测试准备：
```
bash
ci-build testprep
```
根据 #TestRequires 扩展安装测试所需依赖。
运行测试：
```
bash
ci-build test
```
执行 make test 并收集测试结果（若存在 disable-tests-in-ci 文件则跳过测试）。