在Debian上安装Kubernetes（K8S）时可能会遇到一些常见问题，但通过遵循详细的步骤和配置，可以解决这些难题。以下是一个基于Debian 12的Kubernetes部署指南，帮助你解决常见的部署问题。
硬件和系统要求
- Master节点：至少2核CPU、4GB内存、20GB硬盘空间。
- Node节点：至少4核CPU、8GB内存、40GB硬盘空间。
- 软件要求：Debian 12（Bookworm）或更高版本，最小化安装，具有管理权限的sudo用户，稳定的互联网连接。
安装步骤
- 设置主机名和更新hosts文件：在每个节点上设置主机名，并在
/etc/hosts 文件中添加节点IP和主机名的映射。
- 关闭交换分区：禁用swap分区以确保kubelet顺利运行。
- 配置防火墙：允许必要的端口，例如Kubernetes API服务器的端口6443。
- 安装containerd：在所有节点上安装containerd运行时，并配置必要的内核参数。
- 添加Kubernetes apt仓库：添加Kubernetes官方的apt仓库，以便安装Kubernetes软件包。
- 安装Kubernetes工具：安装kubelet、kubeadm和kubectl。
- 初始化Kubernetes集群：在主节点上使用
kubeadm init 命令初始化集群。
- 加入工作节点：在每个工作节点上使用
kubeadm join 命令加入集群。
- 配置网络插件：安装并配置网络插件，例如Calico。
- 验证集群：使用
kubectl 命令验证集群状态。
常见问题及解决方法
- 时区不一致问题：指定TZ环境变量或在Dockerfile里设置时区。
- 服务访问失败：证书问题或端口映射错误。检查证书是否正确安装，并确保端口映射正确。
- 网络故障：检查网络连接和iptables配置。
- 文件系统问题：检查和修复文件系统。
- Kubernetes集群初始化失败：环境配置错误。确保关闭swap、防火墙，并正确配置sysctl参数和内核参数。
故障排查
- 审视集群状态：使用
kubectl get nodes 命令检查节点状态。
- 追踪事件日志：使用
kubectl get events 命令查看事件日志。
- 聚焦Pod状态：使用
kubectl get pods --all-namespaces 命令获取集群中所有Pod的状态。
- 检查网络连通性：确保网络连接正常。
- 审视存储配置：如果应用程序使用持久性存储，确保存储配置正确。
- 研究容器日志：使用
kubectl logs 命令查看特定Pod中容器的日志输出。
- 使用kubectl debug进行调试：在运行中的Pod中启动一个新的容器进行调试。
如果在安装过程中遇到其他问题，可以参考Kubernetes官方文档或相关社区资源进行排查和解决。
