XTesting/kubespray/docs/containerd.md

   1 # containerd
   2
   3 [containerd] An industry-standard container runtime with an emphasis on simplicity, robustness and portability
   4 Kubespray supports basic functionality for using containerd as the default container runtime in a cluster.
   5
   6 _To use the containerd container runtime set the following variables:_
   7
   8 ## k8s_cluster.yml
   9
  10 When kube_node contains etcd, you define your etcd cluster to be as well schedulable for Kubernetes workloads. Thus containerd and dockerd can not run at same time, must be set to bellow for running etcd cluster with only containerd.
  11
  12 ```yaml
  13 container_manager: containerd
  14 ```
  15
  16 ## etcd.yml
  17
  18 ```yaml
  19 etcd_deployment_type: host
  20 ```
  21
  22 ## Containerd config
  23
  24 Example: define registry mirror for docker hub
  25
  26 ```yaml
  27 containerd_registries:
  28   "docker.io":
  29     - "https://mirror.gcr.io"
  30     - "https://registry-1.docker.io"
  31 ```
  32
  33 `containerd_registries` is ignored for pulling images when `image_command_tool=nerdctl`
  34 (the default for `container_manager=containerd`). Use `crictl` instead, it supports
  35 `containerd_registries` but lacks proper multi-arch support (see
  36 [#8375](https://github.com/kubernetes-sigs/kubespray/issues/8375)):
  37
  38 ```yaml
  39 image_command_tool: crictl
  40 ```
  41
  42 [containerd]: https://containerd.io/