bloomberg/goldpinger

Kubernetes节点连接性调试工具镜像

镜像概述

本镜像是一款专为Kubernetes集群设计的调试工具，核心功能是测试并可视化展示集群中节点间的网络连接状态。通过轻量级部署和直观输出，帮助用户快速定位节点通信异常，简化集群网络问题排查流程。

核心功能与特性

• 节点间连接性测试：支持TCP/UDP端口可达性、ICMP连通性等多种网络测试类型
• 连接状态可视化：以表格或结构化格式输出节点间连接状态（可达/不可达、延迟、错误信息）
• 灵活配置：支持自定义测试参数（超时时间、端口范围、测试协议等）
• Kubernetes原生集成：直接读取kubeconfig配置，无需额外集群认证配置
• 轻量级设计：镜像体积小巧，启动速度快，资源占用低

使用场景

• 集群网络故障排查：当节点间服务通信异常时，快速定位网络隔离节点或故障链路
• 新集群部署验证：集群初始化后，验证节点网络拓扑连通性
• 节点变更后检查：新增/下线节点、网络组件升级后，确认通信链路完整性
• 网络策略效果验证：测试网络策略对节点间通信的限制或允许规则是否生效

使用方法与配置说明

基本使用流程

1. 确保本地已安装Docker且可访问目标Kubernetes集群
2. 通过Docker运行镜像，挂载kubeconfig文件以获取集群访问权限

快速启动命令

bash
docker run --rm \
  -v ~/.kube/config:/app/kubeconfig \
  -e KUBECONFIG=/app/kubeconfig \
  [镜像名称]

配置参数说明

高级使用示例

1. 自定义测试端口与超时

bash
docker run --rm \
  -v ~/.kube/config:/app/kubeconfig \
  -e KUBECONFIG=/app/kubeconfig \
  -e TEST_TIMEOUT=10 \
  -e TEST_PORTS=22,8080,9443 \
  [镜像名称]

2. JSON格式输出并保存结果

bash
docker run --rm \
  -v ~/.kube/config:/app/kubeconfig \
  -v $(pwd):/app/output \
  -e KUBECONFIG=/app/kubeconfig \
  -e OUTPUT_FORMAT=json \
  [镜像名称] > /app/output/connectivity-report.json

3. 筛选特定节点测试

bash
docker run --rm \
  -v ~/.kube/config:/app/kubeconfig \
  -e KUBECONFIG=/app/kubeconfig \
  -e NODES_FILTER=node-1,node-3,node-5 \
  [镜像名称]

典型输出示例（表格格式）

+-------------+-------------+----------+----------+----------+----------------+
| 源节点      | 目标节点    | 状态     | 测试端口 | 延迟(ms) | 错误信息       |
+-------------+-------------+----------+----------+----------+----------------+
| node-1      | node-2      | 可达     | 443      | 3.2      | -              |
| node-1      | node-3      | 不可达   | 8080     | -        | 连接超时       |
| node-2      | node-3      | 可达     | 6443     | 2.8      | -              |
+-------------+-------------+----------+----------+----------+----------------+

注意事项

• 确保挂载的kubeconfig文件具有足够权限（至少能获取节点列表和执行网络测试）
• 对于大规模集群（>50节点），建议使用NODES_FILTER参数限制测试范围以减少资源消耗
• UDP测试可能需要容器具备CAP_NET_RAW权限，可添加--cap-add=NET_RAW参数
• 输出结果包含敏感网络信息，建议测试后清理本地日志文件