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
Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them, along with associated dependencies. Also uninstall
`Podman` and the associated dependencies if installed already.
Older versions of Docker went by the names of `docker` or `docker-engine`.
Uninstall any such older versions before attempting to install a new version,
along with associated dependencies. Also uninstall `Podman` and the associated
dependencies if installed already:
```console
$ sudo yum remove docker \
@ -54,33 +55,33 @@ $ sudo yum remove docker \
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
networks, are preserved. The Docker Engine package is now called `docker-ce`.
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:
- Most users
- 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.
- Some users download the RPM package and
- You can download the RPM package and
[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, 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.
### 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
to set up the Docker repository. Afterward, you can install and update Docker
from 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
@ -143,15 +144,15 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo
$ sudo systemctl start docker
```
4. Verify that Docker Engine is installed correctly by running the `hello-world`
image.
4. Verify that the Docker Engine 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 message and exits.
container runs, it prints a confirmation message and exits.
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
If you cannot use Docker's repository to install Docker, 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.
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 [{{ download-url-base }}/]({{ download-url-base }}/){: target="_blank" rel="noopener" class="_" }
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
```
4. Verify that Docker Engine is installed correctly by running the `hello-world`
image.
4. Verify that the Docker Engine 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 message and exits.
container runs, it prints a confirmation message and exits.
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
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`
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 %}
## 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
$ 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
are not automatically removed. To delete all images, containers, and
volumes:
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 must delete any edited configuration files manually.
You have to delete any edited configuration files manually.
## Next steps