mirror of https://github.com/docker/docs.git
engine/install: RHEL: align wording with other distros
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
parent
d05fd91c9f
commit
0b3fd2b64c
|
@ -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
|
||||
|
||||
|
|
Loading…
Reference in New Issue