Chapter 2. Installing Red Hat Developer Hub on OpenShift Container Platform with the Helm chart

Procedure

1. From the Developer perspective on the Developer Hub web console, click +Add.
2. From the Developer Catalog panel, click Helm Chart.
3. In the Filter by keyword box, enter Developer Hub and click the Red Hat Developer Hub card.
4. From the Red Hat Developer Hub page, click Create.
5. From your cluster, copy the OpenShift Container Platform router host (for example: apps.<clusterName>.com).

6. Select the radio button to configure the Developer Hub instance with either the form view or YAML view. The Form view is selected by default.

   • Using Form view

     1. To configure the instance with the Form view, go to Root Schema global Enable service authentication within Backstage instance and paste your OpenShift Container Platform router host into the field on the form.

   • Using YAML view

     1. To configure the instance with the YAML view, paste your OpenShift Container Platform router hostname in the global.clusterRouterBase parameter value as shown in the following example:

        global:
          auth:
            backend:
              enabled: true
          clusterRouterBase: apps.<clusterName>.com
          # other Red Hat Developer Hub Helm Chart configurations

7. Edit the other values if needed.

   Note

   The information about the host is copied and can be accessed by the Developer Hub backend.

   When an OpenShift Container Platform route is generated automatically, the host value for the route is inferred and the same host information is sent to the Developer Hub. Also, if the Developer Hub is present on a custom domain by setting the host manually using values, the custom host takes precedence.

8. Click Create and wait for the database and Developer Hub to start.

9. Click the Open URL icon to start using the Developer Hub platform.

   

Procedure

1. Create and activate the <rhdh> OpenShift Container Platform project:

   NAMESPACE=<emphasis><rhdh></emphasis>
   oc new-project ${NAMESPACE} || oc project ${NAMESPACE}

2. Install the Red Hat Developer Hub Helm chart:

   helm upgrade redhat-developer-hub -i https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.3.5/redhat-developer-hub-1.3.5.tgz

3. Configure your Developer Hub Helm chart instance with the Developer Hub database password and router base URL values from your OpenShift Container Platform cluster:

   PASSWORD=$(oc get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d)
   CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//')
   helm upgrade redhat-developer-hub -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.3.5/redhat-developer-hub-1.3.5.tgz" \
       --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \
       --set global.postgresql.auth.password="$PASSWORD"

4. Display the running Developer Hub instance URL:

   echo "https://redhat-developer-hub-$NAMESPACE.$CLUSTER_ROUTER_BASE"