docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

engine/install: fix indentation, and align rerequisites section 

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn 2023-05-03 15:31:28 +02:00
parent 700753fef2
commit f27edb7f7a
No known key found for this signature in database
GPG Key ID: 76698F39D527CE8C
5 changed files with 304 additions and 296 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

130
engine/install/centos.md
View File

@ -22,12 +22,12 @@ To get started with Docker Engine on CentOS, make sure you
### OS requirements ### OS requirements
To install Docker Engine, you need a maintained version of one of the following CentOS versions: To install Docker Engine, you need a maintained version of one of the following
- CentOS 7 CentOS versions:
- CentOS 8 (stream)
- CentOS 9 (stream)
Archived versions aren't supported or tested. - CentOS 7
- CentOS 8 (stream)
- CentOS 9 (stream)
The `centos-extras` repository must be enabled. This repository is enabled by The `centos-extras` repository must be enabled. This repository is enabled by
default, but if you have disabled it, you need to default, but if you have disabled it, you need to
@ -102,46 +102,46 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo
<br> <br>
<div id="tab-latest" class="tab-pane fade in active" markdown="1"> <div id="tab-latest" class="tab-pane fade in active" markdown="1">
To install the latest version, run: To install the latest version, run:
```console ```console
$ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin $ sudo yum 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 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. `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 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. `docker` group, however, it doesn't add any users to the group by default.
</div> </div>
<div id="tab-version" class="tab-pane fade" markdown="1"> <div id="tab-version" class="tab-pane fade" markdown="1">
To install a specific version, start by listing the available versions in the repository: To install a specific version, start by listing the available versions in the repository:
```console ```console
$ yum list docker-ce --showduplicates | sort -r $ yum list docker-ce --showduplicates | sort -r
docker-ce.x86_64 3:23.0.5-1.el8 docker-ce-stable docker-ce.x86_64 3:23.0.5-1.el8 docker-ce-stable
docker-ce.x86_64 3:23.0.4-1.el8 docker-ce-stable docker-ce.x86_64 3:23.0.4-1.el8 docker-ce-stable
<...> <...>
``` ```
The list returned depends on which repositories are enabled, and is specific The list returned depends on which repositories are enabled, and is specific
to your version of CentOS (indicated by the `.el8` suffix in this example). to your version of CentOS (indicated by the `.el8` suffix in this example).
Install a specific version by its fully qualified package name, which is Install a specific version by its fully qualified package name, which is
the package name (`docker-ce`) plus the version string (2nd column), the package name (`docker-ce`) plus the version string (2nd column),
separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5-1.el8`. separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5-1.el8`.
Replace `<VERSION_STRING>` with the desired version and then run the following command to install: Replace `<VERSION_STRING>` with the desired version and then run the following command to install:
```console ```console
$ sudo yum install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin $ sudo yum install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
``` ```
This command installs Docker, but it doesn't start Docker. It also creates a 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. `docker` group, however, it doesn't add any users to the group by default.
</div> </div>
<hr> <hr>
@ -149,19 +149,19 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo
2. Start Docker. 2. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
3. Verify that Docker Engine installation is successful by running the `hello-world` 3. Verify that Docker Engine installation is successful by running the `hello-world`
image. 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 confirmation 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.
@ -179,33 +179,33 @@ If you can't use Docker's repository to install Docker, you can download the
a new file each time you want to upgrade Docker Engine. 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 CentOS. Then browse to `x86_64/stable/Packages/` and choose your version of CentOS. Then browse to `x86_64/stable/Packages/`
and download the `.rpm` file for the Docker version you want to install. and download the `.rpm` file for the Docker version you want to install.
2. Install Docker Engine, changing the path below to the path where you downloaded the Docker package. 2. Install Docker Engine, changing the path below to the path where you downloaded the Docker package.
```console ```console
$ sudo yum install /path/to/package.rpm $ sudo yum install /path/to/package.rpm
``` ```
Docker is installed but not started. The `docker` group is created, but no Docker is installed but not started. The `docker` group is created, but no
users are added to the group. users are added to the group.
3. Start Docker. 3. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine installation is successful by running the `hello-world` 4. Verify that Docker Engine installation is successful by running the `hello-world`
image. 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 confirmation 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.
@ -223,18 +223,18 @@ instead of `yum -y install`, and point to the new file.
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 customized configuration files on your host
are not automatically removed. To delete all images, containers, and are not 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 must delete any edited configuration files manually.

147
engine/install/fedora.md
View File

@ -18,7 +18,8 @@ To get started with Docker Engine on Fedora, make sure you
### OS requirements ### OS requirements
To install Docker Engine, you need the 64-bit version of one of these Fedora versions: To install Docker Engine, you need a maintained version of one of the following
Fedora versions:
- Fedora 36 - Fedora 36
- Fedora 37 - Fedora 37
@ -84,62 +85,62 @@ $ sudo dnf config-manager --add-repo {{ download-url-base }}/docker-ce.repo
#### Install Docker Engine #### Install Docker Engine
1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose 1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose
or go to the next step to install a specific version: or go to the next step to install a specific version:
```console ```console
$ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin $ sudo dnf 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 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. `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 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. `docker` group, however, it doesn't add any users to the group by default.
2. To install a _specific version_ of Docker Engine, list the available versions 2. To install a _specific version_ of Docker Engine, list the available versions
in the repo, then select and install: in the repo, then select and install:
a. List and sort the versions available in your repo. This example sorts a. List and sort the versions available in your repo. This example sorts
results by version number, highest to lowest, and is truncated: results by version number, highest to lowest, and is truncated:
```console ```console
$ dnf list docker-ce --showduplicates | sort -r $ dnf list docker-ce --showduplicates | sort -r
docker-ce.x86_64 3:23.0.5-1.fc37 docker-ce-stable docker-ce.x86_64 3:23.0.5-1.fc37 docker-ce-stable
docker-ce.x86_64 3:23.0.4-1.fc37 docker-ce-stable docker-ce.x86_64 3:23.0.4-1.fc37 docker-ce-stable
<...> <...>
``` ```
The list returned depends on which repositories are enabled, and is specific The list returned depends on which repositories are enabled, and is specific
to your version of Fedora (indicated by the `.fc37` suffix in this example). to your version of Fedora (indicated by the `.fc37` suffix in this example).
b. Install a specific version by its fully qualified package name, which is b. Install a specific version by its fully qualified package name, which is
the package name (`docker-ce`) plus the version string (2nd column), the package name (`docker-ce`) plus the version string (2nd column),
separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5-1.fc37`. separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5-1.fc37`.
```console ```console
$ sudo dnf -y install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin $ sudo dnf -y install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
``` ```
This command installs Docker, but it doesn't start Docker. It also creates a 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. `docker` group, however, it doesn't add any users to the group by default.
3. Start Docker. 3. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. 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 message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -156,35 +157,35 @@ 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 `.rpm` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker Engine. 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 Fedora. Then browse to `x86_64/stable/Packages/` and choose your version of Fedora. Then browse to `x86_64/stable/Packages/`
and download the `.rpm` file for the Docker version you want to install. and download the `.rpm` file for the Docker version you want to install.
2. Install Docker Engine, changing the path below to the path where you downloaded 2. Install Docker Engine, changing the path below to the path where you downloaded
the Docker package. the Docker package.
```console ```console
$ sudo dnf -y install /path/to/package.rpm $ sudo dnf -y install /path/to/package.rpm
``` ```
Docker is installed but not started. The `docker` group is created, but no Docker is installed but not started. The `docker` group is created, but no
users are added to the group. users are added to the group.
3. Start Docker. 3. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. 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 message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -200,20 +201,20 @@ instead of `dnf -y install`, and point to the new file.
## 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 dnf remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras $ sudo dnf 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 customized configuration files on your host
are not automatically removed. To delete all images, containers, and are not 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 must delete any edited configuration files manually.

152
engine/install/rhel.md
View File

@ -28,8 +28,12 @@ To get started with Docker Engine on RHEL, make sure you
### OS requirements ### OS requirements
To install Docker Engine, you need a maintained version of RHEL 7, RHEL 8 or RHEL 9 on s390x (IBM Z). To install Docker Engine, you need a maintained version of one of the following
Archived versions aren't supported or tested. RHEL versions:
- RHEL 7 on s390x (IBM Z)
- RHEL 8 on s390x (IBM Z)
- RHEL 9 on s390x (IBM Z)
The `overlay2` storage driver is recommended. The `overlay2` storage driver is recommended.
@ -94,62 +98,62 @@ $ sudo yum-config-manager --add-repo {{ download-url-base }}/docker-ce.repo
#### Install Docker Engine #### Install Docker Engine
1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose 1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose
or go to the next step to install a specific version: or go to the next step to install a specific version:
```console ```console
$ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin $ sudo yum 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 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. `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 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. `docker` group, however, it doesn't add any users to the group by default.
2. To install a _specific version_ of Docker Engine, list the available versions 2. To install a _specific version_ of Docker Engine, list the available versions
in the repo, then select and install: in the repo, then select and install:
a. List and sort the versions available in your repo. This example sorts a. List and sort the versions available in your repo. This example sorts
results by version number, highest to lowest, and is truncated: results by version number, highest to lowest, and is truncated:
```console ```console
$ yum list docker-ce --showduplicates | sort -r $ yum list docker-ce --showduplicates | sort -r
docker-ce.s390x 3:23.0.5-1.el8 docker-ce-stable docker-ce.s390x 3:23.0.5-1.el8 docker-ce-stable
docker-ce.s390x 3:23.0.4-1.el8 docker-ce-stable docker-ce.s390x 3:23.0.4-1.el8 docker-ce-stable
<...> <...>
``` ```
The list returned depends on which repositories are enabled, and is specific The list returned depends on which repositories are enabled, and is specific
to your version of RHEL (indicated by the `.el8` suffix in this example). to your version of RHEL (indicated by the `.el8` suffix in this example).
b. Install a specific version by its fully qualified package name, which is b. Install a specific version by its fully qualified package name, which is
the package name (`docker-ce`) plus the version string (2nd column), the package name (`docker-ce`) plus the version string (2nd column),
separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5-1.el8`. separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5-1.el8`.
```console ```console
$ sudo yum install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin $ sudo yum install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
``` ```
This command installs Docker, but it doesn't start Docker. It also creates a 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. `docker` group, however, it doesn't add any users to the group by default.
3. Start Docker. 3. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. 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 message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -166,35 +170,35 @@ 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 `.rpm` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker Engine. 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/`
and download the `.rpm` file for the Docker version you want to install. and download the `.rpm` file for the Docker version you want to install.
2. Install Docker Engine, changing the path below to the path where you downloaded 2. Install Docker Engine, changing the path below to the path where you downloaded
the Docker package. the Docker package.
```console ```console
$ sudo yum install /path/to/package.rpm $ sudo yum install /path/to/package.rpm
``` ```
Docker is installed but not started. The `docker` group is created, but no Docker is installed but not started. The `docker` group is created, but no
users are added to the group. users are added to the group.
3. Start Docker. 3. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. 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 message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -210,20 +214,20 @@ instead of `yum -y install`, and point to the new file.
## 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 customized configuration files on your host
are not automatically removed. To delete all images, containers, and are not 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 must delete any edited configuration files manually.

149
engine/install/sles.md
View File

@ -34,8 +34,11 @@ To get started with Docker Engine on SLES, make sure you
### OS requirements ### OS requirements
To install Docker Engine, you need a maintained version of SLES 15-SP3 or SLES 15-SP4 on s390x (IBM Z). To install Docker Engine, you need a maintained version of one of the following
Archived versions aren't supported or tested. SLES versions:
- SLES 15-SP3 on s390x (IBM Z)
- SLES 15-SP4 on s390x (IBM Z)
The [`SCC SUSE`](https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.3&arch=s390x) The [`SCC SUSE`](https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.3&arch=s390x)
repositories must be enabled. repositories must be enabled.
@ -117,61 +120,61 @@ $ sudo zypper addrepo {{ download-url-base }}/docker-ce.repo
#### Install Docker Engine #### Install Docker Engine
1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose 1. Install the _latest version_ of Docker Engine, containerd, and Docker Compose
or go to the next step to install a specific version: or go to the next step to install a specific version:
```console ```console
$ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin $ 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 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. `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 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. `docker` group, however, it doesn't add any users to the group by default.
2. To install a _specific version_ of Docker Engine, list the available versions 2. To install a _specific version_ of Docker Engine, list the available versions
in the repo, then select and install: in the repo, then select and install:
a. List and sort the versions available in your repo. This example sorts a. List and sort the versions available in your repo. This example sorts
results by version number, highest to lowest, and is truncated: results by version number, highest to lowest, and is truncated:
```console ```console
$ sudo zypper search -s --match-exact docker-ce | sort -r $ sudo zypper search -s --match-exact docker-ce | sort -r
v | docker-ce | package | 3:23.0.5-3 | s390x | Docker CE Stable - s390x v | docker-ce | package | 3:23.0.5-3 | s390x | Docker CE Stable - s390x
v | docker-ce | package | 3:23.0.4-3 | s390x | Docker CE Stable - s390x v | docker-ce | package | 3:23.0.4-3 | s390x | Docker CE Stable - s390x
``` ```
The list returned depends on which repositories are enabled, and is specific The list returned depends on which repositories are enabled, and is specific
to your version of SLES. to your version of SLES.
b. Install a specific version by its fully qualified package name, which is b. Install a specific version by its fully qualified package name, which is
the package name (`docker-ce`) plus the version string (fourth column), the package name (`docker-ce`) plus the version string (fourth column),
separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5`. separated by a hyphen (`-`). For example, `docker-ce-3:23.0.5`.
```console ```console
$ sudo zypper install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin $ sudo zypper install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
``` ```
This command installs Docker, but it doesn't start Docker. It also creates a 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. `docker` group, however, it doesn't add any users to the group by default.
3. Start Docker. 3. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. 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 message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -188,35 +191,35 @@ 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 `.rpm` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker Engine. 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 SLES. Then browse to `15/s390x/stable/Packages/` and choose your version of SLES. Then browse to `15/s390x/stable/Packages/`
and download the `.rpm` file for the Docker version you want to install. and download the `.rpm` file for the Docker version you want to install.
2. Install Docker Engine, changing the path below to the path where you downloaded 2. Install Docker Engine, changing the path below to the path where you downloaded
the Docker package. the Docker package.
```console ```console
$ sudo zypper install /path/to/package.rpm $ sudo zypper install /path/to/package.rpm
``` ```
Docker is installed but not started. The `docker` group is created, but no Docker is installed but not started. The `docker` group is created, but no
users are added to the group. users are added to the group.
3. Start Docker. 3. Start Docker.
```console ```console
$ sudo systemctl start docker $ sudo systemctl start docker
``` ```
4. Verify that Docker Engine is installed correctly by running the `hello-world` 4. Verify that Docker Engine is installed correctly by running the `hello-world`
image. 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 message and exits.
You have now successfully installed and started Docker Engine. You have now successfully installed and started Docker Engine.
@ -232,20 +235,20 @@ instead of `zypper -y install`, and point to the new file.
## 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 zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras $ 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 customized configuration files on your host 2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and are not 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 must delete any edited configuration files manually.

20
engine/install/ubuntu.md
View File

@ -235,19 +235,19 @@ To upgrade Docker Engine, download the newer package files and repeat the
## 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 apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras $ sudo apt-get purge 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 2. Images, containers, volumes, or custom configuration files on your host
aren't automatically removed. To delete all images, containers, and volumes: aren't automatically removed. To delete all images, containers, and 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 have to delete any edited configuration files manually. You have to delete any edited configuration files manually.