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 インスタンスを作成する前に、プロジェクトに必要な config map とシークレットリソースを作成する必要があります。これらには、baseUrl とサービス間認証シークレットが含まれます。

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

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

   重要

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

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

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 のコロケーション を参照してください。

9. Operator の Update approval 方法を選択します。

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

10. Install をクリックします。

    注記

    手動 の承認ストラテジーを選択している場合、サブスクリプションのアップグレードステータスは、そのインストール計画を確認し、承認するまで Upgrading のままになります。Install Plan ページで Approve をクリックすると、サブスクリプションのアップグレードステータスが Up to date に変わります。

    自動 の承認ストラテジーを選択している場合、アップグレードステータスは、介入なしに Up to date に解決するはずです。

手順

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

   これらの設定リソースを作成して適用するには、完全な手順が記載されている カスタム Red Hat Developer Hub 設定のプロビジョニング の手順に従ってください。

   注記

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

5. 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

   注記

   シークレットに、サービス間認証に使用される 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.6.3/redhat-developer-hub-1.6.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.6.3/redhat-developer-hub-1.6.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"