Skip to content

Commit 8b1b8a4

Browse files
updated the container-runtime page to include info about dockershim deprecation.
1 parent fdd2546 commit 8b1b8a4

File tree

1 file changed

+28
-13
lines changed

1 file changed

+28
-13
lines changed

content/en/docs/setup/production-environment/container-runtimes.md

Lines changed: 28 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ what is involved and describes related tasks for setting up nodes.
1616
<!-- body -->
1717

1818
Kubernetes {{< skew currentVersion >}} requires that you use a runtime that
19-
conforms with the
19+
conforms with the
2020
{{< glossary_tooltip term_id="cri" text="Container Runtime Interface">}} (CRI).
2121

2222
See [CRI version support](#cri-versions) for more information.
@@ -29,6 +29,19 @@ Kubernetes, on Linux:
2929
- [Docker Engine](#docker)
3030
- [Mirantis Container Runtime](#mcr)
3131

32+
{{< note >}}
33+
Dockershim, the portion of code in Kubernetes that provided direct
34+
integration with Docker in prior releases, was removed from Kubernetes
35+
version 1.24. This removal was announced as a [deprecation in Kubernetes v 1.20](
36+
/blog/2020/12/08/kubernetes-1-20-release-announcement/#dockershim-deprecation)
37+
You can check out this [documentation](
38+
/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-deprecation-affects-you/)
39+
to understand how this deprecation might affect you. To migrate from
40+
dockershim you can follow [this migration guide](
41+
/docs/tasks/administer-cluster/migrating-from-dockershim/)
42+
to migrate from dockershim.
43+
{{< /note >}}
44+
3245
{{< note >}}
3346
For other operating systems, look for documentation specific to your platform.
3447
{{< /note >}}
@@ -151,10 +164,11 @@ Install containerd:
151164
{{< tabs name="tab-cri-containerd-installation" >}}
152165
{{% tab name="Linux" %}}
153166

154-
1. Install the `containerd.io` package from the official Docker repositories.
155-
Instructions for setting up the Docker repository for your respective Linux distribution and
156-
installing the `containerd.io` package can be found at
157-
[Install Docker Engine](https://docs.docker.com/engine/install/#server).
167+
1. Install the `containerd.io` package from the [official containerd website](
168+
https://containerd.io/downloads/).Instructions for setting up the Docker
169+
repository for your respective Linux distribution and
170+
installing the `containerd.io` package can be found at
171+
[Install Docker Engine](https://docs.docker.com/engine/install/#server).
158172

159173
2. Configure containerd:
160174

@@ -172,7 +186,7 @@ installing the `containerd.io` package can be found at
172186
{{% /tab %}}
173187
{{% tab name="Windows (PowerShell)" %}}
174188

175-
Start a Powershell session, set `$Version` to the desired version (ex: `$Version="1.4.3"`),
189+
Start a Powershell session, set `$Version` to the desired version (ex: `$Version=1.4.3`),
176190
and then run the following commands:
177191

178192
1. Download containerd:
@@ -299,7 +313,7 @@ sudo apt-get install cri-o cri-o-runc
299313

300314
{{% tab name="Ubuntu" %}}
301315

302-
To install on the following operating systems, set the environment variable `OS`
316+
To install on the following operating systems, set the environment variable `OS`
303317
to the appropriate field in the following table:
304318

305319
| Operating system | `$OS` |
@@ -335,7 +349,7 @@ sudo apt-get install cri-o cri-o-runc
335349

336350
{{% tab name="CentOS" %}}
337351

338-
To install on the following operating systems, set the environment variable `OS`
352+
To install on the following operating systems, set the environment variable `OS`
339353
to the appropriate field in the following table:
340354

341355
| Operating system | `$OS` |
@@ -416,10 +430,8 @@ in sync.
416430

417431
### Docker Engine {#docker}
418432

419-
Docker Engine is the container runtime that started it all. Formerly known just as Docker,
420-
this container runtime is available in various forms.
421-
[Install Docker Engine](https://docs.docker.com/engine/install/) explains your options
422-
for installing this runtime.
433+
On each of your nodes, install Docker for your Linux distribution as per
434+
[Install Docker Engine](https://docs.docker.com/engine/install/#server).
423435

424436
Docker Engine is directly compatible with Kubernetes {{< skew currentVersion >}}, using the deprecated `dockershim` component. For more information
425437
and context, see the [Dockershim deprecation FAQ](/dockershim).
@@ -428,7 +440,10 @@ You can also find third-party adapters that let you use Docker Engine with Kuber
428440
through the supported {{< glossary_tooltip term_id="cri" text="Container Runtime Interface">}}
429441
(CRI).
430442

431-
The following CRI adaptors are designed to work with Docker Engine:
443+
{{< note >}}
444+
`overlay2` is the preferred storage driver for systems running Linux kernel version 4.0 or higher,
445+
or RHEL or CentOS using version 3.10.0-514 and above.
446+
{{< /note >}}
432447

433448
- [`cri-dockerd`](https://github.com/Mirantis/cri-dockerd) from Mirantis
434449

0 commit comments

Comments
 (0)