From e7e5f0c912a7cc504703e087178a39a2a645c8ea Mon Sep 17 00:00:00 2001 From: Terry Moschou Date: Wed, 10 Mar 2021 15:45:33 +1030 Subject: [PATCH] Remove some tabs on container-runtimes.md docs This simplifies the containerd installation instructions. All Linux distros will now download from Docker repos, including Ubuntu 18.04 which previously installed from Ubuntu repos. The Docker runtime instructions have also been simplified. The RHEL/CentOS specific option overlay2.override_kernel_check=true option has been removed. It seems Docker will now autodetect overlay2 support on older Linux kernels <4.0.0,>=3.10.0-514, which have back-ported overlay2 support on RHEL/CentOS 7.4+ See moby/moby#34368 --- .../container-runtimes.md | 180 ++---------------- 1 file changed, 15 insertions(+), 165 deletions(-) diff --git a/content/en/docs/setup/production-environment/container-runtimes.md b/content/en/docs/setup/production-environment/container-runtimes.md index a59ebbddaf..15f3e3a9b6 100644 --- a/content/en/docs/setup/production-environment/container-runtimes.md +++ b/content/en/docs/setup/production-environment/container-runtimes.md @@ -92,37 +92,9 @@ sudo sysctl --system Install containerd: {{< tabs name="tab-cri-containerd-installation" >}} -{{% tab name="Ubuntu 16.04" %}} +{{% tab name="Linux" %}} -1. Setup the [Docker Engine repository for Ubuntu](https://docs.docker.com/engine/install/ubuntu/#set-up-the-repository) - -2. Install containerd: - - ```shell - sudo apt-get update && sudo apt-get install -y containerd.io - ``` - -3. Configure containerd: - - ```shell - sudo mkdir -p /etc/containerd - containerd config default | sudo tee /etc/containerd/config.toml - ``` - -4. Restart containerd: - - ```shell - sudo systemctl restart containerd - ``` - -{{% /tab %}} -{{% tab name="Ubuntu 18.04/20.04" %}} - -1. Install containerd: - - ```shell - sudo apt-get update && sudo apt-get install -y containerd - ``` +1. Install the `containerd.io` package from the official Docker repositories. Instructions for setting up the Docker repository for your respective Linux distribution and installing the `containerd.io` package can be found at [Install Docker Engine](https://docs.docker.com/engine/install/#server). 2. Configure containerd: @@ -137,60 +109,10 @@ Install containerd: sudo systemctl restart containerd ``` -{{% /tab %}} -{{% tab name="Debian 9+" %}} - -1. Setup the [Docker Engine repository for Debian](https://docs.docker.com/engine/install/debian/#set-up-the-repository) - -2. Install containerd: - - ```shell - sudo apt-get update && sudo apt-get install -y containerd.io - ``` - -3. Configure containerd: - - ```shell - sudo mkdir -p /etc/containerd - containerd config default | sudo tee /etc/containerd/config.toml - ``` - -4. Restart containerd: - - ```shell - sudo systemctl restart containerd - ``` - -{{% /tab %}} -{{% tab name="CentOS/RHEL 7.4+" %}} - -1. Setup the [Docker Engine repository for CentOS/RHEL](https://docs.docker.com/engine/install/centos/#set-up-the-repository) - -2. Install containerd: - - ```shell - sudo yum update -y && sudo yum install -y containerd.io - ``` - -3. Configure containerd: - - ```shell - sudo mkdir -p /etc/containerd - containerd config default | sudo tee /etc/containerd/config.toml - ``` - -4. Restart containerd: - - ```shell - sudo systemctl restart containerd - ``` - {{% /tab %}} {{% tab name="Windows (PowerShell)" %}} -
Start a Powershell session, set `$Version` to the desired version (ex: `$Version=1.4.3`), and then run the following commands: -
1. Download containerd: @@ -425,28 +347,9 @@ in sync. ### Docker -On each of your nodes, install Docker CE. +1. On each of your nodes, install the Docker for your Linux distribution as per [Install Docker Engine](https://docs.docker.com/engine/install/#server) -The Kubernetes release notes list which versions of Docker are compatible -with that version of Kubernetes. - -Use the following commands to install Docker on your system: - -{{< tabs name="tab-cri-docker-installation" >}} -{{% tab name="Ubuntu 16.04+" %}} - -1. Setup the [Docker Engine repository for Ubuntu](https://docs.docker.com/engine/install/ubuntu/#set-up-the-repository) - -2. Install Docker CE: - - ```shell - sudo apt-get update && sudo apt-get install -y \ - containerd.io=1.2.13-2 \ - docker-ce=5:19.03.11~3-0~ubuntu-$(lsb_release -cs) \ - docker-ce-cli=5:19.03.11~3-0~ubuntu-$(lsb_release -cs) - ``` - -3. Set up the Docker daemon: +2. Configure the Docker daemon, in particular to use systemd for the management of the container’s cgroups. ```shell sudo mkdir /etc/docker @@ -462,73 +365,20 @@ Use the following commands to install Docker on your system: EOF ``` -4. Create `/etc/systemd/system/docker.service.d`: - - ```shell - sudo mkdir -p /etc/systemd/system/docker.service.d - ``` - -5. Restart Docker: + {{< note >}} + `overlay2` is the preferred storage driver for systems running Linux kernel version 4.0 or higher, or RHEL or CentOS using version 3.10.0-514 and above. + {{< /note >}} + +3. Restart Docker and enable on boot: ```shell + sudo systemctl enable docker sudo systemctl daemon-reload sudo systemctl restart docker ``` -{{% /tab %}} -{{% tab name="CentOS/RHEL 7.4+" %}} - -1. Setup the [Docker Engine repository for CentOS/RHEL](https://docs.docker.com/engine/install/centos/#set-up-the-repository) - -2. Install Docker CE: - - ```shell - sudo yum update -y && sudo yum install -y \ - containerd.io-1.2.13 \ - docker-ce-19.03.11 \ - docker-ce-cli-19.03.11 - ``` - -3. Set up the Docker daemon: - - ```shell - sudo mkdir /etc/docker - cat <}} - -If you want the `docker` service to start on boot, run the following command: - -```shell -sudo systemctl enable docker -``` - -Refer to the [official Docker installation guides](https://docs.docker.com/engine/installation/) -for more information. +{{< note >}} +For more information refer to + - [Configure the Docker daemon](https://docs.docker.com/config/daemon/) + - [Control Docker with systemd](https://docs.docker.com/config/daemon/systemd/) +{{< /note >}}