Add RHEL docs (#19444)

This commit is contained in:
Dorin-Andrei Geman 2024-03-22 15:06:15 +02:00 committed by GitHub
parent ad1523ac51
commit bfa5ef2623
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
4 changed files with 158 additions and 18 deletions

View File

@ -22,12 +22,12 @@ This page contains information on how to install, launch and upgrade Docker Desk
To install Docker Desktop successfully, you must: To install Docker Desktop successfully, you must:
- Meet the [system requirements](linux-install.md#system-requirements). - Meet the [system requirements](linux-install.md#general-system-requirements).
- Have a 64-bit version of either Fedora 38 or Fedora 39. - Have a 64-bit version of either Fedora 38 or Fedora 39.
Additionally, for a Gnome Desktop environment you must install AppIndicator and KStatusNotifierItem [Gnome extensions](https://extensions.gnome.org/extension/615/appindicator-support/). Additionally, for a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem [GNOME extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
For non-Gnome Desktop environments, `gnome-terminal` must be installed: For non-GNOME desktop environments, `gnome-terminal` must be installed:
```console ```console
$ sudo dnf install gnome-terminal $ sudo dnf install gnome-terminal

View File

@ -125,9 +125,10 @@ and architectures:
| Platform | x86_64 / amd64 | | Platform | x86_64 / amd64 |
|:-----------------------|:-----------------------:| |:------------------------|:-----------------------:|
| [Ubuntu](ubuntu.md) | ✅ | | [Ubuntu](ubuntu.md) | ✅ |
| [Debian](debian.md) | ✅ | | [Debian](debian.md) | ✅ |
| [Red Hat Enterprise Linux (RHEL)](rhel.md) | ✅ |
| [Fedora](fedora.md) | ✅ | | [Fedora](fedora.md) | ✅ |
@ -216,9 +217,10 @@ Sign out and sign back in so that your group membership is re-evaluated.
{ .important } { .important }
1. Download the correct package for your Linux distribution and install it with the corresponding package manager. 1. Download the correct package for your Linux distribution and install it with the corresponding package manager.
- [Install on Debian](debian.md)
- [Install on Fedora](fedora.md)
- [Install on Ubuntu](ubuntu.md) - [Install on Ubuntu](ubuntu.md)
- [Install on Debian](debian.md)
- [Install on Red Hat Enterprise Linux (RHEL)](rhel.md)
- [Install on Fedora](fedora.md)
- [Install on Arch](archlinux.md) - [Install on Arch](archlinux.md)
By default, Docker Desktop is installed at `/opt/docker-desktop`. By default, Docker Desktop is installed at `/opt/docker-desktop`.

View File

@ -0,0 +1,136 @@
---
description: Instructions for installing Docker Desktop on RHEL
keywords: red hat, red hat enterprise linux, rhel, rpm,
update install, uninstall, upgrade, update, linux,
desktop, docker desktop, docker desktop for linux, dd4l
title: Install Docker Desktop on RHEL
toc_max: 4
download-url-base: https://download.docker.com/linux/rhel
---
> **Docker Desktop terms**
>
> Commercial use of Docker Desktop in larger enterprises (more than 250
> employees OR more than $10 million USD in annual revenue) requires a [paid
> subscription](https://www.docker.com/pricing/).
This page contains information on how to install, launch and upgrade Docker Desktop on a Red Hat Enterprise Linux (RHEL) distribution.
{{< button text="RPM package" url="https://desktop.docker.com/linux/main/amd64/docker-desktop-4.28-x86_64-rhel.rpm?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64" >}}
## Prerequisites
To install Docker Desktop successfully, you must:
- Meet the [system requirements](linux-install.md#general-system-requirements).
- Have a 64-bit version of either RHEL 8 or RHEL 9.
If you don't have `pass` installed, or it can't be installed, you must enable
[CodeReady Linux Builder (CRB) repository](https://access.redhat.com/articles/4348511)
and
[Extra Packages for Enterprise Linux (EPEL)](https://docs.fedoraproject.org/en-US/epel/).
{{< tabs group="os_version" >}}
{{< tab name="RHEL 9" >}}
```console
$ sudo subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms
$ sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
$ sudo dnf install pass
```
{{< /tab >}}
{{< tab name="RHEL 8" >}}
```console
$ sudo subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms
$ sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
$ sudo dnf install pass
```
{{< /tab >}}
{{< /tabs >}}
Additionally, for a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem [GNOME extensions](https://extensions.gnome.org/extension/615/appindicator-support/). You must also enable EPEL.
{{< tabs group="os_version" >}}
{{< tab name="RHEL 9" >}}
```console
$ # enable EPEL as described above
$ sudo dnf install gnome-shell-extension-appindicator
$ sudo gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com
```
{{< /tab >}}
{{< tab name="RHEL 8" >}}
```console
$ # enable EPEL as described above
$ sudo dnf install gnome-shell-extension-appindicator
$ sudo dnf install gnome-shell-extension-desktop-icons
$ sudo gnome-shell-extension-tool -e appindicatorsupport@rgcjonas.gmail.com
```
{{< /tab >}}
{{< /tabs >}}
For non-GNOME desktop environments, `gnome-terminal` must be installed:
```console
$ sudo dnf install gnome-terminal
```
## Install Docker Desktop
To install Docker Desktop on RHEL:
1. Set up Docker's package repository as follows:
```console
$ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce.repo
```
2. Download latest [RPM package](https://desktop.docker.com/linux/main/amd64/docker-desktop-4.28-x86_64-rhel.rpm?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64).
3. Install the package with dnf as follows:
```console
$ sudo dnf install ./docker-desktop-<version>-<arch>-rhel.rpm
```
There are a few post-install configuration steps done through the post-install script contained in the RPM package.
The post-install script:
- Sets the capability on the Docker Desktop binary to map privileged ports and set resource limits.
- Adds a DNS name for Kubernetes to `/etc/hosts`.
- Creates a symlink from `/usr/local/bin/com.docker.cli` to `/usr/bin/docker`.
This is because the classic Docker CLI is installed at `/usr/bin/docker`. The Docker Desktop installer also installs a Docker CLI binary that includes cloud-integration capabilities and is essentially a wrapper for the Compose CLI, at`/usr/local/bin/com.docker.cli`. The symlink ensures that the wrapper can access the classic Docker CLI.
- Creates a symlink from `/usr/libexec/qemu-kvm` to `/usr/local/bin/qemu-system-x86_64`.
## Launch Docker Desktop
{{< include "desktop-linux-launch.md" >}}
>**Tip**
>
> To attach Red Hat subscription data to containers, see [Red Hat verified solution](https://access.redhat.com/solutions/5870841).
>
> For example:
> ```console
> $ docker run --rm -it -v "/etc/pki/entitlement:/etc/pki/entitlement" -v "/etc/rhsm:/etc/rhsm-host" -v "/etc/yum.repos.d/redhat.repo:/etc/yum.repos.d/redhat.repo" registry.access.redhat.com/ubi9
> ```
{ .tip }
## Upgrade Docker Desktop
Once a new version for Docker Desktop is released, the Docker UI shows a notification.
You need to first remove the previous version and then download the new package each time you want to upgrade Docker Desktop. Run:
```console
$ sudo dnf remove docker-desktop
$ sudo dnf install ./docker-desktop-<version>-<arch>-rhel.rpm
```
## Next steps
- Take a look at the [Get started](../../guides/get-started/_index.md) training modules to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

View File

@ -1099,12 +1099,14 @@ Manuals:
title: Install on Linux title: Install on Linux
- sectiontitle: Installation per Linux distro - sectiontitle: Installation per Linux distro
section: section:
- path: /desktop/install/debian/
title: Install on Debian
- path: /desktop/install/fedora/
title: Install on Fedora
- path: /desktop/install/ubuntu/ - path: /desktop/install/ubuntu/
title: Install on Ubuntu title: Install on Ubuntu
- path: /desktop/install/debian/
title: Install on Debian
- path: /desktop/install/rhel/
title: Install on RHEL {{< badge color=violet text=New >}}
- path: /desktop/install/fedora/
title: Install on Fedora
- path: /desktop/install/archlinux/ - path: /desktop/install/archlinux/
title: Install on Arch title: Install on Arch
- path: /desktop/get-started/ - path: /desktop/get-started/