<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.9 </button>

- [Latest version](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/latest/concepts/using-containerd)
- [Version 1.16](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/1.16/concepts/using-containerd)
- [Earlier versions (unsupported)](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/latest/version-history#expandable-1)

<br />

The [container runtime](https://kubernetes.io/docs/setup/production-environment/container-runtimes/)
is software that is responsible for managing containers and container images on a Kubernetes node. [Containerd](https://containerd.io/) is a [CNCF (Cloud Native Cloud Foundation) graduated](https://www.cncf.io/announcements/2019/02/28/cncf-announces-containerd-graduation/) container runtime. It supports Kubernetes natively, and is considered more resource efficient and secure than the Docker Engine for Kubernetes. Until Kubernetes 1.20, [Docker Engine](https://docs.docker.com/engine/) was the primary container runtime. However, Dockershim, the Docker Engine integration code in Kubernetes, was deprecated in Kubernetes 1.20, and will be removed in Kubernetes 1.24. Thus, Google Distributed Cloud users should plan to use containerd for their container runtime as soon as possible.

## Support for Containerd in Google Distributed Cloud admin cluster nodes

In Google Distributed Cloud 1.8, the admin cluster uses containerd on all nodes: the admin master node, admin addon nodes and user master nodes. This applies to both new admin clusters and existing admin clusters upgraded from 1.7.x.

## Support for Containerd in Google Distributed Cloud user cluster nodes

Google Distributed Cloud 1.8 introduces a new `ubuntu_containerd` OS image type. The `ubuntu_containerd` OS image type uses the identical OS image as `ubuntu`, but the node is configured to use `containerd` as the container runtime instead of Docker Engine.

In version 1.8, the `ubuntu_containerd` OS image type is used for a new node pool by default if `osImageType` if not specified. However, if you upgrade an existing node pool from v1.7.x, the node pools will continue to use the Docker Engine after the upgrade.

If you want to continue using the Docker Engine for a new node pool, starting with version 1.8, you must explicitly specify `ubuntu` as the `osImageType`. As Docker Engine support will be removed in Kubernetes 1.24, you should plan to convert your node pools to use the `ubuntu_containerd` OS image type.

## Update osImageType used by a node pool

See [Update the osImageType of a node pool](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/1.9/how-to/managing-node-pools#update_the_osimagetype_used_by_a_node_pool).

## Migration from Docker Engine to containerd

These resources provide general information about migrating from Docker Engine to containerd.

- [Migrating from the Docker runtime to the Containerd runtime](https://cloud.google.com/kubernetes-engine/docs/concepts/using-containerd#migrating)

- [Running Docker commands on Containerd nodes](https://cloud.google.com/kubernetes-engine/docs/concepts/using-containerd#running_docker_commands_on_containerd_nodes)

### Checking the node image type

You can check which image type is used for existing nodes.

To check with kubectl:

```
kubectl get nodes -o wide --kubeconfig ADMIN_CLUSTER_KUBECONFIG
```

where:

- <var translate="no">ADMIN_CLUSTER_KUBECONFIG</var> is the path of the kubeconfig file for your admin cluster.

The output is similar to the following:

```
NAME ...  OS-IMAGE ...         CONTAINER-RUNTIME
node-1    Ubuntu 18.04.5 LTS   containerd://1.4.3
node-2    Ubuntu 18.04.5 LTS   containerd://1.4.3
node-3    Ubuntu 18.04.5 LTS   containerd://1.4.3
```

The column `CONTAINER-RUNTIME` outputs the runtime and its version.

To check within the node, run:

```
sudo crictl version
```

The output is similar to the following:

```
Version:  0.1.0
RuntimeName:  containerd
RuntimeVersion:  1.4.3-0ubuntu0~18.04.1
RuntimeApiVersion:  v1alpha2
```