当前位置：首页 > news >正文

Debian 13 安装 Kubernetes 最新版并使用 containerd 运行时

news 2025/11/9 8:27:16

基于 Debian 13（代号 “Trixie”）虚拟机环境，搭建一个单 Master + 单 Worker 的 Kubernetes 集群，使用 containerd 作为容器运行时，并采用 kubeadm 工具部署 Kubernetes v1.34.1

环境准备

虚拟机配置（两台）
Master 节点：k8s-master
Worker 节点：k8s-worker
操作系统：Debian 13（最小安装）
用户：具有 sudo 权限
网络：互通，可访问互联网

步骤概览

系统初始化（所有节点）
安装 containerd（所有节点）
安装 kubeadm、kubelet、kubectl（所有节点）
crictl pull 镜像加速
保存快照，克隆出 worker
初始化 Master 节点
安装 CNI 插件（Calico）
Worker 节点加入集群
验证集群状态

详细步骤

第一步：系统初始化（所有节点）

1. 配置静态IP地址（分别设置）

先设置 master, 等 worker 克隆出来再做修改

# 编辑网络配置
sudo vim /etc/network/interfaces# 内容如下
allow-hotplug ens33
#iface ens33 inet dhcp
iface ens33 inet staticaddress 192.168.2.20/24gateway 192.168.2.1dns-nameservers 8.8.8.8 8.8.4.4# 重启网络服务
sudo systemctl restart networking

2 设置主机名（分别设置）

先设置 master, 等 worker 克隆出来再做修改

# 2 设置主机名
# master 节点：
sudo hostnamectl set-hostname k8s-master

3 配置 hosts（两台都加）

# 3 配置 hosts
cat <<EOF | sudo tee -a /etc/hosts
192.168.2.20 k8s-master
192.168.2.21 k8s-worker1
EOF

4. 关闭 swap

# 4 关闭 swap
sudo swapoff -a
# 永久关闭：注释 /etc/fstab 中的 swap 行
sudo sed -i '/^UUID.* swap / s/^\(.*\)$/#\1/g' /etc/fstab

5 启用内核模块 & 调整 sysctl

# 5 启用内核模块 & 调整 sysctl
# 模块配置
cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf
overlay
br_netfilter
EOF
# 加载模块
sudo modprobe overlay
sudo modprobe br_netfilter
# 内核信息
cat <<EOF | sudo tee /etc/sysctl.d/k8s.conf
net.bridge.bridge-nf-call-iptables  = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward                 = 1