OpenShift Dedicated on Google Cloud Platform への Red Hat Developer Hub のインストール

手順

1. OpenShift Container Platform Web コンソールメニューで、Operators > OperatorHub に移動し ます。
2. Filter by keyword フィールドに Developer Hub と入力し、Red Hat Developer Hub Operator カードをクリックします。
3. Red Hat Developer Hub Operator ページで、Install をクリックします。
4. インストールが完了したら、Installed Operators に移動し、Red Hat Developer Hub Operator を選択します。

5. カスタム設定をプロビジョニングします。

   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>__

   app-config-rhdh という名前の設定マップと BACKEND_SECRET を含む Kubernetes シークレットを作成する必要があります。これらのリソースは、認証およびアプリケーション設定の Developer Hub インスタンスが使用します。

   詳細な手順については、カスタム Red Hat Developer Hub 設定のプロビジョニング を 参照してください。

6. 以下のように app-config.yaml を含む app-config-rhdh という名前の設定マップを作成します。

   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. my-rhdh-secrets という名前のシークレットを作成し、Base64 でエンコードされた 文字列を値として持つ BACKEND_SECRET という名前のキーを追加します。

   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. Developer Hub Operator ページに戻り、Create New Instance をクリックします。
9. Developer Hub デプロイメントの名前とターゲット namespace を指定します。
10. Git 統合、シークレット、ユーザーパーミッションなど、必要なオプションを設定します。
11. 設定を確認し、デプロイメントオプションを選択して、Create をクリックします。

手順

1. Developer Hub Web コンソールの Developer パースペクティブから、+Add をクリックします。
2. Developer Catalog パネルから、Helm Chart をクリックします。
3. Filter by keyword ボックスに Developer Hub と入力し、Red Hat Developer Hub カードをクリックします。
4. Red Hat Developer Hub ページで、Create をクリックします。
5. クラスターから、OpenShift Container Platform ルーターホスト (例: apps.<clusterName>.com) をコピーします。

6. ラジオボタンを選択して、Form ビューまたは YAML ビューのいずれかを使用して Developer Hub インスタンスを設定します。

   重要

   Helm チャートを使用して Developer Hub をデプロイする前に、インスタンスのパブリック baseUrl などのカスタム設定を定義する必要があります。baseUrl を設定しないと、アプリケーションは正しく機能しません。この設定は、Helm インストールウィザードで Form view または YAML view を使用して定義できます。

   baseUrl を設定するには、Helm 設定で次の値を設定します。

   global:
     app:
       baseUrl: https://<your-developer-hub-url>
     backend:
       baseUrl: https://<your-developer-hub-url>
       cors:
         origin: https://<your-developer-hub-url>

   追加のシークレット、プラグイン、および高度な設定を values.yaml ファイルに定義することもできます。詳細な手順については、カスタム Red Hat Developer Hub 設定のプロビジョニング を 参照してください。

   デフォルトでは Form view が選択されています。

   1. Form view を使用する場合

      1. Form view を使用してインスタンスを設定するには、Root Schema → global → Enable service authentication within Backstage instance に移動し、OpenShift Container Platform ルーターホストを Form のフィールドに貼り付けます。

   2. YAML view を使用する場合

      1. YAML ビューを使用してインスタンスを設定するには、次の例に示すように、global.clusterRouterBase パラメーター値に OpenShift Container Platform ルーターのホスト名を貼り付けます。

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

7. 必要に応じて他の値を編集し、Create をクリックして、データベースと Developer Hub が起動するのを待ちます。