将 Docker Engine 节点从 dockershim 迁移到 cri-dockerd

本页介绍如何将您的 Docker Engine 节点迁移到使用cri-dockerd而不是 dockershim。您应该在以下情况下按照这些步骤操作

• 您想从 dockershim 切换，但仍然使用 Docker Engine 在 Kubernetes 中运行容器。
• 您想升级到 Kubernetes v1.31，而您现有的集群依赖于 dockershim，在这种情况下，您必须从 dockershim 迁移，而cri-dockerd是您的选项之一。

要详细了解 dockershim 的删除，请阅读常见问题解答页面.

什么是 cri-dockerd？

在 Kubernetes 1.23 及更早版本中，您可以将 Docker Engine 与 Kubernetes 一起使用，依赖于 Kubernetes 的一个内置组件，名为dockershim。dockershim 组件在 Kubernetes 1.24 版本中被删除；但是，一个第三方替代方案，cri-dockerd，是可用的。cri-dockerd适配器允许您通过容器运行时接口使用 Docker Engine。

如果您想迁移到cri-dockerd以便您可以继续使用 Docker Engine 作为您的容器运行时，您应该对每个受影响的节点执行以下操作

1. 安装cri-dockerd。
2. 隔离和清空节点。
3. 配置 kubelet 以使用cri-dockerd。
4. 重新启动 kubelet。
5. 验证节点是否正常。

首先在非关键节点上测试迁移。

您应该对要迁移到cri-dockerd的每个节点执行以下步骤。

在开始之前

• cri-dockerd已安装并在每个节点上启动。
• 一个网络插件.

隔离和清空节点

1. 隔离节点以停止新的 Pod 在其上调度

   kubectl cordon <NODE_NAME>
   

   用节点的名称替换<NODE_NAME>。

2. 清空节点以安全地驱逐正在运行的 Pod

   kubectl drain <NODE_NAME> \
       --ignore-daemonsets
   

配置 kubelet 以使用 cri-dockerd

以下步骤适用于使用 kubeadm 工具设置的集群。如果您使用其他工具，您应该使用该工具的配置说明修改 kubelet。

1. 打开每个受影响节点上的/var/lib/kubelet/kubeadm-flags.env。
2. 将--container-runtime-endpoint标志修改为unix:///var/run/cri-dockerd.sock。
3. 将--container-runtime标志修改为remote（在 Kubernetes v1.27 及更高版本中不可用）。

kubeadm 工具将节点的套接字存储为控制平面中Node对象的注释。要修改每个受影响节点的此套接字

1. 编辑Node对象的 YAML 表示

   KUBECONFIG=/path/to/admin.conf kubectl edit no <NODE_NAME>
   

   替换以下内容

   • /path/to/admin.conf：kubectl 配置文件admin.conf的路径。
   • <NODE_NAME>：要修改的节点的名称。

2. 将kubeadm.alpha.kubernetes.io/cri-socket从/var/run/dockershim.sock更改为unix:///var/run/cri-dockerd.sock。

3. 保存更改。Node对象在保存时会更新。

重新启动 kubelet

systemctl restart kubelet

验证节点是否正常

要检查节点是否使用cri-dockerd端点，请按照找出您使用的运行时中的说明进行操作。kubelet 的--container-runtime-endpoint标志应为unix:///var/run/cri-dockerd.sock。

取消隔离节点

取消隔离节点以允许 Pod 在其上调度

kubectl uncordon <NODE_NAME>

下一步

• 阅读dockershim 删除常见问题解答.
• 了解如何从使用 dockershim 的 Docker Engine 迁移到 containerd.