{"id":16470,"date":"2021-06-22T07:02:04","date_gmt":"2021-06-22T05:02:04","guid":{"rendered":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/"},"modified":"2021-06-22T07:02:04","modified_gmt":"2021-06-22T05:02:04","slug":"kubernetes-from-docker-to-containerd","status":"publish","type":"post","link":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/","title":{"rendered":"Kubernetes : from Docker to containerd"},"content":{"rendered":"

Kubernetes is very popular and well-known open-source orchestration platform for containers. Very dynamic ecosystem, the release cycle is also very fast.
\nSix months passed since the K8s team announced the dockershim will be deprecated and the 1.22 release deadline is approaching.
\nAs they informed in their quite detailed post in early Dec. 2020, Docker support will be removed in 1.22 :\u00a0https:\/\/kubernetes.io\/blog\/2020\/12\/02\/dont-panic-kubernetes-and-docker\/<\/a>
\nWe are here today in order to see how we can migrate, with minimal overhead, a Kubernetes cluster setup to use Docker as container runtime into a up-to-date cluster using containerd instead, and ready for future releases.<\/p>\n

From Docker to containerd migration<\/h3>\n

This cluster is setup on latest Ubuntu LTS release, 20.04.2, but steps described here are easily adaptable to other Linux flavors, like RedHat or CentOS.<\/p>\n

\"\"<\/a><\/p>\n

We are going to proceed first with the workers and then the master.<\/p>\n

Let’s drain the worker1.<\/p>\n

\"\"<\/a><\/p>\n

Move to worker1 now.
\nWhen you installed Docker on your nodes, containerd was installed too.
\nTo confirm that statement, you can try to check the containerd service status.<\/p>\n

\"\"<\/a><\/p>\n

Before doing any activity, stop kubelet :<\/p>\n

\"\"<\/a><\/p>\n

When installed through Docker, containerd got its CRI plugin disabled.
\nUpdate its config file accordingly which sits in \/etc\/containerd\/config.toml and comment the line containing disabled_plugins = [“cri”]<\/p>\n

\"\"<\/a><\/p>\n

Once the configuration is updated, restart the containerd service.<\/p>\n

\"\"<\/a><\/p>\n

Now it’s time to update kubelet to tell him to use containerd as CRI runtime instead of Docker. For that purpose, two arguments were implemented.
\nWhen you navigate to the kubelet reference page on the official website, you’ll get a better overview : https:\/\/kubernetes.io\/docs\/reference\/command-line-tools-reference\/kubelet<\/a><\/p>\n

\"\"<\/a><\/p>\n

We would need to update both (note kubelet defaulting to Docker !)<\/p>\n

New arguments values would be for containerd :
\n--container-runtime=remote --container-runtime-endpoint=unix:\/\/\/run\/containerd\/containerd.sock<\/code><\/p>\n

Those arguments are defined the kubelet drop-in file for systemd. Open the \/etc\/systemd\/system\/kubelet.service.d\/10-kubeadm.conf
\nCheck the content. On default installations, the KUBELET_EXTRA_ARGS is not defined, you would need to add it as a new line in the file. Your updated configuration file should be similar to the following :<\/p>\n

\"\"<\/a><\/p>\n

Inform systemd we’ve updated the configuration and restart the kubelet.<\/p>\n

\"\"<\/a>If the systemctl daemon-reload is not performed, you’ll be warned by the system:<\/p>\n

\"\"<\/a><\/p>\n

To summarize : we’ve updated containerd to be ready to be used as CRI runtime, we’ve told kubelet to use containerd instead of Docker. Time is now to switch back to the master, check if things have changed and move on !<\/p>\n

\"\"<\/a><\/p>\n

Surprise ! Well, not a suprise because we expected this : Kubernetes is reporting now that our worker1 node is running on containerd instead of Docker. Pay attention to the last column.<\/p>\n

We are ready now to bring back the worker1 into the cluster. For that, you need to uncordon :<\/p>\n

\"\"<\/a><\/p>\n

Repeat this with worker2, and then master, and you’ll be ready.<\/p>\n

Our cluster is fully operational, using containerd :<\/p>\n

\"\"<\/a><\/p>\n

Leaving Docker installed ?<\/h3>\n

Note that with the activities we performed here, we left Docker installed on each nodes. containerd was installed as a part of the installation of Docker.
\nIf you plan to remove Docker completely, you would need to install containerd as a standalone package. This can be done using package through the standard Docker repository.
\nAnother solution is to download containerd binaries from the official website: https:\/\/containerd.io\/downloads\/<\/a>
\nIn that case, you may need to generate the containerd config file using the command:
\ncontainerd config default > \/etc\/containerd\/config.toml<\/code><\/p>\n

The ctr command<\/h3>\n

Now we don’t use anymore docker, the docker cli command won’t list any container. By using containerd, we can now use the ctr command, the containerd cli tool used to interact with containerd.
\nLike with docker, with the ctr command, you can list \/ create \/ delete containers, import \/ export \/ pull images, and many more.<\/p>\n

\"\"<\/a>Note the namespace terminology here. Namespaces in containerd are not the same namespaces used in Kubernetes.<\/p>\n

With ctr, you can also list pulled images:<\/p>\n

\"\"<\/a><\/p>\n

 <\/p>\n

By migrating your cluster away from docker, you’ll be protected against the deprecation of one of the core component, scheduled in the upcoming release.
\nBut containerd also provide additional flexibility.
\nIn a second episode, we will learn how to setup Kubernetes to use containerd, with not only runC as OCI runtime but also KataContainers.
\nStay connected !<\/p>\n","protected":false},"excerpt":{"rendered":"

Kubernetes is very popular and well-known open-source orchestration platform for containers. Very dynamic ecosystem, the release cycle is also very fast. Six months passed since the K8s team announced the dockershim will be deprecated and the 1.22 release deadline is approaching. As they informed in their quite detailed post in early Dec. 2020, Docker support […]<\/p>\n","protected":false},"author":109,"featured_media":16471,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1320,1522],"tags":[],"type_dbi":[],"class_list":["post-16470","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops","category-kubernetes"],"acf":[],"yoast_head":"\nKubernetes : from Docker to containerd - dbi Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Kubernetes : from Docker to containerd\" \/>\n<meta property=\"og:description\" content=\"Kubernetes is very popular and well-known open-source orchestration platform for containers. Very dynamic ecosystem, the release cycle is also very fast. Six months passed since the K8s team announced the dockershim will be deprecated and the 1.22 release deadline is approaching. As they informed in their quite detailed post in early Dec. 2020, Docker support […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/\" \/>\n<meta property=\"og:site_name\" content=\"dbi Blog\" \/>\n<meta property=\"article:published_time\" content=\"2021-06-22T05:02:04+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1057\" \/>\n\t<meta property=\"og:image:height\" content=\"75\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"DevOps\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"DevOps\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/\"},\"author\":{\"name\":\"DevOps\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/4cd1b5f8a3de93f05a16ab8d7d2b7735\"},\"headline\":\"Kubernetes : from Docker to containerd\",\"datePublished\":\"2021-06-22T05:02:04+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/\"},\"wordCount\":711,\"commentCount\":0,\"image\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png\",\"articleSection\":[\"DevOps\",\"Kubernetes\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/\",\"name\":\"Kubernetes : from Docker to containerd - dbi Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png\",\"datePublished\":\"2021-06-22T05:02:04+00:00\",\"author\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/4cd1b5f8a3de93f05a16ab8d7d2b7735\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png\",\"contentUrl\":\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png\",\"width\":1057,\"height\":75},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\/\/www.dbi-services.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Kubernetes : from Docker to containerd\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/\",\"name\":\"dbi Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/4cd1b5f8a3de93f05a16ab8d7d2b7735\",\"name\":\"DevOps\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/cdd2dd7441774355062c0f0f68612296b059cd1e2ff6c7af0b15dba0ed64a85f?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/cdd2dd7441774355062c0f0f68612296b059cd1e2ff6c7af0b15dba0ed64a85f?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/cdd2dd7441774355062c0f0f68612296b059cd1e2ff6c7af0b15dba0ed64a85f?s=96&d=mm&r=g\",\"caption\":\"DevOps\"},\"url\":\"https:\/\/www.dbi-services.com\/blog\/author\/devops\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Kubernetes : from Docker to containerd - dbi Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/","og_locale":"en_US","og_type":"article","og_title":"Kubernetes : from Docker to containerd","og_description":"Kubernetes is very popular and well-known open-source orchestration platform for containers. Very dynamic ecosystem, the release cycle is also very fast. Six months passed since the K8s team announced the dockershim will be deprecated and the 1.22 release deadline is approaching. As they informed in their quite detailed post in early Dec. 2020, Docker support […]","og_url":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/","og_site_name":"dbi Blog","article_published_time":"2021-06-22T05:02:04+00:00","og_image":[{"width":1057,"height":75,"url":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png","type":"image\/png"}],"author":"DevOps","twitter_card":"summary_large_image","twitter_misc":{"Written by":"DevOps","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#article","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/"},"author":{"name":"DevOps","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/4cd1b5f8a3de93f05a16ab8d7d2b7735"},"headline":"Kubernetes : from Docker to containerd","datePublished":"2021-06-22T05:02:04+00:00","mainEntityOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/"},"wordCount":711,"commentCount":0,"image":{"@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage"},"thumbnailUrl":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png","articleSection":["DevOps","Kubernetes"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/","url":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/","name":"Kubernetes : from Docker to containerd - dbi Blog","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage"},"image":{"@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage"},"thumbnailUrl":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png","datePublished":"2021-06-22T05:02:04+00:00","author":{"@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/4cd1b5f8a3de93f05a16ab8d7d2b7735"},"breadcrumb":{"@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#primaryimage","url":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png","contentUrl":"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/04\/Docker_containerd_cluster_initial-1.png","width":1057,"height":75},{"@type":"BreadcrumbList","@id":"https:\/\/www.dbi-services.com\/blog\/kubernetes-from-docker-to-containerd\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.dbi-services.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Kubernetes : from Docker to containerd"}]},{"@type":"WebSite","@id":"https:\/\/www.dbi-services.com\/blog\/#website","url":"https:\/\/www.dbi-services.com\/blog\/","name":"dbi Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/4cd1b5f8a3de93f05a16ab8d7d2b7735","name":"DevOps","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/cdd2dd7441774355062c0f0f68612296b059cd1e2ff6c7af0b15dba0ed64a85f?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/cdd2dd7441774355062c0f0f68612296b059cd1e2ff6c7af0b15dba0ed64a85f?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/cdd2dd7441774355062c0f0f68612296b059cd1e2ff6c7af0b15dba0ed64a85f?s=96&d=mm&r=g","caption":"DevOps"},"url":"https:\/\/www.dbi-services.com\/blog\/author\/devops\/"}]}},"_links":{"self":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/16470","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/users\/109"}],"replies":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/comments?post=16470"}],"version-history":[{"count":0,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/16470\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/media\/16471"}],"wp:attachment":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/media?parent=16470"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/categories?post=16470"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/tags?post=16470"},{"taxonomy":"type","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/type_dbi?post=16470"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}