mirantis/audit-cluster

mirantis/audit-cluster 镜像文档

镜像概述

mirantis/audit-cluster是一个基于alpine:latest构建的Docker镜像，专门用于审计Swarm/UCP集群，获取节点核心数量及其他规模统计信息，为集群资源评估和规划提供数据支持。

核心功能与特性

• 统计集群所有节点的核心分布情况
• 提供节点总数、核心总数、最小核心数、最大核心数及平均核心数
• 按节点类型（管理节点、工作节点）分类统计核心信息
• 按操作系统（Linux、Windows）分类统计核心信息
• 支持两种运行模式：直接在集群上运行或通过本地引擎连接UCP API运行

使用场景

• 集群资源容量评估
• 节点资源配置审计
• 集群规模规划与优化
• 生成集群资源统计报告

使用方法

拉取镜像

bash
docker pull docker.xuanyuan.run/mirantis/audit-cluster

运行方式

1. 在集群上运行

直接在集群管理节点上运行，通过Docker socket与UCP控制器通信（需具备从Docker Hub拉取镜像的权限）。

步骤：

1. 加载UCP客户端bundle（或直接在管理节点上运行命令）
2. 执行以下命令：

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

输出示例：

========================
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
========================

2. 在本地引擎上运行

在本地机器（如Docker Desktop）上运行，通过UCP API通信，需使用UCP客户端bundle（适用于安全环境或启用Docker Content Trust策略的场景）。

步骤：

1. 获取UCP URL及已解压的客户端bundle本地路径
2. 执行以下命令（替换UCP_URL和客户端bundle路径）：

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

输出示例：

========================
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
========================

3. 从UCP支持转储分析

可使用support_dump_count_cores.sh脚本本地分析UCP支持转储文件，获取集群规模的基本信息（数据详细程度低于API调用）。