Red Hat Universal Base Image 9 Minimal (UBI 9 Minimal) 技术文档

一、镜像概述

Red Hat Universal Base Image 9 Minimal（简称 UBI 9 Minimal）是 Red Hat 提供的精简版基础容器镜像，专为构建轻量级、高效的容器环境设计。该镜像采用 microdnf 作为包管理器，具备体积小、资源占用低的特点。UBI 9 Minimal 可自由再分发，但 Red Hat 仅通过其产品订阅服务为 Red Hat 技术提供官方支持。镜像由 Red Hat 官方维护并定期更新，确保安全性和稳定性。

二、核心功能与特性

1. 轻量级设计

• 基于精简的操作系统内核，镜像体积显著小于标准基础镜像，降低容器部署的存储和网络开销。

2. microdnf 包管理器

• 集成 microdnf（dnf 包管理器的轻量级实现），专为容器环境优化，资源占用低，支持基础包管理操作（安装、更新、删除）。

3. 官方维护与定期更新

• 由 Red Hat 官方团队维护，遵循 Red Hat 的安全更新策略，定期推送漏洞修复和版本更新，确保镜像安全性。

4. 合规性与再分发

• 遵循 Red Hat 通用基础镜像许可协议，允许自由再分发，适合企业级应用的合规性需求。

三、使用场景与适用范围

1. 轻量级应用容器构建

• 作为微服务、CLI 工具或轻量级应用的基础镜像，减少最终容器体积。

2. 最小化安全攻击面

• 适用于对安全要求高的场景，精简的镜像减少了潜在漏洞和攻击向量。

3. CI/CD 流水线基础层

• 在自动化构建流程中作为基础镜像，加速构建过程并降低资源消耗。

4. Red Hat 生态系统应用打包

• 与 Red Hat 产品（如 OpenShift、RHEL）兼容，适合构建基于 Red Hat 技术栈的应用容器。

四、使用方法与配置说明

1. 获取镜像

通过 Docker 官方仓库或 Red Hat 容器镜像仓库拉取最新版本：

docker pull registry.access.redhat.com/ubi9-minimal:latest

2. 基本运行与交互

启动一个临时容器并进入交互终端：

docker run -it --rm registry.access.redhat.com/ubi9-minimal:latest /bin/bash

• -it：启用交互终端；--rm：容器退出后自动删除。

3. 使用 microdnf 管理包

安装包示例（如 curl）：

microdnf install -y curl

更新所有包：

microdnf update -y

删除包：

microdnf remove -y curl

清理缓存：

microdnf clean all

4. Dockerfile 示例（构建应用镜像）

以构建一个包含 curl 的自定义镜像为例：

# 基础镜像
FROM registry.access.redhat.com/ubi9-minimal:latest

# 安装依赖包
RUN microdnf install -y curl && \
    microdnf clean all  # 清理缓存以减小镜像体积

# 定义工作目录
WORKDIR /app

# 启动命令（示例）
CMD ["curl", "--version"]

构建并运行自定义镜像：

docker build -t ubi9-minimal-curl .
docker run --rm ubi9-minimal-curl

5. docker-compose 配置示例

创建 docker-compose.yml 定义服务：

version: '3.8'
services:
  app:
    image: registry.access.redhat.com/ubi9-minimal:latest
    command: /bin/bash -c "microdnf install -y curl && curl --version"
    volumes:
      - ./app:/app  # 挂载本地目录（可选）
    environment:
      - HTTP_PROXY=[***]  # 代理环境变量（如需）

启动服务：

docker-compose up

五、环境变量与配置参数

1. 常用环境变量

2. 容器运行时参数

六、注意事项

1. 支持范围：Red Hat 仅通过订阅服务为使用 Red Hat 产品的用户提供 UBI 镜像支持，非订阅用户可自由使用但无官方技术支持。
2. microdnf 局限性：microdnf 不支持 dnf 的全部功能（如插件、复杂依赖解析），仅适用于基础包管理。
3. 精简镜像依赖：部分系统工具（如 systemd）未预装，需根据应用需求手动安装。
4. 镜像更新：定期拉取最新版本以获取安全补丁，建议在 Dockerfile 中指定具体版本标签（如 ubi9-minimal:9.2）而非 latest，确保构建一致性。