在Debian系统上安装Kubernetes(K8s)集群是一个相对复杂的过程,需要仔细规划和执行多个步骤。以下是一个详细的安装指南,基于Debian 12(Bookworm)版本。
在每个节点上设置主机名,并在 /etc/hosts
文件中添加节点IP和主机名的映射。
sudo hostnamectl set-hostname "k8s-master01.test.local"
echo "192.168.16.20 k8s-master01.test.local k8s-master01" | sudo tee -a /etc/hosts
echo "192.168.16.21 k8s-worker01.test.local k8s-worker01" | sudo tee -a /etc/hosts
echo "192.168.16.22 k8s-worker02.test.local k8s-worker02" | sudo tee -a /etc/hosts
禁用swap分区以确保kubelet顺利运行。
sudo swapoff -a
sudo sed -i '/ swap / s/1/g' /etc/fstab
如果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 apt update
sudo apt install -y apt-transport-https ca-certificates curl
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
echo "deb [archamd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update
sudo apt install -y containerd
sudo systemctl enable --now containerd
sudo systemctl start containerd
添加Kubernetes的APT仓库并安装kubelet、kubeadm和kubectl。
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt update
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
在主节点上初始化集群。
sudo kubeadm init --pod-network-cidr 192.168.0.0/16 --service-cidr 10.96.0.0/12
在主节点上配置kubectl以访问集群。
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
使用Calico设置Pod网络。
kubectl apply -f https://docs.projectcalico.org/manifests/tigera-operator.yaml
kubectl apply -f https://docs.projectcalico.org/manifests/custom-resources.yaml
在每个工作节点上,使用主节点初始化期间获取的命令将它们加入集群。
sudo kubeadm join 192.168.16.20:6443 --token abcdef.0123456789abcdef --discovery-token-ca-cert-hash sha256:186e7256966f0e2b3485a3b3ab15a0f1357195745e3d2fa6e9f386cfc24ecc5d
在主节点上运行以下命令以检查集群组件的状态。
kubectl cluster-info
kubectl get nodes
通过以上步骤,你应该能够在Debian上成功搭建一个Kubernetes集群。如果在安装过程中遇到问题,请参考官方文档或相关社区资源。