OpenShift Container Platform への Red Hat Developer Hub のインストール

手順

1. OpenShift Container Platform コンソールのナビゲーションメニューで、Operators > OperatorHub をクリックします。
2. Filter by keyword ボックスに Developer Hub と入力し、Red Hat Developer Hub Operator カードをクリックします。
3. Red Hat Developer Hub Operator ページで、Operator に関する情報を読み、Install をクリックして Install Operator ページを開きます。

4. Operator が正常にインストールされた後に、カスタム設定をプロビジョニングします。

   Developer Hub インスタンスを作成する前に、プロジェクトで必要な設定マップおよびシークレットリソースを作成する必要があります。これらには、baseUrl および service-to-service 認証シークレットが含まれます。

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

5. Update channel ドロップダウンメニューから、使用する更新チャネルを選択します（例： fast または fast- 1.5）。

   重要

   fast チャネルには、特定のバージョンで利用可能なすべての更新が含まれます。更新により、Red Hat Developer Hub のデプロイメントに予期しない変更が生じる可能性があります。リリースノートで、重大である可能性のある変更の詳細を確認してください。

   fast-1.5 チャネルは、バージョン 1.5.1 から 1.5.2 への更新など、z-stream 更新のみを提供します。今後 Red Hat Developer Hub y-version を更新する場合（たとえば、1.5 から {product-version-next} に更新）、fast-{product-version-next} チャネルに手動で切り替える必要があります。

6. Version ドロップダウンメニューから、インストールする Red Hat Developer Hub Operator のバージョンを選択します。デフォルトのバージョンは、選択したチャネルで利用可能な最新バージョンです。

7. Operator の インストールモード を選択します。

   注記

   デフォルトでは、All namespaces on the cluster (default) オプションが選択されています。Specific namespace on the cluster オプションは現在サポートされていません。

8. Installed Namespace フィールドで、次のいずれかのアクションを実行します。

   • Operator recommended Namespace を選択し、rhdh-operator namespace を作成して使用します。このオプションはデフォルトで選択されます。

   • 代替の namespace を使用するには、Select a Namespace を選択します。

     • Select Project ドロップダウンメニューから、次のいずれかのアクションを実行します。

       • 既存のプロジェクトを選択します。

       • Operator の新しいプロジェクトを作成するには、Create Project を選択します。

         • Create Project ダイアログで、必須フィールドにテキストを入力し、Create をクリックします。

           重要

           セキュリティーを強化し、Operator のライフサイクルをより適切に制御し、潜在的な権限昇格を防止するために、専用のデフォルトの rhdh-operator namespace に Red Hat Developer Hub Operator をインストールしてください。ロールバインディングまたはクラスターロールバインディングにより、他のユーザーによる Operator リソースへのアクセスを制限できます。

           Operator グループなどの必要なリソースを作成して、Operator を別の namespace にインストールすることもできます。詳細は、カスタム namespace へのグローバル Operator のインストール を参照してください。

           ただし、Red Hat Developer Hub Operator が他の Operator と namespace を共有する場合は、同じ更新ポリシーも共有されるため、更新ポリシーのカスタマイズができなくなります。たとえば、1 つの Operator が手動更新に設定されている場合は、Red Hat Developer Hub Operator 更新ポリシーも手動に設定されます。詳細は、namespace 内の Operator のコロケーション を参照してください。

手順

1. OpenShift Container Platform Web コンソールの Administrator パースペクティブで、Operators > OperatorHub をクリックします。
2. Filter by keyword ボックスに Developer Hub と入力し、Red Hat Developer Hub Operator カードをクリックします。
3. Red Hat Developer Hub Operator ページで、Install をクリックします。

4. Install Operator ページで、Update channel ドロップダウンメニューを使用して、使用する更新チャネルを選択します。

   • fast チャネルは、バージョン 1.1 から 1.2 への更新、または 1.1.0 から 1.1.1 への更新など、y-stream (x.y) および z-stream (x.y.z) の更新を提供します。

     重要

     fast チャネルには、特定のバージョンで利用可能なすべての更新が含まれます。更新により、Red Hat Developer Hub のデプロイメントに予期しない変更が生じる可能性があります。リリースノートで、重大である可能性のある変更の詳細を確認してください。

   • fast-1.1 チャネルは、バージョン 1.1.1 から 1.1.2 への更新など、z-stream の更新のみを提供します。将来、Red Hat Developer Hub の y バージョンを更新する場合 (たとえば、1.1 から 1.2 に更新する場合) は、手動で fast チャネルに切り替える必要があります。

5. Install Operator ページで、Operator の Update approval ストラテジーを選択します。

   • Automatic オプションを選択した場合は、手動による確認不要で Operator が更新されます。
   • Manual オプションを選択した場合は、更新チャネルで新しい更新がリリースされたときに通知が開きます。インストールを開始する前に、管理者が手動で更新を承認する必要があります。
6. Install をクリックします。

手順

1. OpenShift Container Platform Web コンソールで、< {my_product_namespace}> プロジェクトを選択し てから Add をクリックします。
2. Developer Catalog パネルから、Operator Backed をクリックします。
3. Filter by keyword ボックスに Developer Hub と入力し、Red Hat Developer Hub カードをクリックします。

4. 以下のテンプレートを使用してカスタム設定をプロビジョニングします。

   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 という名前の設定マップを使用して、app-config.yaml ファイルとサービス間認証( BACKEND_SECRETなど)の Secret を提供します。

   これらの設定リソースを作成して適用するには、カスタム Red Hat Developer Hub 設定のプロビジョニング で詳細な手順を実行します。

   注記

   app-config-rhdh 設定マップには、カスタマイズした app-config.yaml ファイルが含まれている必要があります。この設定マップはランタイム時に Developer Hub コンテナーにマウントされます。

5. 以下の例のように、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

   注記

   シークレットにサービス間認証に使用する BACKEND_SECRET が含まれていることを確認します。構造とプロビジョニングの手順は、カスタム Red Hat Developer Hub 設定のプロビジョニング を 参照してください。

6. Create をクリックします。
7. Backstage カスタムリソースのコンテンツを追加します。
8. Create Backstage ページで Create をクリックします。

1. Topology ビューで Pod をクリックし、Details パネルで Status を確認して、Pod の準備ができていることを確認します。Pod の準備が完了すると、Pod のステータスは Active になります。

2. Topology ビューから、Developer Hub Pod の Open URL アイコンをクリックします。

   

手順

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 インスタンスを設定します。デフォルトでは Form ビューが選択されています。

   • Form view を使用する場合

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

   • 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. 必要に応じて他の値を編集します。

   注記

   ホストに関する情報がコピーされ、Developer Hub バックエンドからアクセスできるようになります。

   OpenShift Container Platform ルートが自動的に生成されると、ルートのホスト値が推測され、同じホスト情報が Developer Hub に送信されます。また、値を使用してホストを手動で設定することで Developer Hub がカスタムドメイン上に存在する場合は、カスタムホストが優先されます。

8. Create をクリックし、データベースと Developer Hub が起動するまで待ちます。

9. Developer Hub プラットフォームの使用を開始するには、Open URL アイコンをクリックします。

   

手順

1. <my-rhdh-project> OpenShift Container Platform プロジェクトを作成してアクティブ化します。

   NAMESPACE=<emphasis><rhdh></emphasis>
   oc new-project ${NAMESPACE} || oc project ${NAMESPACE}

2. Red Hat Developer Hub Helm チャートをインストールします。

   helm upgrade redhat-developer-hub -i https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.5.3/redhat-developer-hub-1.5.3.tgz

3. OpenShift Container Platform クラスターの Developer Hub データベースパスワードとルーターベース URL の値を使用して、Developer Hub Helm チャートのインスタンスを設定します。

   PASSWORD=$(oc get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d)
   CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//')
   helm upgrade redhat-developer-hub -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.5.3/redhat-developer-hub-1.5.3.tgz" \
       --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \
       --set global.postgresql.auth.password="$PASSWORD"

4. 実行中の Developer Hub インスタンスの URL を表示します。

   echo "https://redhat-developer-hub-$NAMESPACE.$CLUSTER_ROUTER_BASE"