第2章 Installing Red Hat Developer Hub on OpenShift Container Platform with the Helm chart
You can install Red Hat Developer Hub on OpenShift Container Platform by using the Helm chart with one of the following methods:
- The OpenShift Container Platform console
- The Helm CLI
2.1. Deploying Developer Hub from the OpenShift Container Platform web console with the Helm Chart リンクのコピーリンクがクリップボードにコピーされました!
You can use a Helm chart to install Developer Hub on the Red Hat OpenShift Container Platform web console.
Helm is a package manager on OpenShift Container Platform that provides the following features:
- Applies regular application updates using custom hooks
- Manages the installation of complex applications
- Provides charts that you can host on public and private servers
- Supports rolling back to previous application versions
The Red Hat Developer Hub Helm chart is available in the Helm catalog on OpenShift Dedicated and OpenShift Container Platform.
Prerequisites
- You are logged in to your OpenShift Container Platform account.
-
A user with the OpenShift Container Platform
adminrole has configured the appropriate roles and permissions within your project to create an application. For more information about OpenShift Container Platform roles, see Using RBAC to define and apply permissions. - You have created a project in OpenShift Container Platform. For more information about creating a project in OpenShift Container Platform, see Red Hat OpenShift Container Platform documentation.
- Make sure that your system meets the minimum sizing requirements. See Sizing requirements for Red Hat Developer Hub.
Procedure
- From the Developer perspective on the Developer Hub web console, click +Add.
- From the Developer Catalog panel, click Helm Chart.
- In the Filter by keyword box, enter Developer Hub and click the Red Hat Developer Hub card.
- From the Red Hat Developer Hub page, click Create.
-
From your cluster, copy the OpenShift Container Platform router host (for example:
apps.<clusterName>.com). 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
-
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.
-
To configure the instance with the Form view, go to Root Schema
Using YAML view
To configure the instance with the YAML view, paste your OpenShift Container Platform router hostname in the
global.clusterRouterBaseparameter value as shown in the following example:global: auth: backend: enabled: true clusterRouterBase: apps.<clusterName>.com
Edit the other values if needed.
注記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.
- Click Create and wait for the database and Developer Hub to start.
Click the Open URL icon to start using the Developer Hub platform.
Your developer-hub pod might be in a CrashLoopBackOff state if the Developer Hub container cannot access the configuration files. This error is indicated by the following log:
Loaded config from app-config-from-configmap.yaml, env
...
2023-07-24T19:44:46.223Z auth info Configuring "database" as KeyStore provider type=plugin
Backend failed to start up Error: Missing required config value at 'backend.database.client'
To resolve the error, verify the configuration files.