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

1. 镜像概述与主要用途

1.1 概述

Red Hat Universal Base Image 10（简称UBI 10）是由Red Hat设计开发的容器基础镜像，旨在作为各类容器化应用、中间件及工具的底层基础层。该镜像由Red Hat***维护，并提供定期更新，确保基础环境的稳定性与安全性。

1.2 主要用途

UBI 10的核心用途是作为容器化应用的标准化基础层，为开发、构建和部署提供统一、可靠的底层环境。适用于构建应用程序、中间件服务、工具脚本等各类容器镜像，支持从开发到生产环境的全生命周期使用。

2. 核心功能与特性

• 通用基础层：设计为中立基础，兼容各类容器化应用、中间件及工具的构建需求。
• 自由再分发：允许用户自由分发和使用，无额外许可限制。
• ***维护与更新：由Red Hat专业团队维护，提供定期更新（含安全补丁、系统组件优化等）。
• 订阅支持选项：虽可自由使用，但Red Hat通过产品订阅为基于UBI的Red Hat技术提供***支持服务。

3. 使用场景与适用范围

3.1 典型使用场景

• 容器化应用开发：作为应用镜像的基础层，构建标准化开发环境。
• 中间件部署：部署Web服务器、数据库客户端等中间件服务的底层环境。
• 工具容器构建：创建开发、测试或运维所需的工具类容器（如脚本执行环境）。
• 多阶段构建基础：在Docker多阶段构建中作为基础层，精简最终镜像体积。

3.2 适用范围

• 开发者：需要可靠、标准化基础镜像的容器化应用开发者。
• 企业用户：寻求Red Hat生态支持的企业级容器部署场景。
• 开源项目：需可自由分发基础镜像的开源项目构建流程。

4. 使用方法与配置说明

4.1 镜像拉取

通过Docker命令从Red Hat容器镜像仓库拉取UBI 10镜像：

bash
docker pull registry.access.redhat.com/ubi10/ubi:latest

（注：具体仓库地址可能因环境而异，建议参考Red Hat***文档获取最新拉取指令。）

4.2 基础使用示例

4.2.1 运行交互式终端

启动UBI 10容器并进入交互式shell（用于环境测试或调试）：

bash
docker run -it --rm registry.access.redhat.com/ubi10/ubi:latest /bin/bash

• -it：启用交互式终端
• --rm：容器退出后自动删除
• /bin/bash：启动bash shell

4.2.2 作为多阶段构建基础层

在Dockerfile中使用UBI 10构建应用镜像：

dockerfile
# 阶段1：基于UBI 10构建应用
FROM registry.access.redhat.com/ubi10/ubi:latest AS builder
RUN dnf install -y gcc && \
    echo "构建应用..." > /app/output.txt

# 阶段2：构建最终镜像
FROM registry.access.redhat.com/ubi10/ubi:latest
COPY --from=builder /app/output.txt /app/
CMD ["cat", "/app/output.txt"]

4.3 Docker Compose配置示例

以下为基于UBI 10的工具容器docker-compose配置示例：

yaml
version: '3.8'
services:
  ubi10-tool:
    image: registry.access.redhat.com/ubi10/ubi:latest
    command: /bin/bash -c "echo '运行于UBI 10环境'; sleep 3600"  # 持续运行3600秒
    container_name: ubi10-demo
    restart: unless-stopped  # 非手动停止则自动重启

启动命令：docker-compose up -d
进入容器：docker-compose exec ubi10-tool /bin/bash

4.4 配置说明

UBI 10作为基础镜像，无内置特定应用配置参数。用户需基于实际需求，通过Dockerfile自定义配置：

• 环境变量：使用ENV指令设置（如ENV APP_HOME=/app）。
• 依赖安装：通过RUN dnf install <package>安装系统依赖。
• 启动命令：通过CMD或ENTRYPOINT定义容器启动行为。

5. 注意事项

• 订阅支持范围：UBI 10可自由使用，但Red Hat仅通过产品订阅为Red Hat技术提供***支持。
• 更新策略：建议定期拉取latest标签镜像，以获取最新安全补丁和系统优化。
• 兼容性：基于Red Hat Enterprise Linux 10相关技术构建，确保与RHEL 10生态组件兼容。