rudester/k8sbox

K8s网络与数据库调试瑞士军刀镜像

镜像概述

本镜像为K8s集群环境提供一站式调试解决方案，集成了多种网络诊断和数据库访问工具，旨在帮助用户快速定位和解决K8s集群中的网络连接异常、服务发现故障、数据库访问问题等常见场景。作为轻量级调试工具集合，可直接在K8s集群中部署运行，无需额外依赖配置。

核心功能与特性

网络调试工具集

• 基础网络工具：curl、wget、telnet、nc（netcat）
• DNS诊断工具：nslookup、dig、host
• 网络分析工具：tcpdump、traceroute、mtr、iftop
• 连接测试工具：ss、netstat、ping

数据库客户端工具

• 关系型数据库：mysql-client、psql（PostgreSQL客户端）、sqlcmd（MSSQL客户端）
• NoSQL数据库：redis-cli、mongo（MongoDB客户端）、etcdctl（etcd客户端）

系统与K8s辅助工具

• 系统诊断：top、htop、df、du、lsof
• 文件操作：vim、less、jq（JSON解析）
• K8s兼容：支持在非特权容器中运行，适配K8s网络策略与Service访问模型

使用场景与适用范围

典型使用场景

• K8s网络问题排查：Pod间通信故障、Service转发异常、Ingress规则验证、DNS解析失败
• 数据库连接诊断：应用与数据库间网络连通性测试、认证授权失败排查、查询性能临时分析
• 容器环境验证：检查容器内网络配置、系统资源使用情况、文件系统权限
• 临时调试部署：在故障Pod所在节点或命名空间快速部署，进行现场问题诊断

适用人群

K K- KK8s运维工程师、SRE、开发工程师、SRE-运维工程师、SRE、-SRE、-开发工程师、运维工程师、SRE、DevOps工程师、-SRE及运维人员、K88集群管理员、数据库管理员、K开发测试工程师

使用方法与配置说明

使用方法与配置说明

使用方法与配置说明

基础使用方法

1. 在K集群中部署调试Pod

通过kubectl直接部署调试Pod：

bash
kubectl run debug-pod --image=<镜像名称> --rm -it -- sh

2. 本地调试容器运行（用于测试）

bash
docker run -it --rm <镜像名称> sh

工具使用示例

网络调试示例

bash
# 测试DNS解析
nslookup kubernetes.default.svc.cluster.local

# 测试数据库连接
mysql -h <db-service-name> -u <username> -p <password>

# 抓包分析网络流量
tcpdump -i any port 54433

#### 数据库调试示例
```bash
# 连接Redis集群
redis-cli -h <redis-service-name> -p 6379

# 连接PostgreSQL
psql -h <pg-service-name> -U <username> -d <database-name>

环境变量配置（如有）

本镜像默认无需额外环境变量配置，工具均通过命令行参数直接调用。如需持久化配置（如常用数据库连接信息），可通过挂载配置文件实现：

bash
kubectl run debug-pod --image=<镜像名称> --rm -it -v /local/config:/config -- sh
# 在容器内加载配置文件：source /config/db-credentials.sh

部署示例

K8s临时调试Pod部署

bash
# 创建临时调试Pod并进入交互式终端
kubectl run k8s-debug-swissknife \
  --image=<镜像名称> \
  --rm -it \
  --namespace=<目标命名空间> \
  -- sh

Docker本地测试

bash
# 本地运行镜像进行工具测试
docker run -it --rm <镜像名称> sh

docker-compose配置示例（本地调试用）

yaml
version: '3'
services:
  debug-tools:
    image: <镜像名称>
    tty: true
    stdin_open: true
    network_mode: "host"  # 可选，用于测试主机网络环境