kvalitetsit/busykit

BusyKit Docker镜像文档

镜像概述

BusyKit是一个轻量级Docker镜像，基于Alpine Linux构建，集成了常用的系统工具和网络诊断工具。它旨在为容器化环境提供便捷的故障排除和系统维护能力，无需在生产容器中安装额外工具。

核心功能和特性

• 轻量级设计：基于Alpine Linux，镜像体积小巧（约10MB）
• 全面工具集：包含多种系统和网络诊断工具
• 多平台支持：支持amd64、arm64等多种架构
• 即开即用：无需复杂配置，可直接使用
• 安全可靠：定期更新，包含安全补丁
• 无需特权：可在非特权模式下运行

包含的主要工具

• 系统工具：ps、top、htop、df、du、free、lsof、vmstat
• 网络工具：ping、traceroute、netstat、ss、tcpdump、nslookup、dig
• 文件工具：vi、nano、cat、tail、head、grep、find
• 传输工具：curl、wget、scp
• 其他工具：bash、sh、jq、openssl

使用场景和适用范围

• 容器网络问题诊断和排查
• 系统资源监控和分析
• 容器间通信测试
• 日志查看和分析
• 文件操作和管理
• CI/CD管道中的系统检查
• Kubernetes集群故障排除

使用方法和配置说明

基本使用

直接运行容器并进入交互式终端：

bash
docker run -it --rm kvalitetsit/busykit

在特定网络中使用

连接到现有容器的网络命名空间进行诊断：

bash
docker run -it --rm --net=container:<container_name_or_id> kvalitetsit/busykit

挂载主机目录

挂载主机目录以访问日志或配置文件：

bash
docker run -it --rm -v /var/log:/host/log kvalitetsit/busykit

在Kubernetes中使用

创建临时Pod进行集群内诊断：

bash
kubectl run -it --rm busykit --image=kvalitetsit/busykit -- sh

在特定命名空间中运行：

bash
kubectl run -it --rm busykit --namespace=default --image=kvalitetsit/busykit -- sh

Docker Compose集成

在docker-compose.yml中添加：

yaml
version: '3'
services:
  busykit:
    image: kvalitetsit/busykit
    tty: true
    network_mode: "service:<service_name>"  # 连接到其他服务的网络

Docker Compose示例

以下是一个完整的docker-compose配置示例，展示如何将BusyKit与其他服务一起使用：

yaml
version: '3'

services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html

  # BusyKit服务配置
  busykit:
    image: kvalitetsit/busykit
    tty: true
    network_mode: "service:web"  # 共享web服务的网络命名空间
    volumes:
      - ./html:/web/html  # 挂载web服务的文件目录
      - /var/run/docker.sock:/var/run/docker.sock  # 可选：挂载Docker套接字

启动服务：

bash
docker-compose up -d

进入BusyKit容器：

bash
docker-compose exec busykit sh

环境变量配置

BusyKit镜像支持以下环境变量配置：

• TIMEZONE：设置时区，例如TIMEZONE=Europe/Stockholm
• LANG：设置语言环境，例如LANG=en_US.UTF-8

使用示例：

bash
docker run -it --rm -e TIMEZONE=Asia/Shanghai kvalitetsit/busykit

自定义构建

如需自定义BusyKit镜像，可以克隆GitHub仓库并修改Dockerfile：

bash
git clone https://github.com/KvalitetsIT/BusyKit.git
cd BusyKit
# 修改Dockerfile添加或移除工具
docker build -t my-custom-busykit .

版本信息

• 最新稳定版：kvalitetsit/busykit:latest
• 特定版本：kvalitetsit/busykit:1.2.0（请查看GitHub仓库获取最新版本号）

注意事项

• 该镜像主要用于诊断和故障排除，不建议在生产环境中长期运行
• 在生产环境中使用时，请遵循最小权限原则
• 使用--rm选项可确保容器退出后自动清理，避免残留资源

相关资源

• GitHub仓库：https://github.com/KvalitetsIT/BusyKit
• Docker Hub：https://hub.docker.com/r/kvalitetsit/busykit