第2章 Helm チャートを使用した OpenShift Container Platform への Red Hat Developer Hub のインストール
次のいずれかの方法で Helm チャートを使用して、OpenShift Container Platform に Red Hat Developer Hub をインストールできます。
- OpenShift Container Platform コンソール
- Helm CLI
2.1. Helm チャートを使用した OpenShift Container Platform Web コンソールからの Developer Hub のデプロイ リンクのコピーリンクがクリップボードにコピーされました!
Helm チャートを使用して、Red Hat OpenShift Container Platform Web コンソールで Developer Hub をインストールできます。
Helm は、OpenShift Container Platform 上のパッケージマネージャーであり、次の機能を提供します。
- カスタムフックを使用して定期的なアプリケーション更新を適用します。
- 複雑なアプリケーションのインストールを管理します。
- パブリックおよびプライベートサーバーでホストできるチャートを提供します。
- アプリケーションの以前のバージョンへのロールバックをサポートします。
Red Hat Developer Hub の Helm チャートは、OpenShift Dedicated、OpenShift Container Platform の Helm カタログで入手できます。
前提条件
- OpenShift Container Platform アカウントにログインしている。
-
OpenShift Container Platform
adminロールを持つユーザーが、アプリケーションを作成するためにプロジェクト内で適切なロールと権限を設定している。OpenShift Container Platform のロールの詳細は、RBAC を使用して権限を定義および適用する を参照してください。 - OpenShift Container Platform でプロジェクトを作成している。OpenShift Container Platform でプロジェクトを作成する方法の詳細は、Red Hat OpenShift Container Platform のドキュメント を参照してください。
手順
- Developer Hub Web コンソールの Developer パースペクティブから、+Add をクリックします。
- Developer Catalog パネルから、Helm Chart をクリックします。
- Filter by keyword ボックスに Developer Hub と入力し、Red Hat Developer Hub カードをクリックします。
- Red Hat Developer Hub ページで、Create をクリックします。
-
クラスターから、OpenShift Container Platform ルーターホスト (例:
apps.<clusterName>.com) をコピーします。 ラジオボタンを選択して、Form ビューまたは YAML ビューのいずれかを使用して Developer Hub インスタンスを設定します。デフォルトでは Form ビューが選択されています。
Form view を使用する場合
-
Form ビューを使用してインスタンスを設定するには、Root Schema
global Enable service authentication within Backstage instance に移動して、OpenShift Container Platform ルーターホストをフォームのフィールドに貼り付けます。
-
Form ビューを使用してインスタンスを設定するには、Root Schema
YAML view を使用する場合
YAML ビューを使用してインスタンスを設定するには、次の例に示すように、
global.clusterRouterBaseパラメーター値に OpenShift Container Platform ルーターのホスト名を貼り付けます。global: auth: backend: enabled: true clusterRouterBase: apps.<clusterName>.com # other Red Hat Developer Hub Helm Chart configurations
必要に応じて他の値を編集します。
注記ホストに関する情報がコピーされ、Developer Hub バックエンドからアクセスできるようになります。
OpenShift Container Platform ルートが自動的に生成されると、ルートのホスト値が推測され、同じホスト情報が Developer Hub に送信されます。また、値を使用してホストを手動で設定することで Developer Hub がカスタムドメイン上に存在する場合は、カスタムホストが優先されます。
- Create をクリックし、データベースと Developer Hub が起動するまで待ちます。
Developer Hub プラットフォームの使用を開始するには、Open URL アイコンをクリックします。
Developer Hub コンテナーが設定ファイルにアクセスできない場合、developer-hub Pod は CrashLoopBackOff 状態になる可能性があります。このエラーは次のログで示されます。
Loaded config from app-config-from-configmap.yaml, env
...
2023-07-24T19:44:46.223Z auth info Configuring "database" as KeyStore provider type=plugin
Backend failed to start up Error: Missing required config value at 'backend.database.client'
エラーを解決するには、設定ファイルを確認してください。