engine/install: RHEL: align wording with other distros

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn 2023-05-04 09:52:45 +02:00
parent d05fd91c9f
commit 0b3fd2b64c
No known key found for this signature in database
GPG Key ID: 76698F39D527CE8C
1 changed files with 29 additions and 29 deletions

View File

@ -37,9 +37,10 @@ RHEL versions:
### Uninstall old versions ### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are Older versions of Docker went by the names of `docker` or `docker-engine`.
installed, uninstall them, along with associated dependencies. Also uninstall Uninstall any such older versions before attempting to install a new version,
`Podman` and the associated dependencies if installed already. along with associated dependencies. Also uninstall `Podman` and the associated
dependencies if installed already:
```console ```console
$ sudo yum remove docker \ $ sudo yum remove docker \
@ -54,33 +55,33 @@ $ sudo yum remove docker \
runc runc
``` ```
It's OK if `yum` reports that none of these packages are installed. `yum` might report that you have none of these packages installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't
networks, are preserved. The Docker Engine package is now called `docker-ce`. automatically removed when you uninstall Docker.
## Installation methods ## Installation methods
You can install Docker Engine in different ways, depending on your needs: You can install Docker Engine in different ways, depending on your needs:
- Most users - You can
[set up Docker's repositories](#install-using-the-repository) and install [set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the from them, for ease of installation and upgrade tasks. This is the
recommended approach. recommended approach.
- Some users download the RPM package and - You can download the RPM package and
[install it manually](#install-from-a-package) and manage [install it manually](#install-from-a-package) and manage
upgrades completely manually. This is useful in situations such as installing upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet. Docker on air-gapped systems with no access to the internet.
- In testing and development environments, some users choose to use automated - In testing and development environments, you can use automated
[convenience scripts](#install-using-the-convenience-script) to install Docker. [convenience scripts](#install-using-the-convenience-script) to install Docker.
### Install using the repository ### 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 Before you install Docker Engine for the first time on a new host machine, you
to set up the Docker repository. Afterward, you can install and update Docker need to set up the Docker repository. Afterward, you can install and update
from the repository. Docker from the repository.
#### Set up the repository #### Set up the repository
@ -143,15 +144,15 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that the Docker Engine installation is successful by running the
image. `hello-world` image.
```console ```console
$ sudo docker run hello-world $ sudo docker run hello-world
``` ```
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints a message and exits. container runs, it prints a confirmation message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -164,9 +165,9 @@ choosing the new version you want to install.
### Install from a package ### Install from a package
If you cannot use Docker's repository to install Docker, you can download the If you can't use Docker's `rpm` repository to install Docker Engine, you can
`.rpm` file for your release and install it manually. You need to download download the `.rpm` file for your release and install it manually. You need to
a new file each time you want to upgrade Docker Engine. download a new file each time you want to upgrade Docker Engine.
1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" } 1. Go to [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" }
and choose your version of RHEL. Then browse to `s390x/stable/Packages/` and choose your version of RHEL. Then browse to `s390x/stable/Packages/`
@ -188,15 +189,15 @@ a new file each time you want to upgrade Docker Engine.
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that the Docker Engine installation is successful by running the
image. `hello-world` image.
```console ```console
$ sudo docker run hello-world $ sudo docker run hello-world
``` ```
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints a message and exits. container runs, it prints a confirmation message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -204,30 +205,29 @@ You have now successfully installed and started Docker Engine.
#### Upgrade Docker Engine #### Upgrade Docker Engine
To upgrade Docker Engine, download the newer package file and repeat the To upgrade Docker Engine, download the newer package files and repeat the
[installation procedure](#install-from-a-package), using `yum -y upgrade` [installation procedure](#install-from-a-package), using `yum -y upgrade`
instead of `yum -y install`, and point to the new file. instead of `yum -y install`, and point to the new files.
{% include install-script.md %} {% include install-script.md %}
## Uninstall Docker Engine ## Uninstall Docker Engine
1. Uninstall the Docker Engine, CLI, Containerd, and Docker Compose packages: 1. Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages:
```console ```console
$ sudo yum remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras $ sudo yum remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
``` ```
2. Images, containers, volumes, or customized configuration files on your host 2. Images, containers, volumes, or custom configuration files on your host
are not automatically removed. To delete all images, containers, and aren't automatically removed. To delete all images, containers, and volumes:
volumes:
```console ```console
$ sudo rm -rf /var/lib/docker $ sudo rm -rf /var/lib/docker
$ sudo rm -rf /var/lib/containerd $ sudo rm -rf /var/lib/containerd
``` ```
You must delete any edited configuration files manually. You have to delete any edited configuration files manually.
## Next steps ## Next steps