Kubernetes容器运行时更改

本篇教程将为运行1.23或更早版本Kubernetes集群的操作人员提供将容器运行时从Docker改为containerd的步骤。同时，我们还将提供一个示例场景，涉及从dockershim迁移到containerd的过程。

一、腾空节点

kubectl drain <node-to-drain> --ignore-daemonsets

将 <node-to-drain> 替换为你所要腾空的节点的名称。

二、停止Docker守护进程

systemctl stop kubelet
systemctl disable docker.service --now

三、安装 Containerd

1、Linux：

（1）从官方的 Docker 仓库安装 containerd.io 包。

（2）配置 containerd：

sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml

（3）重启 containerd：

sudo systemctl restart containerd

2、Windows (PowerShell)：

启动一个 Powershell 会话，将 $Version 设置为期望的版本（例如：$Version="1.4.3"）， 之后运行下面的命令：

（1）下载 containerd：

curl.exe -L https://github.com/containerd/containerd/releases/download/v$Version/containerd-$Version-windows-amd64.tar.gz -o containerd-windows-amd64.tar.gz
tar.exe xvf .\containerd-windows-amd64.tar.gz

（2）解压缩并执行配置：

Copy-Item -Path ".\bin\" -Destination "$Env:ProgramFiles\containerd" -Recurse -Force
cd $Env:ProgramFiles\containerd\
.\containerd.exe config default | Out-File config.toml -Encoding ascii
#取决于你的安装环境，你可能需要调整：
# - sandbox_image （Kubernetes pause 镜像）
# - CNI 的 bin_dir 和 conf_dir 的位置
Get-Content config.toml
# （可选步骤，但强烈建议执行）将 containerd 排除在 Windows Defender 扫描之外
Add-MpPreference -ExclusionProcess "$Env:ProgramFiles\containerd\containerd.exe"

（3）启动 containerd：

.\containerd.exe --register-service
Start-Service containerd

四、配置kubelet

配置 kubelet 使用 containerd 作为其容器运行时。编辑文件 /var/lib/kubelet/kubeadm-flags.env，将 containerd 运行时添加到标志中； --container-runtime-endpoint=unix:///run/containerd/containerd.sock。

使用 kubeadm 的用户应该知道，kubeadm 工具将每个主机的 CRI 套接字保存在该主机对应的 Node 对象的注解中。 要更改这一注解信息，你可以在一台包含 kubeadm /etc/kubernetes/admin.conf 文件的机器上执行以下命令：

kubectl edit no <node-name>

这一命令会打开一个文本编辑器，供你在其中编辑 Node 对象。 要选择不同的文本编辑器，你可以设置 KUBE_EDITOR 环境变量。

1、更改 kubeadm.alpha.kubernetes.io/cri-socket 值，将其从 /var/run/dockershim.sock 改为你所选择的 CRI 套接字路径 （例如：unix:///run/containerd/containerd.sock）。注意新的 CRI 套接字路径必须带有 unix:// 前缀。

2、保存文本编辑器中所作的修改，这会更新 Node 对象。

五、重启kubelet

systemctl start kubelet

六、验证节点处于健康状态

运行 kubectl get nodes -o wide，containerd 会显示为我们所更改的节点上的运行时。

七、移除Docker Engine

1、CentOS

sudo yum remove docker-ce docker-ce-cli

2、Debian

sudo apt-get purge docker-ce docker-ce-cli

3、Fedora

sudo dnf remove docker-ce docker-ce-cli

4、Ubuntu

sudo apt-get purge docker-ce docker-ce-cli

上面的命令不会移除你的主机上的镜像、容器、卷或者定制的配置文件。

注意：Docker 所提供的卸载 Docker Engine 命令指导中，存在删除 containerd 的风险。 在执行命令时要谨慎。

八、uncordon节点

kubectl uncordon <node-to-uncordon>

将 <node-to-uncordon> 替换为你之前腾空的节点的名称。