【Kubernetes】K8s 1.35 配置 Docker 作为容器运行时-深圳市維司達科技有限公司

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-release

1.2、关闭防火墙

若有防火墙需要关闭

1.3、关闭 swap 分区

# 查看 swap 分区是否存在 free -h # 关闭当前会话的 swap，重启后无效 swapoff -a # 永久关闭 swap ，需重启 sed -ri 's/.*swap.*/#&/' /etc/fstab # 查看 swap 分区已关闭 free -h

1.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 --system

1.5、安装必要工具

# 安装必要工具 apt install -y apt-transport-https ca-certificates curl gnupg lsb-release

2、安装 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 version

3、安装 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.socket

4、安装 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 kubectl

4.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 kubelet

4.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.sock

4.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.conf

4.5、部署 Calico 网络插件

# 安装 Calico kubectl apply -f https://raw.githubusercontent.com/projectcalico/calico/v3.30.3/manifests/calico.yaml

4.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-