3.2. Installing Red Hat Developer Hub on OpenShift Container Platform in a partially disconnected environment with the Helm chart

Procedure

1. Log in to your OpenShift Container Platform account using the OpenShift CLI (oc) by running the following command:

   oc login -u <user> -p <password> https://api.<hostname>:6443

2. From your disconnected cluster, log in to the image registry that you want to mirror, for example, the OpenShift Container Platform image registry.

3. Create an ImageSetConfiguration.yaml file to specify the resources that you want to mirror. For example:

   apiVersion: mirror.openshift.io/v2alpha1
   kind: ImageSetConfiguration
   mirror:
     helm:
       repositories:
         - name: openshift-charts
           url: https://charts.openshift.io
           charts:
             - name: redhat-developer-hub
               version: "1.7"

   version: "1.7"

   Enter the Red Hat Developer Hub version to mirror.

4. Mirror the resources specified in the image set configuration file directly to the target registry by running the oc-mirror command. For example:

   oc-mirror --config=<mirror_config_directory>/ImageSetConfiguration.yaml <target-mirror-registry>

   where:

   <mirror_config_directory>

   Specifies the location of your image set configuration file on your system, for example, .user.

   <target_mirror_registry>

   Specifies the location and name of your target mirror registry, for example,docker://registry.example:5000.

   注記

   Running the oc-mirror command creates a local workspace containing the Helm chart and a ImageContentSourcePolicy (ICSP) manifest. The ICSP manifest contains an automatically-generated imageContentSourcePolicy.yaml file that you must apply against the cluster in a later step.

5. In your workspace, locate the ImageDigestMirrorSet (IDMS) and ImageTagMirrorSet (ITMS) files by running the ls command. For example:

   ls <workspace_directory>/working-dir/cluster-resources/

   where:

   <workspace_directory>

   Specifies the name of your workspace directory, for example, oc-mirror-workspace.

   <results_directory>

   Specifies the name of your results directory, for example, results-1738070846.

6. To configure image mirroring, deploy the IDMS and ITMS files in the disconnected cluster by running the oc apply command. For example:

   oc apply -f <workspace_directory>/working-dir/cluster-resources

   where:

   <workspace_directory>

   Enter the name of your workspace directory, for example, oc-mirror-workspace.

   <results_directory>

   Enter the name of your results directory, for example, results-1738070846.

7. In your air-gapped environment, deploy the Helm chart to the namespace that you want to use by running the helm install command with namespace and set options. For example:

   CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/[.]*\.//')
   
   helm install <rhdh_instance> <workspace_directory>/<results_directory>/charts/<archive_file> --namespace <your_namespace> --create-namespace \
     --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE"

   where:

   <rhdh_instance>

   Specifies the name of your Red Hat Developer Hub instance, for example, my-rhdh.

   <workspace_directory>

   Specifies the name of your workspace directory, for example, oc-mirror-workspace.

   <results_directory>

   Specifies the name of your results directory, for example, results-1738070846.

   <archive_file>

   Specifies the name of the archive file containing the resources that you want to mirror, for example, redhat-developer-hub-1.4.1.tgz.

   <your_namespace>

   Specifies the namespace that you want to deploy the Helm chart to, for example, my-rhdh-project.