mirantis/kubernetes-cluster-info

mirantis/kubernetes-cluster-info 镜像文档

镜像概述和主要用途

mirantis/kubernetes-cluster-info是一个基于alpine:latest构建的Docker镜像，专门用于查询MKE（Mirantis Kubernetes Engine）集群的信息。该镜像提供便捷的集群数据采集功能，可获取节点数量、CPU核心分布、资源配置等关键指标，支持两种运行模式：直接在集群manager节点通过Docker socket通信，或在本地机器通过客户端bundle与MKE API通信。

核心功能和特性

• 集群资源数据采集：获取集群节点总数、CPU核心总数、最小/最大/平均CPU核心数等关键指标
• 多维度节点分类统计：支持按节点角色（manager/worker）和操作系统（Linux/Windows）分类统计资源信息
• 双运行模式支持：
  • 集群内模式：直接在manager节点运行，通过Docker socket与ucp-controller通信，配置简单
  • 本地模式：在本地机器（如Docker Desktop）运行，通过客户端bundle与MKE API通信，适用于安全环境
• 轻量级设计：基于alpine:latest构建，镜像体积小，资源占用低

使用场景和适用范围

• 集群资源审计：快速评估集群整体资源配置状况
• 节点配置验证：检查manager和worker节点的CPU资源分配是否符合预期
• 集群状态评估：在集群扩容、升级或优化前收集基础节点信息
• 安全环境部署：对于启用Docker Content Trust或有严格安全策略的环境，推荐使用本地模式避免在集群内运行容器

详细使用方法和配置说明

镜像拉取

bash
docker pull mirantis/kubernetes-cluster-info

使用方法一：在集群上运行

直接在MKE集群的manager节点运行，通过Docker socket与ucp-controller通信，适用于快速查询场景。

操作步骤：

1. 加载MKE客户端bundle（或直接在manager节点上执行命令）
2. 运行容器：

bash
docker run -t --rm --name kubernetes-cluster-info \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e affinity:container==ucp-controller \
  mirantis/kubernetes-cluster-info

输出示例：

========================
Data for all nodes:
2 Core x 4
4 Core x 11

# Nodes - 15
Ttl Core - 52
Min Core - 2
Max Core - 4
Avg Core - 3.46
========================
Data for manager nodes:
4 Core x 3

# Nodes - 3
Ttl Core - 12
Min Core - 4
Max Core - 4
Avg Core - 4.00
========================
Data for worker nodes:
2 Core x 4
4 Core x 8

# Nodes - 12
Ttl Core - 40
Min Core - 2
Max Core - 4
Avg Core - 3.33
========================
Data for all nodes running linux:
2 Core x 4
4 Core x 9

# Nodes - 13
Ttl Core - 44
Min Core - 2
Max Core - 4
Avg Core - 3.38
========================
Data for all nodes running windows:
4 Core x 2

# Nodes - 2
Ttl Core - 8
Min Core - 4
Max Core - 4
Avg Core - 4.00
========================

使用方法二：在本地引擎运行

在本地机器（如Docker Desktop）运行，通过客户端bundle与MKE API通信，适用于安全环境。

操作步骤：

1. 获取MKE的URL（如ucp.example.com）和已解压的客户端bundle本地路径
2. 运行容器，替换UCP_URL和客户端bundle路径：

bash
docker run -t --rm --name kubernetes-cluster-info \
  -e UCP_URL="ucp.example.com" \
  -v /path/to/your/client/bundle:/data:ro \
  mirantis/kubernetes-cluster-info

输出示例：

========================
Data for all nodes:
2 Core x 4
4 Core x 11

# Nodes - 15
Ttl Core - 52
Min Core - 2
Max Core - 4
Avg Core - 3.46
========================
Data for manager nodes:
4 Core x 3

# Nodes - 3
Ttl Core - 12
Min Core - 4
Max Core - 4
Avg Core - 4.00
========================
Data for worker nodes:
2 Core x 4
4 Core x 8

# Nodes - 12
Ttl Core - 40
Min Core - 2
Max Core - 4
Avg Core - 3.33
========================

使用方法三：从MKE支持dump分析

通过support_dump_count_cores.sh脚本可从MKE支持dump中获取基础集群信息。该方式数据详细程度较低，但可获取集群规模的基本统计数据。