第3章 Red Hat Developer Hub でサポートされる設定

手順

1. OpenShift Container Platform Web コンソールから、ConfigMaps タブを選択します。
2. Create ConfigMap をクリックします。
3. Create ConfigMap ページで、Configure via の YAML view オプションを選択し、必要に応じてファイルに変更を加えます。
4. Create をクリックします。
5. Helm リリースのリストを表示するには、Helm タブに移動します。
6. 使用する Helm リリースのオーバーフローメニューをクリックし、Upgrade を選択します。

7. Helm 設定を編集するには、Form view または YAML view のいずれかを使用します。

   • Form view を使用する場合

     1. Root Schema Backstage chart schema Backstage parameters Extra app configuration files to inline into command arguments を展開します。
     2. Add Extra app configuration files to inline into command arguments リンクをクリックします。

     3. 以下のフィールドに値を入力します。

        • configMapRef: app-config-rhdh
        • filename: app-config-rhdh.yaml
     4. Upgrade をクリックします。

   • YAML view を使用する場合

     1. 以下のように upstream.backstage.extraAppConfig.configMapRef パラメーターおよび upstream.backstage.extraAppConfig.filename パラメーターの値を設定します。

        # ... other Red Hat Developer Hub Helm Chart configurations
        upstream:
          backstage:
            extraAppConfig:
              - configMapRef: app-config-rhdh
                filename: app-config-rhdh.yaml
        # ... other Red Hat Developer Hub Helm Chart configurations

     2. Upgrade をクリックします。

手順

1. OpenShift Container Platform Web コンソールの Developer パースペクティブから Topology ビューを選択し、Developer Hub Pod の Open URL アイコンをクリックして、Developer Hub の外部 URL <RHDH_URL> を特定します。
2. OpenShift Container Platform Web コンソールの Developer パースペクティブから、ConfigMaps ビューを選択します。
3. Create ConfigMap をクリックします。

4. Configure via で YAML view オプションを選択し、次の例をベーステンプレートとして使用して、app-config-rhdh.yaml などの ConfigMap オブジェクトを作成します。

   kind: Backstage
   apiVersion: rhdh.redhat.com/v1alpha1
   metadata:
     name: app-config-rhdh
   data:
     "app-config-rhdh.yaml": |
       app:
         title: Red Hat Developer Hub
         baseUrl: <RHDH_URL> 

   1

   
       backend:
         auth:
           keys:
             - secret: "${BACKEND_SECRET}" 

   2

   
         baseUrl: <RHDH_URL> 

   3

   
         cors:
           origin: <RHDH_URL> 

   4

   1

   Red Hat Developer Hub インスタンスの外部 URL を設定します。

   2

   OpenShift Container Platform シークレットを公開する環境変数を使用して、必須の Developer Hub バックエンド認証キーを定義します。

   3

   Red Hat Developer Hub インスタンスの外部 URL を設定します。

   4

   Red Hat Developer Hub インスタンスの外部 URL を設定します。

5. Create をクリックします。
6. Secrets ビューを選択します。
7. Create Key/value Secret をクリックします。
8. secrets-rhdh という名前のシークレットを作成します。

9. BACKEND_SECRET という名前のキーと、base64 でエンコードされた文字列を値として追加します。Red Hat Developer Hub インスタンスごとに一意の値を使用します。たとえば、次のコマンドを使用してターミナルからキーを生成できます。

   node -p 'require("crypto").randomBytes(24).toString("base64")'

10. Create をクリックします。
11. Topology ビューを選択します。

12. 使用する Red Hat Developer Hub インスタンスのオーバーフローメニューをクリックし、Edit Backstage を選択して、Red Hat Developer Hub インスタンスの YAML ビューを読み込みます。

    

13. CR で、spec.application.appConfig.configMaps フィールドの値としてカスタムアプリケーション設定の config map の名前を入力し、spec.application.extraEnvs.secrets フィールドの値としてシークレットの名前を入力します。以下に例を示します。

    apiVersion: rhdh.redhat.com/v1alpha1
    kind: Backstage
    metadata:
      name: developer-hub
    spec:
      application:
        appConfig:
          mountPath: /opt/app-root/src
          configMaps:
             - name: app-config-rhdh
        extraEnvs:
          secrets:
             - name: secrets-rhdh
        extraFiles:
          mountPath: /opt/app-root/src
        replicas: 1
        route:
          enabled: true
      database:
        enableLocalDb: true

14. Save をクリックします。
15. Topology ビューに戻り、Red Hat Developer Hub Pod が起動するまで待ちます。
16. Open URL アイコンをクリックして、Red Hat Developer Hub プラットフォームを使用し、設定変更を行います。