Skip to content

Commit 8026fec

Browse files
vrothbergdgolovin
andauthored
Update README (#80)
* README: add some notes on Linux * README: show the Registries menu * README: rename to "Account Extension" to be consistent with the name of the project. * README: mention D4I guarantee Signed-off-by: Valentin Rothberg <[email protected]> Co-authored-by: Denis Golovin <[email protected]>
1 parent e86aa47 commit 8026fec

File tree

2 files changed

+11
-2
lines changed

2 files changed

+11
-2
lines changed

README.md

+11-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Podman Desktop Red Hat SSO Extension
1+
# Podman Desktop Red Hat Account Extension
22

3-
An extension for Podman Desktop to simplify logging into and creating a Red Hat account. The extension opens sso.redhat.com in the browser to retrieve an SSO token upon successful login. The SSO token is then used to log into the [registry.redhat.io](https://catalog.redhat.com/) Container Registry and to register the Linux virtual machine powering Podman Desktop via subscription-manager to grant the containers access to protected Red Hat content such as RHEL repositories.
3+
An extension for Podman Desktop to simplify logging into and creating a Red Hat account. The extension opens sso.redhat.com in the browser to retrieve an SSO token upon successful login. The SSO token is then used to log into the Red Hat Container Registry ([registry.redhat.io](https://catalog.redhat.com/)) and to register the Linux virtual machine powering Podman Desktop via subscription-manager to grant the containers access to protected Red Hat content such as RHEL repositories. The SSO form guarantess that each user, new and existing, has a valid [Red Hat Developers Subscription](https://developers.redhat.com/) which will be used to register the virtual machine at no cost.
44

55
# Installation
66

@@ -36,6 +36,15 @@ RUN dnf install -y kernel
3636

3737
Pulling the container image `registry.redhat.io/rhel9/toolbox` requires having logged into the Red Hat container registry. Installing the `kernel` package requires access to protected content.
3838

39+
Once signed in, you can now see being logged into the Red Hat Container Registry `registry.redhat.io` in the Registries menu:
40+
![image](https://raw.githubusercontent.com/redhat-developer/podman-desktop-redhat-account-ext/0.0.2/screenshots/registries.png)
41+
42+
## Usage on Linux
43+
44+
The extension requires a running Podman Machine which grants root privileges required to run subscription-manager. In order to create a Podman Machine you may run `podman machine init` in your terminal; Podman Desktop and the extension will then be able to use that Podman Machine.
45+
46+
From a technical perspective, the extension is not required when running on Linux. You can run `podman login registry.redhat.io` and `subscription-manager register` with the credentials of your Red Hat account. `subscription-manager` is available on Fedora, CentOS, and Red Hat Enterprise Linux.
47+
3948
# Local Development
4049

4150
To rebuild Podman Desktop and the extension run:

screenshots/registries.png

167 KB
Loading

0 commit comments

Comments
 (0)