easzlab/kubeasz-sys-pkg

kubeasz-system-packages 镜像文档

1. 镜像概述和主要用途

该镜像是 kubeasz 项目（https://github.com/easzlab/kubeasz%EF%BC%89%E7%9A%84%E9%85%8D%E5%A5%97%E7%BB%84%E4%BB%B6%EF%BC%8C%E7%94%A8%E4%BA%8E%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E5%8C%85%E5%90%AB kubeasz 所需系统依赖包的 Docker 镜像。其核心用途是为 kubeasz 部署和运行提供标准化的系统环境，预集成必要的 RPM（如 CentOS 系列）或 DEB（如 Ubuntu 系列）系统包，简化 kubeasz 在不同 Linux 发行版上的依赖管理流程。

2. 核心功能和特性

2.1 预安装系统依赖

镜像内预先编译并安装 kubeasz 运行所需的核心系统包（如 curl、openssl、socat 等），避免部署过程中重复下载和配置。

2.2 多发行版支持

支持基于 RPM 包管理的 Linux 发行版（如 CentOS 7/8、Rocky Linux）和基于 DEB 包管理的发行版（如 Ubuntu 18.04/20.04、Debian 10/11），通过不同镜像标签区分。

2.3 自动构建集成

与 kubeasz 项目的 CI/CD 流程深度集成，实现镜像的自动化构建、测试和更新，确保依赖包版本与 kubeasz 版本兼容。

2.4 轻量级设计

基于官方最小化基础镜像（如 centos:7、ubuntu:20.04）构建，仅包含必要依赖，减少镜像体积和资源占用。

3. 使用场景和适用范围

3.1 kubeasz 部署环境

作为 kubeasz 部署 Kubernetes 集群的前置环境依赖，提供标准化的系统包基础，确保部署过程中依赖检查和安装步骤高效执行。

3.2 开发与测试

供开发者在本地或 CI 环境中快速搭建与生产环境一致的 kubeasz 依赖环境，用于功能测试、版本兼容性验证等。

3.3 离线部署支持

可作为离线环境的系统包源，通过导出镜像并传输至离线节点，解决无网络环境下的依赖安装问题。

4. 使用方法和配置说明

4.1 镜像信息

• 镜像名称：通常为 easzlab/kubeasz-system-packages（具体以 kubeasz 项目文档为准）。
• 标签格式：<发行版>-<版本>，例如 centos7（基于 CentOS 7）、ubuntu20.04（基于 Ubuntu 20.04）。

4.2 拉取镜像

通过 Docker 命令拉取指定发行版的镜像：

bash
# 拉取 CentOS 7 版本
docker pull easzlab/kubeasz-system-packages:centos7

# 拉取 Ubuntu 20.04 版本
docker pull easzlab/kubeasz-system-packages:ubuntu20.04

4.3 运行容器

以交互式方式运行容器，验证依赖包是否已安装：

bash
# 运行 CentOS 7 容器
docker run -it --rm easzlab/kubeasz-system-packages:centos7 /bin/bash

# 在容器内检查依赖包（以 curl 为例）
rpm -q curl  # 输出 curl-* 表示已安装

4.4 与 kubeasz 集成使用

在 kubeasz 部署流程中，该镜像通常由部署脚本自动调用，无需手动操作。若需自定义，可通过修改 kubeasz 配置文件中的 SYSTEM_PACKAGES_IMAGE 参数指定镜像名称和标签，例如：

bash
# 在 kubeasz 的 ezdown 脚本或配置文件中设置
export SYSTEM_PACKAGES_IMAGE="easzlab/kubeasz-system-packages:centos7"

5. 配置参数与环境变量

该镜像暂无额外可配置参数或环境变量，其行为完全由镜像标签（发行版版本）决定。运行容器时，可通过覆盖 CMD 或 ENTRYPOINT 自定义命令，例如：

bash
# 非交互式运行，直接输出已安装的依赖包列表
docker run --rm easzlab/kubeasz-system-packages:ubuntu20.04 dpkg -l | grep -E "curl|openssl"

6. 注意事项

• 发行版匹配：确保使用的镜像标签与目标主机的 Linux 发行版一致（如 CentOS 主机对应 centos* 标签），避免因包管理工具差异导致依赖冲突。
• 版本同步：镜像版本需与 kubeasz 版本匹配，建议通过 kubeasz 官方文档获取推荐的镜像标签，避免因依赖版本不兼容导致部署失败。
• 离线使用：若需在离线环境使用，可通过 docker save 导出镜像，传输至目标节点后用 docker load 导入。