alchen99/k8s-debug

Docker/K8s调试工具容器

镜像概述和主要用途

这是一个用于帮助调试K8s（Kubernetes）和其他容器的工具容器，预先配置了多种常用的命令行工具，方便用户在容器环境中快速进行诊断、问题排查和日常操作。

核心功能和特性

容器中预先配置了以下工具：

• bash及bash-completion
• AWS CLI和aws-iam-authenticator
• kubectl（已定义别名k）
• curl、httpie、wget
• jq（JSON处理工具）
• mysql-client（MySQL客户端）
• openldap-clients（LDAP客户端工具）
• openssl（加密工具）
• postgresql-client（PostgreSQL客户端）
• screen和tmux（终端会话管理工具）
• vim和vimdiff（文本编辑工具）

版本标签（Tags）

由于gcloud工具体积较大，提供两个版本：

• 2.0、gcloud - 包含gcloud CLI工具
• 1.1、latest - 不包含gcloud CLI工具

构建（Build）

可通过以下命令本地构建镜像：

bash
docker build -t alchen99/k8s-debug .

镜像已在Docker Hub上自动构建，可直接拉取使用：

使用场景和适用范围

适用于以下场景：

• K8s集群故障排查（使用kubectl、aws-iam-authenticator等）
• 容器网络、服务连通性测试（使用curl、wget、httpie）
• 云服务（AWS、GCP）相关操作验证（使用AWS CLI、gcloud）
• JSON数据处理与分析（使用jq）
• 数据库连接测试（使用mysql-client、postgresql-client）
• 长时间终端会话管理（使用screen、tmux）

使用方法和配置说明

环境变量配置

若需使用AWS相关工具，需预先配置以下环境变量：

bash
export AWS_ACCESS_KEY_ID="<AWS访问密钥ID>"
export AWS_SECRET_ACCESS_KEY="<AWS密钥>"
export AWS_DEFAULT_REGION="<默认AWS区域，如us-west-2>"

启动容器示例

通过以下命令启动容器并进入交互式终端：

bash
docker run -it --rm alchen99/k8s-debug:latest bash

（--rm参数表示容器退出后自动删除，可根据需要省略）

参考文档

• AWS CLI文档：[***]
• aws-iam-authenticator：https://github.com/kubernetes-sigs/aws-iam-authenticator
• gcloud CLI文档：[***]
• kubectl使用指南：[***]
• jq手册：https://stedolan.github.io/jq/manual/
• jq教程：https://stedolan.github.io/jq/tutorial/