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 という名前の config map と、BACKEND_SECRET を含む Kubernetes Secret を作成する必要があります。これらのリソースは、Developer Hub インスタンスによって認証とアプリケーション設定に使用されます。

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

6. 次のように、app-config.yaml を含む app-config-rhdh という名前の config map を作成します。

   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-encoded 文字列を値として持つ 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 ルーターホストをフォーム上のフィールドに貼り付けます。

   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 が起動するのを待ちます。