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
|
### 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
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue