wise2c/kubeadm-version

镜像概述

该Docker镜像提供了一个便捷环境，用于通过kubeadm config images list命令获取Kubernetes（K8s）集群部署所需的组件镜像及其版本列表。它封装了kubeadm工具，使用户无需在本地系统安装kubeadm，即可快速查询不同K8s版本对应的组件镜像信息，简化K8s部署过程中的镜像准备工作。

核心功能和特性

• 无需本地安装kubeadm：通过Docker容器运行，避免在主机系统配置kubeadm依赖环境
• 支持指定K8s版本：可通过参数指定目标Kubernetes版本，获取对应版本的组件镜像列表
• 轻量级封装：仅包含kubeadm及必要依赖，镜像体积小，启动速度快
• 兼容标准kubeadm命令：支持kubeadm config images list的原生参数，输出格式与官方一致

使用场景

• 查看特定K8s版本组件镜像：用户需要确认部署某版本K8s时所需的组件镜像（如kube-apiserver、kube-controller-manager等）及其版本
• 无kubeadm环境快速查询：在未安装kubeadm的工作站、CI/CD流水线或容器化环境中，快速获取镜像列表
• 自动化部署脚本集成：在K8s集群部署脚本中，通过该镜像动态获取目标版本的镜像列表，用于镜像拉取或私有仓库同步

使用方法

基本用法

默认获取镜像内置kubeadm版本对应的K8s组件镜像列表：

bash
docker run --rm wise2c-devops/kubeadm-version kubeadm config images list

指定Kubernetes版本

通过--kubernetes-version参数指定目标K8s版本，获取对应版本的镜像列表（以v1.27.0为例）：

bash
docker run --rm wise2c-devops/kubeadm-version kubeadm config images list --kubernetes-version v1.27.0

输出示例

执行上述命令后，将输出类似以下的组件镜像列表（具体版本和镜像仓库可能因K8s版本而异）：

k8s.gcr.io/kube-apiserver:v1.27.0
k8s.gcr.io/kube-controller-manager:v1.27.0
k8s.gcr.io/kube-scheduler:v1.27.0
k8s.gcr.io/kube-proxy:v1.27.0
k8s.gcr.io/pause:3.9
k8s.gcr.io/etcd:3.5.7-0
k8s.gcr.io/coredns/coredns:v1.10.1

配置参数说明

支持kubeadm config images list命令的所有原生参数，常用参数如下：

• --kubernetes-version：指定Kubernetes版本（如v1.27.0），默认使用镜像内置kubeadm版本
• --image-repository：指定镜像仓库（如registry.aliyuncs.com/google_containers），默认使用k8s.gcr.io
• --config：通过配置文件指定参数（需挂载配置文件到容器内，如-v /local/config.yaml:/config.yaml后使用--config /config.yaml）

注：使用--image-repository等需挂载文件的参数时，需通过-v选项将本地文件挂载到容器内对应路径。