Applies to SUSE Private Registry 1.0

2 Installation using the Rancher UI #

To install SUSE Private Registry using the Rancher UI, you must meet the following requirements and follow the steps below.

2.1 What requirements do I need to meet? #

An environment with a running supported Kubernetes cluster(s) and Rancher deployed. Refer to Rancher installation requirements for more details.
SUSE Registry credentials for an account with a SUSE Private Registry subscription (a username and a password/token). Refer to Obtaining Kubernetes secrets from SCC for more details.

STEP 1: Tell Rancher where the SUSE Private Registry repository is located to look for the installation chart. #

Log in to Rancher.
Click the three-line menu (☰) in the top-left corner, select Cluster Management, and click your cluster’s name, usually local.
From the left-hand menu, select Apps › Repositories.
Click the Create button in the top right and complete the form that opens:
1. Target: Select OCI Repository.
2. Name: Enter a name for the repository, such as SUSE Private Registry.
3. Description: Optionally, add a description of the repository.
4. OCI Repository Host URL: Enter `oci://registry.suse.com/private-registry/private-registry-helm`.
5. Authentication: Change to Create an HTTP Basic Auth Secret and enter the user name and password of the registry’s credentials.
Confirm with Create.

Figure 2.1: Adding a SUSE Private Registry repository #

STEP 2: Create a secret to access the images in the `registry.suse.com`. #

Click the three-line menu (☰) in the top-left corner and select Cluster Management.
Switch to the cluster to which you want to add the secret and click Explore.
To navigate to secrets management, select Storage › Secrets and click Create in the top right.
Select the HTTP Basic Auth secret and then the private-registry namespace.
Enter suse-registry as the name for the secret.
Fill the username and the password fields with the SUSE credentials obtained in Section 2.1, “What requirements do I need to meet?”.

Figure 2.2: Adding SUSE Private Registry secrets #

STEP 3: Install the Helm chart. #

From the main left menu, select Apps › Charts.
Enter the name of the assigned SUSE Private Registry repository in the search box. For example, SUSE Private Registry. If it does not appear in the list, click Refresh all repositories.
Click the chart and view the README.md.
Optionally, you can customize the installation values. Either click through the sections on the left side of the Edit Options panel to view all the values you can configure, or edit the values directly in the chart’s YAML file.
In the top right corner, click Install this version.

Figure 2.3: Installing SUSE Private Registry #