iptizer/swiss

swiss

镜像概述和主要用途

swiss 是一个专为故障排除设计的容器，预装了多种工具，旨在简化 Kubernetes 和 Docker 环境中的系统调试和问题诊断工作。该容器可快速部署，支持灵活的使用方式，适用于各类系统问题排查场景。

容器已发布至 Docker Hub：https://hub.docker.com/r/iptizer/swiss

核心功能和特性

• 多环境支持：同时适用于 Kubernetes 集群和 Docker 环境
• 工具丰富：预装多种故障排除工具，满足日常调试需求
• 灵活部署：提供 Kubernetes Deployment 和 DaemonSet 两种部署方式，适应不同场景
• 扩展权限选项：DaemonSet 版本（swiss-host）支持主机挂载，提供扩展权限（需谨慎使用）

使用场景和适用范围

节点磁盘压力故障排除

通过 swiss-host（DaemonSet 版本）可挂载主机资源，方便诊断节点磁盘空间压力等存储相关问题。

跳板机

部署 swiss 容器后，可通过 tmux 工具将其用作跳板机，连接至集群内其他资源。

系统调试

适用于 Kubernetes 集群或 Docker 环境中的各类系统问题排查，如网络、资源、服务可用性等。

使用方法和配置说明

快速开始

Kubernetes 环境

直接运行临时容器

sh
kubectl run -it --restart=Never --rm --image=iptizer/swiss swiss -- /bin/bash

Deployment 和 DaemonSet 部署

本镜像提供两种 Kubernetes 部署版本：

• Deployment: swiss（标准部署）
• DaemonSet: swiss-host（扩展权限，主机挂载至 Pod，需谨慎使用！）

部署步骤：

1. 创建命名空间

sh
kubectl create ns troubleshoot

2. DaemonSet 部署

sh
# 应用 DaemonSet 配置
kubectl apply -n troubleshoot -f daemonset.yaml
# 查看 Pod
kubectl get po -n troubleshoot
# 进入容器
kubectl exec -it swiss-577np -- bash
# 清理
kubectl delete -f daemonset.yaml

3. Deployment 部署（可直接复制粘贴执行）

sh
# 应用 Deployment 配置
kubectl apply -n troubleshoot -f deployment.yaml
# 调整副本数为 1
kubectl scale -n troubleshoot --replicas=1 deploy/swiss
# 等待 Deployment 可用后进入容器
kubectl wait  -n troubleshoot --timeout=600s --for=condition=available deploy/swiss && \
kubectl exec -n troubleshoot -it $( k get po -l "app=swiss" -o jsonpath='{.items[0].metadata.name}' ) -- bash
# 清理：调整副本数为 0 并删除 Deployment
kubectl scale -n troubleshoot --replicas=0 deploy/swiss
kubectl delete -f deployment.yaml

Docker 环境

基本运行

sh
docker run -it --rm iptizer/swiss -- /bin/bash

包含代理配置

sh
HTTP_PROXY="http://my.proxy"
NO_PROXY="127.0.0.1,localhost"
docker run --rm --env HTTP_PROXY=${HTTP_PROXY} --env HTTPS_PROXY=${HTTP_PROXY} --env http_proxy=${HTTP_PROXY} --env https_proxy=${HTTP_PROXY} --env NO_PROXY=${NO_PROXY} --env no_proxy=${NO_PROXY} -it iptizer/swiss /bin/bash

手动本地构建

若需本地构建镜像，可执行以下命令：

sh
docker build . -t iptizer/swiss:latest
docker push iptizer/swiss:latest