Migrating from dockershim

This section presents information you need to know when migrating from dockershim to other container runtimes.

Since the announcement of dockershim deprecation in Kubernetes 1.20, there were questions on how this will affect various workloads and Kubernetes installations. Our Dockershim Removal FAQ is there to help you to understand the problem better.

Dockershim was removed from Kubernetes with the release of v1.24. If you use Docker Engine via dockershim as your container runtime, and wish to upgrade to v1.24, it is recommended that you either migrate to another runtime or find an alternative means to obtain Docker Engine support. Check out container runtimes section to know your options. Make sure to report issues you encountered with the migration. So the issue can be fixed in a timely manner and your cluster would be ready for dockershim removal.

Your cluster might have more than one kind of node, although this is not a common configuration.

These tasks will help you to migrate:

• Check whether Dockershim removal affects you
• Migrate Docker Engine nodes from dockershim to cri-dockerd
• Migrating telemetry and security agents from dockershim

What's next

• Check out container runtimes to understand your options for a container runtime.
• There is a GitHub issue to track discussion about the deprecation and removal of dockershim.
• If you found a defect or other technical concern relating to migrating away from dockershim, you can report an issue to the Kubernetes project.