From c8f9788931542c6729f011ddd7f0d5cf35b0dd03 Mon Sep 17 00:00:00 2001 From: Prabhav Thali Date: Mon, 13 Jan 2025 16:35:13 +0530 Subject: [PATCH] Drop RHEL and SLES support --- content/includes/install-script.md | 2 +- content/manuals/compose/install/linux.md | 3 +- content/manuals/engine/install/_index.md | 3 +- content/manuals/engine/install/rhel.md | 2 +- content/manuals/engine/install/sles.md | 267 ------------------ content/manuals/engine/security/rootless.md | 6 +- .../engine/storage/drivers/btrfs-driver.md | 3 +- .../storage/drivers/device-mapper-driver.md | 4 +- .../storage/drivers/select-storage-driver.md | 1 - 9 files changed, 10 insertions(+), 281 deletions(-) delete mode 100644 content/manuals/engine/install/sles.md diff --git a/content/includes/install-script.md b/content/includes/install-script.md index c273505dbda..e5037aa2412 100644 --- a/content/includes/install-script.md +++ b/content/includes/install-script.md @@ -53,7 +53,7 @@ Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b273 You have now successfully installed and started Docker Engine. The `docker` service starts automatically on Debian based distributions. On `RPM` based -distributions, such as CentOS, Fedora, RHEL or SLES, you need to start it +distributions, such as CentOS, Fedora or RHEL, you need to start it manually using the appropriate `systemctl` or `service` command. As the message indicates, non-root users can't run Docker commands by default. diff --git a/content/manuals/compose/install/linux.md b/content/manuals/compose/install/linux.md index c8d68c2526d..e6edf2a658d 100644 --- a/content/manuals/compose/install/linux.md +++ b/content/manuals/compose/install/linux.md @@ -33,8 +33,7 @@ To install the Docker Compose plugin on Linux, you can either: [Debian](/manuals/engine/install/debian.md#install-using-the-repository) | [Raspberry Pi OS](/manuals/engine/install/raspberry-pi-os.md#install-using-the-repository) | [Fedora](/manuals/engine/install/fedora.md#set-up-the-repository) | - [RHEL](/manuals/engine/install/rhel.md#set-up-the-repository) | - [SLES](/manuals/engine/install/sles.md#set-up-the-repository). + [RHEL](/manuals/engine/install/rhel.md#set-up-the-repository). 2. Update the package index, and install the latest version of Docker Compose: diff --git a/content/manuals/engine/install/_index.md b/content/manuals/engine/install/_index.md index cf03b08c40a..a889016cd00 100644 --- a/content/manuals/engine/install/_index.md +++ b/content/manuals/engine/install/_index.md @@ -46,8 +46,7 @@ see: [Overview of Docker Desktop](/manuals/desktop/_index.md). | [Debian](debian.md) | ✅ | ✅ | ✅ | ✅ | | | [Fedora](fedora.md) | ✅ | ✅ | | ✅ | | | [Raspberry Pi OS (32-bit)](raspberry-pi-os.md) | | | ✅ | | | -| [RHEL](rhel.md) | ✅ | ✅ | | | ✅ | -| [SLES](sles.md) | | | | | ✅ | +| [RHEL](rhel.md) | ✅ | ✅ | | | | | [Ubuntu](ubuntu.md) | ✅ | ✅ | ✅ | ✅ | ✅ | | [Binaries](binaries.md) | ✅ | ✅ | ✅ | | | diff --git a/content/manuals/engine/install/rhel.md b/content/manuals/engine/install/rhel.md index e0678357fc2..c5bffd12277 100644 --- a/content/manuals/engine/install/rhel.md +++ b/content/manuals/engine/install/rhel.md @@ -183,7 +183,7 @@ download a new file each time you want to upgrade Docker Engine. 2. Select your RHEL version in the list. -3. Select the applicable architecture (`x86_64`, `aarch64`, or `s390x`), and +3. Select the applicable architecture (`x86_64` or `aarch64`), and then go to `stable/Packages/`. 4. Download the following `rpm` files for the Docker Engine, CLI, containerd, diff --git a/content/manuals/engine/install/sles.md b/content/manuals/engine/install/sles.md deleted file mode 100644 index b148e60a1b1..00000000000 --- a/content/manuals/engine/install/sles.md +++ /dev/null @@ -1,267 +0,0 @@ ---- -description: Learn how to install Docker Engine on SLES. These instructions cover - the different installation methods, how to uninstall, and next steps. -keywords: requirements, apt, installation, install docker engine, centos, rpm, sles, install, uninstall, - upgrade, update, s390x, ibm-z -title: Install Docker Engine on SLES (s390x) -linkTitle: SLES (s390x) -weight: 70 -toc_max: 4 -aliases: -- /ee/docker-ee/sles/ -- /ee/docker-ee/suse/ -- /engine/installation/linux/docker-ce/sles/ -- /engine/installation/linux/docker-ee/sles/ -- /engine/installation/linux/docker-ee/suse/ -- /engine/installation/linux/sles/ -- /engine/installation/linux/SUSE/ -- /engine/installation/linux/suse/ -- /engine/installation/sles/ -- /engine/installation/SUSE/ -- /install/linux/docker-ce/sles/ -- /install/linux/docker-ee/sles/ -- /install/linux/docker-ee/suse/ -- /install/linux/sles/ -- /installation/sles/ -download-url-base: https://download.docker.com/linux/sles ---- - -> [!NOTE] -> -> The installation instructions on this page refer to packages for SLES on the -> **s390x** architecture (IBM Z). Other architectures, including x86_64, aren't -> supported for SLES. - -To get started with Docker Engine on SLES, make sure you -[meet the prerequisites](#prerequisites), and then follow the -[installation steps](#installation-methods). - -## Prerequisites - -### OS requirements - -To install Docker Engine, you need a maintained version of one of the following -SLES versions: - -- SLES 15-SP4 on s390x (IBM Z) -- SLES 15-SP5 on s390x (IBM Z) - -You must enable the [`SCC SUSE`](https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.5&arch=s390x) -repositories. - -You must add the [OpenSUSE `SELinux` repository](https://download.opensuse.org/repositories/security:/SELinux/). This repository is not added by default. Run the following commands to add it: - -```console -$ opensuse_repo="https://download.opensuse.org/repositories/security:/SELinux/openSUSE_Factory/security:SELinux.repo" -$ sudo zypper addrepo $opensuse_repo -``` - -### Uninstall old versions - -Before you can install Docker Engine, you need to uninstall any conflicting packages. - -Your Linux distribution may provide unofficial Docker packages, which may conflict -with the official packages provided by Docker. You must uninstall these packages -before you install the official version of Docker Engine. - -```console -$ sudo zypper remove docker \ - docker-client \ - docker-client-latest \ - docker-common \ - docker-latest \ - docker-latest-logrotate \ - docker-logrotate \ - docker-engine \ - runc -``` - -`zypper` might report that you have none of these packages installed. - -Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't -automatically removed when you uninstall Docker. - -## Installation methods - -You can install Docker Engine in different ways, depending on your needs: - -- You can - [set up Docker's repositories](#install-using-the-repository) and install - from them, for ease of installation and upgrade tasks. This is the - recommended approach. - -- You can download the RPM package, - [install it manually](#install-from-a-package), and manage - upgrades completely manually. This is useful in situations such as installing - Docker on air-gapped systems with no access to the internet. - -- In testing and development environments, you can use automated - [convenience scripts](#install-using-the-convenience-script) to install Docker. - -### Install using the rpm repository {#install-using-the-repository} - -Before you install Docker Engine for the first time on a new host machine, you -need to set up the Docker repository. Afterward, you can install and update -Docker from the repository. - -#### Set up the repository - -Set up the repository. - -```console -$ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo -``` - -#### Install Docker Engine - -1. Install the Docker packages. - - {{< tabs >}} - {{< tab name="Latest" >}} - - To install the latest version, run: - - ```console - $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - ``` - - If prompted to accept the GPG key, verify that the fingerprint matches - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`, and if so, accept it. - - This command installs Docker, but it doesn't start Docker. It also creates a - `docker` group, however, it doesn't add any users to the group by default. - - {{< /tab >}} - {{< tab name="Specific version" >}} - - To install a specific version, start by listing the available versions in - the repository: - - ```console - $ sudo zypper search -s --match-exact docker-ce | sort -r - - v | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x - v | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x - ``` - - The list returned depends on which repositories are enabled, and is specific - to your version of SLES. - - Install a specific version by its fully qualified package name, which is - the package name (`docker-ce`) plus the version string (2nd column), - separated by a hyphen (`-`). For example, `docker-ce-3:{{% param "docker_ce_version" %}}`. - - Replace `` with the desired version and then run the following - command to install: - - ```console - $ sudo zypper install docker-ce- docker-ce-cli- containerd.io docker-buildx-plugin docker-compose-plugin - ``` - - This command installs Docker, but it doesn't start Docker. It also creates a - `docker` group, however, it doesn't add any users to the group by default. - - {{< /tab >}} - {{< /tabs >}} - -2. Start Docker Engine. - - ```console - $ sudo systemctl enable --now docker - ``` - - This configures the Docker systemd service to start automatically when you - boot your system. If you don't want Docker to start automatically, use `sudo - systemctl start docker` instead. - -3. Verify that the installation is successful by running the `hello-world` image: - - ```console - $ sudo docker run hello-world - ``` - - This command downloads a test image and runs it in a container. When the - container runs, it prints a confirmation message and exits. - -You have now successfully installed and started Docker Engine. - -{{< include "root-errors.md" >}} - -#### Upgrade Docker Engine - -To upgrade Docker Engine, follow the [installation instructions](#install-using-the-repository), -choosing the new version you want to install. - -### Install from a package - -If you can't use Docker's `rpm` repository to install Docker Engine, you can -download the `.rpm` file for your release and install it manually. You need to -download a new file each time you want to upgrade Docker Engine. - - -1. Go to [{{% param "download-url-base" %}}/]({{% param "download-url-base" %}}/) - and choose your version of SLES. Then browse to `s390x/stable/Packages/` - and download the `.rpm` file for the Docker version you want to install. - -2. Install Docker Engine, changing the following path to the path where you downloaded - the Docker package. - - ```console - $ sudo zypper install /path/to/package.rpm - ``` - - Docker is installed but not started. The `docker` group is created, but no - users are added to the group. - -3. Start Docker Engine. - - ```console - $ sudo systemctl enable --now docker - ``` - - This configures the Docker systemd service to start automatically when you - boot your system. If you don't want Docker to start automatically, use `sudo - systemctl start docker` instead. - -4. Verify that the installation is successful by running the `hello-world` image: - - ```console - $ sudo docker run hello-world - ``` - - This command downloads a test image and runs it in a container. When the - container runs, it prints a confirmation message and exits. - -You have now successfully installed and started Docker Engine. - -{{< include "root-errors.md" >}} - -#### Upgrade Docker Engine - -To upgrade Docker Engine, download the newer package files and repeat the -[installation procedure](#install-from-a-package), using `zypper -y upgrade` -instead of `zypper -y install`, and point to the new files. - -{{< include "install-script.md" >}} - -## Uninstall Docker Engine - -1. Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages: - - ```console - $ sudo zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras - ``` - -2. Images, containers, volumes, or custom configuration files on your host - aren't automatically removed. To delete all images, containers, and volumes: - - ```console - $ sudo rm -rf /var/lib/docker - $ sudo rm -rf /var/lib/containerd - ``` - -You have to delete any edited configuration files manually. - -## Next steps - -- Continue to [Post-installation steps for Linux](linux-postinstall.md). diff --git a/content/manuals/engine/security/rootless.md b/content/manuals/engine/security/rootless.md index 6f42a9296b8..f1f33d04a24 100644 --- a/content/manuals/engine/security/rootless.md +++ b/content/manuals/engine/security/rootless.md @@ -115,14 +115,14 @@ testuser:231072:65536 - Add `kernel.unprivileged_userns_clone=1` to `/etc/sysctl.conf` (or `/etc/sysctl.d`) and run `sudo sysctl --system` {{< /tab >}} -{{< tab name="openSUSE and SLES" >}} -- For openSUSE 15 and SLES 15, Installing `fuse-overlayfs` is recommended. Run `sudo zypper install -y fuse-overlayfs`. +{{< tab name="openSUSE" >}} +- For openSUSE 15, Installing `fuse-overlayfs` is recommended. Run `sudo zypper install -y fuse-overlayfs`. This step is not required on openSUSE Tumbleweed. - `sudo modprobe ip_tables iptable_mangle iptable_nat iptable_filter` is required. This might be required on other distributions as well depending on the configuration. -- Known to work on openSUSE 15 and SLES 15. +- Known to work on openSUSE 15. {{< /tab >}} {{< tab name="CentOS, RHEL, and Fedora" >}} - For RHEL 8 and similar distributions, installing `fuse-overlayfs` is recommended. Run `sudo dnf install -y fuse-overlayfs`. diff --git a/content/manuals/engine/storage/drivers/btrfs-driver.md b/content/manuals/engine/storage/drivers/btrfs-driver.md index 720f6d59be8..5840968bd5b 100644 --- a/content/manuals/engine/storage/drivers/btrfs-driver.md +++ b/content/manuals/engine/storage/drivers/btrfs-driver.md @@ -20,8 +20,7 @@ Btrfs Filesystem as Btrfs. > [!NOTE] > -> The `btrfs` storage driver is only supported with Docker Engine CE on SLES, -> Ubuntu, and Debian systems. +> The `btrfs` storage driver is only supported with Docker Engine CE on Ubuntu and Debian systems. ## Prerequisites diff --git a/content/manuals/engine/storage/drivers/device-mapper-driver.md b/content/manuals/engine/storage/drivers/device-mapper-driver.md index 7eb9de9bb6a..8ca5cde494e 100644 --- a/content/manuals/engine/storage/drivers/device-mapper-driver.md +++ b/content/manuals/engine/storage/drivers/device-mapper-driver.md @@ -32,7 +32,7 @@ a filesystem at the operating system (OS) level. ## Prerequisites - `devicemapper` is supported on Docker Engine - Community running on CentOS, Fedora, - SLES 15, Ubuntu, Debian, or RHEL. + Ubuntu, Debian, or RHEL. - `devicemapper` requires the `lvm2` and `device-mapper-persistent-data` packages to be installed. - Changing the storage driver makes any containers you have already @@ -223,7 +223,7 @@ assumes that the Docker daemon is in the `stopped` state. - **RHEL / CentOS**: `device-mapper-persistent-data`, `lvm2`, and all dependencies - - **Ubuntu / Debian / SLES 15**: `thin-provisioning-tools`, `lvm2`, and all + - **Ubuntu / Debian**: `thin-provisioning-tools`, `lvm2`, and all dependencies 4. Create a physical volume on your block device from step 1, using the diff --git a/content/manuals/engine/storage/drivers/select-storage-driver.md b/content/manuals/engine/storage/drivers/select-storage-driver.md index fe441ce5fc8..32d02352eee 100644 --- a/content/manuals/engine/storage/drivers/select-storage-driver.md +++ b/content/manuals/engine/storage/drivers/select-storage-driver.md @@ -75,7 +75,6 @@ distribution: | Debian | `overlay2` | `vfs` | | CentOS | `overlay2` | `zfs`, `vfs` | | Fedora | `overlay2` | `zfs`, `vfs` | -| SLES 15 | `overlay2` | `vfs` | | RHEL | `overlay2` | `vfs` | When in doubt, the best all-around configuration is to use a modern Linux