kernsuite/base

KERN 基础 Docker 镜像技术文档

1. 镜像概述和主要用途

1.1 概述

本镜像为 KERN 射电天文软件套件的基础 Docker 镜像，旨在提供标准化、轻量且可扩展的运行环境，简化 KERN 相关应用的部署与使用流程。

1.2 主要用途

作为射电天文数据处理与分析的基础环境，提供 KERN 软件套件的核心依赖与配置；同时支持作为自定义射电天文应用的基础镜像，用于构建上层业务容器。

2. 核心功能和特性

• 基础系统：基于 Ubuntu 22.04 LTS，提供稳定的底层运行环境。
• 软件源配置：已启用 KERN 9 版本的 Launchpad PPA 源，确保可直接安装 KERN 套件组件。
• 仓库支持：默认启用 Ubuntu 的 Universe、Multiverse 和 Restricted 软件仓库，扩展依赖包获取范围。
• 轻量安装工具：集成 docker-apt-install 脚本，用于高效安装 Debian 软件包，自动清理缓存以保持镜像精简。

3. 使用场景和适用范围

3.1 适用场景

• 射电天文数据处理：作为 KERN 套件的运行环境，支持射电天文观测数据的处理、分析与可视化。
• 软件开发与测试：为 KERN 相关工具的开发、调试提供一致的环境，避免“环境依赖”问题。
• 自定义应用构建：作为基础镜像，用于构建包含特定业务逻辑的射电天文应用容器（如数据 pipeline、自动化分析工具等）。

3.2 适用人群

射电天文领域的科研人员、数据工程师、软件开发者，以及需要快速部署 KERN 环境的用户。

4. 使用方法和配置说明

4.1 获取镜像

4.1.1 从 Docker Hub 拉取（推荐）

镜像托管于 Docker Hub，可直接拉取：

bash
docker pull kernsuite/base:9

注：9 为 KERN 版本标签，需与目标应用版本匹配。

4.1.2 手动构建

若需本地构建，可通过项目中的 make 命令执行（需项目包含构建脚本）：

bash
git clone <KERN 镜像源码仓库>  # 若有源码仓库
cd <仓库目录>
make build  # 执行构建

4.2 运行容器

通过 docker run 命令启动容器，执行指定命令：

bash
docker run --rm kernsuite/base:9 <cmd>

• --rm：容器退出后自动清理文件系统（可选，适用于临时任务）。
• <cmd>：需执行的命令（如 bash 进入交互终端，或 kern --version 检查 KERN 版本）。

示例：启动交互终端并检查系统版本

bash
docker run -it --rm kernsuite/base:9 bash
# 在容器内执行
cat /etc/os-release  # 查看 Ubuntu 版本
apt list --installed | grep kern  # 查看已安装的 KERN 组件

4.3 作为基础镜像构建自定义容器

在 Dockerfile 中使用本镜像作为基础，扩展自定义功能：

dockerfile
# Dockerfile 示例
FROM kernsuite/base:9

# 使用 docker-apt-install 安装额外依赖（推荐，保持镜像精简）
RUN docker-apt-install <package-name>

# 添加自定义应用代码
COPY ./my-app /app

# 设置入口命令
CMD ["/app/start.sh"]

4.4 docker-apt-install 脚本使用

该脚本用于替代 apt-get install，自动处理依赖安装与缓存清理，减少镜像体积：

bash
# 安装单个包
docker-apt-install <package>

# 安装多个包
docker-apt-install <package1> <package2> ...

原理：执行 apt-get update && apt-get install -y <packages> && apt-get clean && rm -rf /var/lib/apt/lists/*，避免残留缓存文件。

5. 镜像信息与资源

• Docker Hub 地址：https://hub.docker.com/repository/docker/kernsuite/base
• 官方文档：KERN 套件官网
• 版本标签：推荐使用 9（对应 KERN 9 版本），确保环境一致性。