在Debian环境下安装Kubernetes(K8S)集群是一个相对复杂的过程,需要仔细规划和执行多个步骤。以下是一个详细的安装指南,基于Debian 12(Bookworm)版本。
硬件和环境要求
- CPU:至少2核
- 内存:至少2GB RAM
- 硬盘空间:至少20GB可用空间
- 网络:稳定的互联网连接,确保所有节点之间可以互相通信
安装步骤
1. 设置主机名和更新hosts文件
在每个节点上设置主机名,并在/etc/hosts
文件中添加相应的条目。
sudo hostnamectl set-hostname "k8s-master01.test.local" # 在第一个工作节点运行 sudo hostnamectl set-hostname "k8s-worker01.test.local" # 在第二个工作节点运行 sudo hostnamectl set-hostname "k8s-worker02.test.local" # 在所有节点的 /etc/hosts 文件中添加以下条目: 192.168.16.20 k8s-master01.test.local k8s-master01 192.168.16.21 k8s-worker01.test.local k8s-worker01 192.168.16.22 k8s-worker02.test.local k8s-worker02
2. 关闭所有节点的swap分区
为了让kubelet顺利运行,建议禁用swap。
sudo swapoff -a sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab
3. 为k8s集群添加防火墙规则
如果你的Debian系统已启用操作系统防火墙,请在主控节点和工作节点上分别允许以下端口。
# 在主控节点上运行 sudo ufw allow 6443/tcp sudo ufw allow 2379/tcp sudo ufw allow 2380/tcp sudo ufw allow 10250/tcp sudo ufw allow 10251/tcp sudo ufw allow 10252/tcp sudo ufw allow 10255/tcp sudo ufw reload # 在工作节点上运行 sudo ufw allow 10250/tcp sudo ufw allow 30000:32767/tcp sudo ufw reload
4. 在所有节点上安装containerd运行时
containerd是Kubernetes支持的行业标准容器运行时。
# 设置内核参数 cat <5. 安装Kubernetes工具
在所有节点上安装kubeadm、kubelet和kubectl。
# 添加Kubernetes apt仓库 curl https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | sudo apt-key add - cat <6. 初始化主控节点
在主控节点上运行以下命令初始化集群。
sudo kubeadm init --pod-network-cidr=10.244.0.0/167. 安装网络插件(例如Calico)
使用Calico设置Pod网络。
kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml8. 加入工作节点
在工作节点上运行以下命令加入集群。
sudo kubeadm join 192.168.16.20:6443 --token--discovery-token-ca-cert-hash sha256: 验证安装
验证Kubernetes集群是否正常运行。
kubectl get nodes你应该能看到所有节点都处于Ready状态。
注意事项
- 确保所有节点的时区一致,否则可能会导致时间同步问题。
- 在生产环境中,建议使用更稳定的网络配置和防火墙规则。
- 定期更新Kubernetes集群和相关组件以保持安全和稳定性。
通过以上步骤,你应该能够在Debian 12上成功安装和配置一个Kubernetes集群。如果在安装过程中遇到问题,请参考官方文档或相关社区资源。