Chapter 1. Installing Red Hat Developer Hub on OpenShift Dedicated on GCP using the Operator

Procedure

1. In the OpenShift Container Platform web console menu, go to Operators > OperatorHub.
2. In the Filter by keyword field, enter Developer Hub and click the Red Hat Developer Hub Operator card.
3. On the Red Hat Developer Hub Operator page, click Install.
4. After the installation completes, navigate to Installed Operators and select Red Hat Developer Hub Operator.

5. Provision your custom configuration:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: app-config-rhdh
   data:
     "app-config-rhdh.yaml": |
       app:
         title: Red Hat Developer Hub
         baseUrl: https://__<my_developer_hub_url>__
       backend:
         auth:
           externalAccess:
               - type: legacy
                 options:
                   subject: legacy-default-config
                   secret: "${BACKEND_SECRET}"
         baseUrl: https://__<my_developer_hub_url>__
         cors:
           origin: https://__<my_developer_hub_url>__

   You must create a config map named app-config-rhdh and a Kubernetes Secret containing the BACKEND_SECRET. These resources are used by the Developer Hub instance for authentication and application settings.

   For further steps, see Provisioning your custom Red Hat Developer Hub configuration.

6. Create a config map named app-config-rhdh that includes your app-config.yaml as shown:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: app-config-rhdh
   data:
     "app-config-rhdh.yaml": |
       app:
         title: Red Hat Developer Hub
         baseUrl: https://__<my_developer_hub_url>__
       backend:
         auth:
           externalAccess:
               - type: legacy
                 options:
                   subject: legacy-default-config
                   secret: "${BACKEND_SECRET}"
         baseUrl: https://__<my_developer_hub_url>__
         cors:
           origin: https://__<my_developer_hub_url>__

7. Create a secret named my-rhdh-secrets and add a key named BACKEND_SECRET with a Base64-encoded string as value:

   apiVersion: v1
   kind: Secret
   metadata:
     name: my-rhdh-secrets
   stringData:
     # TODO: Add the necessary auth secrets for service-to-service auth setup
     BACKEND_SECRET: "xxx" # Replace with your Base64-encoded secret

8. Return to the Developer Hub Operator page and click Create New Instance.
9. Specify the name and target namespace for the Developer Hub deployment.
10. Configure required options such as Git integration, secrets, and user permissions.
11. Review the configuration, select deployment options, and click Create.