svenmollinga/kubedebug

Kubedebug

镜像概述和主要用途

Kubedebug是一个预安装多种调试工具的Kubernetes/Docker容器，无需额外安装或配置即可使用。容器在退出后会自动删除，专为快速诊断网络连接、域名解析、系统连通性等问题设计，适用于Kubernetes平台或Docker环境下的临时调试场景。

核心功能和特性

• 内置常用调试工具：包含curl（HTTP请求）、dig（DNS查询）、traceroute（路由跟踪）、whois（域名信息查询）、nc（网络连接测试）、lynx（文本浏览器）
• 零配置使用：无需预先安装或配置，直接启动即可使用
• 自动清理：容器退出后自动删除，不会残留系统资源

依赖环境

使用Kubedebug需满足以下任一环境要求：

• Kubernetes平台
• Docker环境

使用方法

在Kubernetes平台使用

在当前命名空间启动调试容器：

bash
kubectl run debugpod --restart=Never --rm -i --tty --image svenmollinga/kubedebug:latest -- bash

参数说明：--rm 确保容器退出后自动删除，-i 和 --tty 提供交互式终端

在Docker环境使用

在Docker主机上启动调试容器：

bash
docker run --rm -i --tty svenmollinga/kubedebug:latest bash

参数说明：--rm 确保容器退出后自动删除，-i（交互模式）和 --tty（分配终端）提供交互式环境

配置说明

为简化使用流程，可将启动命令添加到bash别名中，之后通过kubedebug命令快速启动容器：

1. 编辑bash配置文件：

bash
vi ~/.bashrc

2. 添加以下别名配置：

bash
alias kubedebug="kubectl run debugpod --restart=Never --rm -i --tty --image svenmollinga/kubedebug:latest -- bash"

3. 使配置生效：

bash
source ~/.bashrc

配置完成后，直接在终端输入kubedebug即可快速启动调试容器。