Kubernetes 1.24 移除了对 Docker 的直接支持，并且新版 K8s 主推更轻量的 Containerd，但 Docker 凭借其强大的生态依然是许多人的首选。本文将通过 cri-dockerd 这个 ‘适配器’，让 Kubernetes 中重新用上 Docker！
- 操作系统：Ubuntu 24.04.2 LTS
- Docker：29.1.3
- cri-dockerd：0.3.14.3
- Kubernetes：1.35.0
- 下方仅一个主节点为例（其中主节点 hostname 为 master，可根据实际情况修改）
1、准备工作
1.1、查看操作系统版本
# 查看操作系统版本 cat /etc/os-release1.2、关闭防火墙
- 若有防火墙需要关闭
1.3、关闭 swap 分区
# 查看 swap 分区是否存在 free -h # 关闭当前会话的 swap，重启后无效 swapoff -a # 永久关闭 swap ，需重启 sed -ri 's/.*swap.*/#&/' /etc/fstab # 查看 swap 分区已关闭 free -h1.4、配置内核
# 加载内核模块 modprobe overlay modprobe br_netfilter # 配置 sysctl 参数 cat <<EOF | tee /etc/modules-load.d/k8s.conf overlay br_netfilter EOF cat <<EOF | 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 EOF # 应用配置 sysctl --system1.5、安装必要工具
# 安装必要工具 apt install -y apt-transport-https ca-certificates curl gnupg lsb-release2、安装 Docker
# 信任 Docker 的 GPG 公钥 sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg # 写入软件源信息 echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu \ "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # 安装 docker-ce apt update apt install -y docker-ce docker-ce-cli containerd.io # 创建 Docker 配置文件 mkdir -p /etc/docker # 配置 Docker 使用 systemd 作为 cgroup 驱动 cat <<EOF | sudo tee /etc/docker/daemon.json { "exec-opts": ["native.cgroupdriver=systemd"], "log-driver": "json-file", "log-opts": { "max-size": "100m" }, "storage-driver": "overlay2", "registry-mirrors": [ "https://docker.mirrors.ustc.edu.cn" ] } EOF # 启动 Docker systemctl enable docker systemctl start docker # 验证 Docker 安装 docker version3、安装 cri-dockerd
# 下载 wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.21/cri-dockerd_0.3.21.3-0.ubuntu-jammy_amd64.deb # 安装 dpkg -i cri-dockerd_0.3.21.3-0.ubuntu-jammy_amd64.deb # 新版本的 cri-dockerd 包通常会自动配置好 systemd 服务 systemctl status cri-docker.service # 如果服务未运行或未启用，请手动启动 systemctl daemon-reload systemctl enable cri-docker.service systemctl enable --now cri-docker.socket4、安装 Kubernetes
4.1、配置阿里云仓库进行安装
# 添加 Kubernetes GPG 密钥 curl -fsSL https://mirrors.aliyun.com/kubernetes-new/core/stable/v1.35/deb/Release.key | gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg # 添加 Kubernetes 仓库 echo "deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://mirrors.aliyun.com/kubernetes-new/core/stable/v1.35/deb/ /" | tee /etc/apt/sources.list.d/kubernetes.list # 安装 kubelet、kubeadm、kubectl apt-get update apt-get install -y kubelet kubeadm kubectl # 锁定版本，防止被自动更新破坏 apt-mark hold kubelet kubeadm kubectl4.2、配置 kubelet 使用 cri-dockerd
sudo tee /etc/default/kubelet <<-'EOF' KUBELET_EXTRA_ARGS="--cgroup-driver=systemd --container-runtime-endpoint=unix:///var/run/cri-dockerd.sock" EOF # 重启 kubelet systemctl daemon-reload systemctl restart kubelet4.3、查看/下载所需的镜像
# 查看/下载所需的镜像 kubeadm config images list --kubernetes-version=v1.35.0 --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers # 使用参数 --cri-socket 指定使用 cri-dockerd kubeadm config images pull --kubernetes-version=v1.35.0 --image-repository registry.cn-hangzhou.aliyuncs.com/google_containers --cri-socket unix:///var/run/cri-dockerd.sock4.4、初始化 master
# 初始化集群时配置参数 --cri-socket 指定使用 cri-dockerd kubeadm init --apiserver-advertise-address=172.16.15.105 --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers --kubernetes-version=v1.35.0 --service-cidr=10.96.0.0/16 --pod-network-cidr=10.244.0.0/16 --cri-socket unix:///var/run/cri-dockerd.sock # 根据日志信息提示操作，执行下方命令 mkdir -p $HOME/.kube sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config sudo chown $(id -u):$(id -g) $HOME/.kube/config export KUBECONFIG=/etc/kubernetes/admin.conf4.5、部署 Calico 网络插件
# 安装 Calico kubectl apply -f https://raw.githubusercontent.com/projectcalico/calico/v3.30.3/manifests/calico.yaml4.6、创建测试 pod
# 测试运行 pod kubectl run nginx-pod --image=nginx:latest --port=80 kubectl get pod kubectl describe pod nginx-pod # 报错：0/1 nodes are available: 1 node(s) had untolerated taint(s). no new claims to deallocate, preemption: 0/1 nodes are available: 1 Preemption is not helpful for scheduling. # 原因：当前仅一个 master 节点，需要去掉污点/配置容忍才能调度 # 允许 Master 节点调度 Pod kubectl taint nodes master node-role.kubernetes.io/control-plane-4.7、工作节点
- 工作节点部署同主节点类似，步骤 4.3 及以后无需执行，使用 “kubeadm join xxx” 命令加入主节点即可
- 在 Worker 节点上执行 join 命令，同样需要加上 --cri-socket 参数
)
