Debian与Kubernetes集成解决方案
Debian作为轻量、稳定的Linux发行版,是部署Kubernetes集群的常见基础环境。以下是针对Debian(推荐12及以上版本)与Kubernetes集成的详细步骤及关键注意事项,覆盖从环境准备到集群管理的全流程。
sudo swapoff -a # 临时关闭
sudo sed -i '/ swap / s/1/g' /etc/fstab # 注释/etc/fstab中的Swap行
echo "overlay\nbr_netfilter" | sudo tee /etc/modules-load.d/containerd.conf # 加载模块
sudo modprobe overlay && sudo modprobe br_netfilter # 立即生效
echo "net.bridge.bridge-nf-call-iptables = 1\nnet.ipv4.ip_forward = 1" | sudo tee /etc/sysctl.d/99-kubernetes.conf # 配置转发
sudo sysctl --system # 应用参数
systemd-timesyncd
)并启用,避免节点时间偏差导致集群异常:sudo apt install -y systemd-timesyncd
sudo systemctl enable --now systemd-timesyncd
Kubernetes从1.24版本起弃用Docker,推荐使用containerd(原生支持Kubernetes CRI接口)。安装步骤如下:
sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
echo "deb [arch=amd64] 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.io # 仅安装containerd,无需Docker
sudo mkdir -p /etc/containerd
sudo containerd config default | sudo tee /etc/containerd/config.toml # 生成默认配置
sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml # 启用Systemd cgroup
sudo systemctl restart containerd && sudo systemctl enable containerd # 启动服务
Kubernetes官方提供了Debian的软件源,需通过以下命令添加:
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
安装kubelet
(节点代理)、kubeadm
(集群初始化工具)、kubectl
(命令行客户端),并通过apt-mark hold
锁定版本(避免自动升级破坏集群稳定性):
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
在Master节点上执行kubeadm init
命令初始化集群,指定Pod网络CIDR(需与后续网络插件兼容,如Flannel默认10.244.0.0/16
):
sudo kubeadm init --pod-network-cidr=10.244.0.0/16
初始化完成后,会输出Worker节点加入集群的命令(包含Token和证书哈希),需妥善保存。
将Master节点的Kubernetes配置文件复制到当前用户的.kube
目录,用于管理集群:
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
Kubernetes需要网络插件实现Pod间通信,常用Flannel(轻量、易部署)或Calico(高性能、支持网络策略)。以Flannel为例:
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml
部署完成后,通过kubectl get pods -n kube-system
验证网络插件状态(所有Pod应为Running
)。
在每台Worker节点上,使用Master节点初始化时输出的kubeadm join命令加入集群(示例):
sudo kubeadm join 192.168.1.100:6443 --token abcdef.1234567890abcdef \
--discovery-token-ca-cert-hash sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
kubectl get nodes
,确认所有节点状态为Ready
;kubectl create deployment nginx --image=nginx --replicas=2
kubectl expose deployment nginx --type=NodePort --port=80
kubectl get svc nginx # 查看NodePort端口(如30080)
访问任意节点的<NodeIP>:<NodePort>
,若出现Nginx欢迎页面,则说明集群部署成功。etcdctl snapshot save
命令;