Red Hat OpenShift AIアドオンのインストール

既存のクラスタに OpenShift AIアドオンをインストールするには、以下の手順に従います。

新しいクラスターに OpenShift AIオペレーターを展開しますか? 展開可能な IBM Cloud アーキテクチャでAI OpenShift を試してみてください。

最小要件

アドオンを設定する前に、以下の点を確認してください。

  • サポートされるクラスタアドオンのバージョンを 確認し、クラスタにインストールするアドオンのバージョンを決定します。
  • クラスタには、少なくとも2つのワーカーノードが必要です。 各ワーカーノードには、最低でも 8vCPU と 32GB メモリが必要です。
  • ワーカーノードはRHCOSオペレーティングシステムを使用する必要があります。
  • 必要なオペレータをインストールするには、クラスタからの送信トラフィックを許可する必要があります。

サポートされるバージョン

サポートされる OpenShift AI アドオンのバージョンと、対応する OpenShift AI およびバージョンを確認する。 Red Hat OpenShift on IBM Cloud バージョンを確認してください。

サポートされるAIアドオンのバージョンと、 Red Hat OpenShift AIと対応するバージョン Red Hat OpenShift on IBM Cloud.
OpenShift AIアドオン版 Red Hat OpenShift AI版 対応クラスタバージョン
420 3.4.2 420,421
419 3.4.0 4.19, 4.20, 4.21
418 2.25.6 4.18, 4.19
417 2.25.6 4.17, 4.18
416 2.25.6 4.16, 4.17

バージョン418から419へのアップグレードはサポートされていません。 バージョン419の新規インストールのみが許可されます。 詳細については、 「 OpenShift AI アドオンについて」を 参照してください。

考慮事項

  • OpenShift AIが提供するすべての機能を使用するには、少なくとも1つのGPUを推奨します。
  • クラスタにはGPUノードと非GPUノードを混在させることができます。 ただし、この構成を使用する場合は、GPUノードのリソースを活用するために、必ずアプリをGPUノードにデプロイしてください。
  • OpenShift AI Operatorのバージョン 2.19.0 以降、KServeはアドバンスモードまたはスタンダードモードで利用できます。 デフォルトでは、 IBM Cloud アドオンを使用して OpenShift AI を使用して KServe をインストールすると、Standard モードでインストールされます。 アドバンスモードを使用する場合は、アドオンをインストールした後、 オプションの手順を 完了する必要があります。

開始前に

アドオンをインストールする前に、以下の手順を完了してください。

  1. アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

  2. オプション :まだお持ちでない場合は、 VPC Public Gateway を作成して ください。

  3. OpenShift Pipelines、 Node Feature Discovery、または NVIDIA GPU オペレータを OpenShift AI アドオンと共に使用する場合は、クラスタで OperatorHub を有効にし、送信トラフィック保護を無効にする必要があります。 それらの演算子を使用したくない場合は、このステップをスキップしてください。

    1. クラスタで OperatorHub を有効にします。
    oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'
    
    1. 送信トラフィック保護を無効にする。

    送信トラフィック保護を無効にすると、すべての外部ネットワーク接続が許可されます。 詳細は 、「VPCクラスターにおける送信トラフィック保護の管理 」を参照してください。

    ibmcloud oc vpc outbound-traffic-protection disable --cluster CLUSTER
    

前提条件

アドオンをインストールする前に、以下の手順を完了してください。

  1. アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

  2. オプション :まだお持ちでない場合は、 VPC Public Gateway を作成して ください。

  3. OpenShift Pipelines、 Node Feature Discovery、または NVIDIA GPU オペレータを OpenShift AI アドオンと共に使用する場合は、クラスタで OperatorHub を有効にし、送信トラフィック保護を無効にする必要があります。 それらの演算子を使用したくない場合は、このステップをスキップしてください。

    1. クラスタで OperatorHub を有効にします。
    oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'
    
    1. 送信トラフィック保護を無効にする。

    送信トラフィック保護を無効にすると、すべての外部ネットワーク接続が許可されます。 詳細は 、「VPCクラスターにおける送信トラフィック保護の管理 」を参照してください。

    1. コンソールで Clustersページに移動し、該当するクラスターをクリックします。
    2. クラスタの[Overview]ページで[ Networking] セクションを見つけ、[ Outbound traffic protection disabled ]オプションを選択します。

ステップ1:カスタマイズオプションを選択

ポータブルな機械学習ワークフローを構築するためのデータパイプラインや、リソースを管理および拡張するためのツールなど、アドオンのインストールに含めるさまざまなオプションを指定することで、 Red Hat OpenShift AI プロジェクトを強化できます。 アップグレードポリシーと削除ポリシーもカスタマイズできます。 利用可能な各オプションの説明については、 OpenShift AIカスタマイズオプションを 参照してください。 アドオンをインストールする際に特定のオプションを指定しない場合、デフォルト値が適用されます。 これらのオプションは、 Red Hat OpenShift AIプラットフォームによって管理される。

CLIでコマンドを実行し、すべてのオプションをリストアップする。 UIでは、これらのオプションはインストール中に Capabilities セクションにリストされます。

ibmcloud oc cluster addon options --addon openshift-ai

ステップ2:追加の推奨オペレーターを確認する

特定の OpenShift AI機能を使用する際に推奨される追加の演算子をインストールすることもできます。 クラスタにまだインストールされていない場合は、アドオンインストールに含めることができます。 または、 OperatorHub をご利用いただくか、オペレータ固有のインストール手順に従って、いつでもインストールすることができます。 これらのオペレータを使用するには、クラスタの 送信トラフィック保護を無効にする 必要があります。

お客様は、これらのオペレータの管理責任を負うものとし、これにはアップデート、監視、復旧、再インストールなどが含まれますが、これらに限定されません。

以下の演算子の使用をお勧めします。

これらのオペレータの中には、アドオンをインストールする際に指定できる追加のカスタマイズが含まれている場合があります。 推奨オペレータで利用可能なカスタマイズ の一覧を確認してください。

ステップ 3: CLI にアドオンをインストールする

Red Hat OpenShift AIアドオンをインストールするには、コマンドを実行します。 カスタマイズ を指定する際は、 --parameter PARAM=VALUE の形式を使用してください。 例えば、Data Science Pipelinesオプションを含めるには、 --parameter oaiDataSciencePipelines=Managed を指定します。

CLIでアドオンをインストールする際に推奨されるオペレータを含めるには、インストールコマンドを実行する際に次のオプションを指定します。

  • OpenShift パイプライン: --parameter pipelineEnabled=true
  • Node 機能の発見: --parameter nfdEnabled=true
  • NVIDIA GPUオペレーター: --parameter nvidiaEnabled=true

利用可能なバージョンのリストについては、 サポートされているバージョンを 参照してください。

インストールコマンド。

ibmcloud oc cluster addon enable openshift-ai --cluster CLUSTER [-f] [--param PARAM] [-q] [--version VERSION]

自動マイナーアップデートとパッチアップデート、 CodeFlare,、KServeを有効にしてアドオンをインストールするコマンドの例。

ibmcloud oc cluster addon enable openshift-ai --cluster CLUSTER --param oaiInstallPlanApproval=Automatic --param oaiCodeflare=Managed --param oaiKserve=Managed

ステップ2:追加の推奨オペレーターを確認する

特定の OpenShift AI機能を使用する際に推奨される追加の演算子をインストールすることもできます。 クラスタにまだインストールされていない場合は、アドオンインストールに含めることができます。 または、 OperatorHub をご利用いただくか、オペレータ固有のインストール手順に従って、いつでもインストールすることができます。 これらのオペレータを使用するには、クラスタの 送信トラフィック保護を無効にする 必要があります。

お客様は、これらのオペレータの管理責任を負うものとし、これにはアップデート、監視、復旧、再インストールなどが含まれますが、これらに限定されません。

以下の演算子の使用をお勧めします。

これらのオペレータの中には、アドオンをインストールする際に指定できる追加のカスタマイズが含まれている場合があります。 推奨オペレータで利用可能なカスタマイズ の一覧を確認してください。

ステップ3:UIでアドオンをインストールする

UIとともに Red Hat OpenShift AIアドオンをインストールします。

  1. クラスターページに移動し、該当するクラスターをクリックします。

  2. クラスタの詳細ページで、 アドオンのセクションを見つけます。 Red Hat OpenShift のAI オプションを見つけ、 インストールをクリックします。

  3. 「機能」セクションで、利用可能なアドオンカスタマイズオプションの説明を確認し、インストールに含めるオプションを有効にします。

  4. 追加推奨オペレータセクションで、各オペレータをクリックして展開し、追加するカスタマイズオプションを選択します。 これらの追加オペレーターとカスタマイズは、特定の Red Hat OpenShift AI機能に推奨されます。 これらのオプションは、 OperatorHub を使用するか、またはオペレータ固有のインストール手順に従うことで、後からインストールすることができます。

    お客様は、これらのオペレータの管理責任を負うものとし、これにはアップデート、監視、復旧、再インストールなどが含まれますが、これらに限定されません。

  5. **「インストール」**をクリックします。

ステップ4: OpenShift AIダッシュボードにアクセスする

OpenShift AIアドオンをインストールすると、 OpenShift AIダッシュボードにアクセスできます。

  1. クラスタの概要ページから、「 OpenShift 」Webコンソールをクリックします。
  2. Application launcher Application launcherRed Hat OpenShift AI dashboardオプションを選択します。
  3. プロンプトが表示されたら、 Log in with OpenShift をクリックします。

オプションアドバンスモードでKServeを設定する

KServeをアドバンスモードで使用する場合は、以下の手順を完了する必要があります。

  1. OperatorHub から OpenShift Serverless Operator をインストールしてください。
  2. OperatorHub から OpenShift Service Mesh Operator をインストールしてください。
  3. データ・サイエンス・クラスタの初期化CRで、サービス・メッシュの管理状態を Managed
    serviceMesh:
        controlPlane:
            metricsCollection: Istio
            name: data-science-smcp
            namespace: istio-system
        managementState: Managed
    
  4. データ・サイエンス・クラスタのカスタム・リソースで、KServeのサービング管理状態を Managed
    kserve:
        managementState: Managed
        serving:
          managementState: Managed
          name: knative-serving
    

OpenShift AIのカスタマイズオプション

OpenShift AIアドオンの利用可能なカスタマイズオプションを確認してください。 これらのオペレーターは、 Red Hat OpenShift AIプラットフォームによって管理される。

CLIでAIアドオン OpenShift をインストールする際にオプションを含めるには、実行時に --parameter PARAM=VALUE formatオプション ibmcloud oc cluster addon enable openshift-aiを指定してください。 例えば、Data Science Pipelines オプション付きのアドオンをインストールするには、 --parameter oaiDataSciencePipelines=Managed を指定します。

AIアドオン OpenShift をUIと共にインストールする 際にオプションを含めるには、プロンプトが表示されたらクリックしてオプションを有効にしてください。 これらのオプションは Capabilities セクションに含まれている。

OpenShift AIアドオンのカスタマイズオプションとCLIパラメータ。
カスタマイズ CLIパラメータ 説明 デフォルト値
OpenShift AIプラットフォームのマイナーアップデートおよびパッチアップデートの承認方針 oaiInstallPlanApproval マイナーアップデートとパッチアップデートを自動または手動で適用します。 AutomaticまたはManual Automatic
OpenShift AI削除ポリシー oaiDeletePolicy アドオンを削除する場合は、アドオンによってインストールされたオペレータまたはコンポーネントを保持するか削除します。 RetainまたはDelete Retain
データハブダッシュボードを開く oaiDashboard コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)
クエ oaiKueue コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)
CodeFlare oaiCodeflare コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)
ModelMesh サービング oaiModelmeshserving コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)
ワークベンチ oaiWorkbenches コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)
データサイエンスパイプライン oaiDataSciencePipelines コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)
Kサーブ oaiKserve コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)
Ray oaiRay コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 Managed
Removed を有効にするには無効にする
Managed (有効)

その他の推奨オペレーター

インストール時に追加できる 推奨オペレータ とオプションのカスタマイズを確認します。 お客様は、これらのオペレータの管理責任を負うものとし、これにはアップデート、監視、復旧、再インストールなどが含まれますが、これらに限定されません。

CLIでAI OpenShift アドオンをインストール する際にオペレータのカスタマイズを含めるには、を実行する際にオプションを形式 --parameter PARAM=VALUE``ibmcloud oc cluster addon enable openshift-ai で指定してください。 たとえば、演算 NVIDIA 子に対して GPUDirect Storage NVIDIA のカスタマイズを含めるには、 を指定します --parameter nvidiaGpuDirectStorageEnabled=true

AIアドオン OpenShift をUIと共にインストール する際、オペレーター向けのカスタマイズを含めるには、プロンプトが表示された際にオプションをクリックして有効にしてください。 なお、デフォルト設定を持つ追加 NVIDIA のオペレータが存在し、これらはCLIでのみ変更可能、または設定ファイルを編集すること ClusterPolicy によってのみ変更可能です。

OpenShift 追加オペレーターのためのAIアドオン・カスタマイズ・オプション。 これらの設定は、インストール中にCLIまたはUIで変更できる。
カスタマイズ CLIパラメータ 説明 デフォルト設定
Node フィーチャーディスカバリー削除ポリシー nfdDeletePolicy OpenShift AIアドオンを削除する場合は、演算子を保持するか削除します。 Retain (デフォルト)または Delete Retain
NVIDIA GPUオペレータ削除ポリシー nvidiaDeletePolicy OpenShift AIアドオンを削除する場合は、演算子を保持するか削除します。 Retain (デフォルト)または Delete Retain
NVIDIA CUDAポストインストールテスト nvidiaCudaTest NVIDIA CUDA テストを有効にします。 true (有効、デフォルト)
false (無効)
false (無効)
パイプライン・オペレーターの削除ポリシー pipelineDeletePolicy OpenShift AIアドオンを削除する場合は、演算子を保持するか削除します。 Retain (デフォルト)または Delete

以下の NVIDIA GPUオペレーターは、デフォルト設定で適用されます。 CLIを使用してアドオンをインストールする場合のみ、インストール中にこれらの設定を変更できます。 インストール後、UI または CLI のいずれかで、 ClusterPolicy を編集することで、これらの設定を変更できます。

OpenShift 追加オペレーターのためのAIアドオン・カスタマイズ・オプション。 これらの設定は、CLIでのみインストール中に変更できます。
カスタマイズ CLIパラメータ 説明 CLIの値 UIデフォルト設定
NVIDIA サンドボックスのワークロード nvidiaSandboxWorkloads サンドボックスの作業負荷に必要な追加オペランドの管理を有効にします。 true (有効、デフォルト)
false (無効)
Enabled
NVIDIA vGPU マネージャー nvidiaVgpuManagerEnabled NVIDIA vGPU Managerを有効にする。 true (有効、デフォルト)
false (無効)
Enabled
NVIDIA GPUDirectストレージ nvidiaGpuDirectStorageEnabled GPUDirectストレージを有効にする。 true (有効、デフォルト)
false (無効)
Enabled
NVIDIA Node ステータス・エクスポーター nvidiaNodeStatusExporterEnabled 「 Node ステータスエクスポーター」を有効にします。 true (有効、デフォルト)
false (無効)
Enabled
NVIDIA 仮想関数 I/O マネージャー nvidiaVfioManagerEnabled VFIO-PCIを展開するためのコンフィギュレーションでVFIO Managerを有効にする。 true (有効、デフォルト)
false (無効)
Enabled
NVIDIA サンドボックス・デバイス・プラグイン nvidiaSandboxDevicePluginEnabled NVIDIA Sandbox Device Plug-inを有効にする。 true (有効、デフォルト)
false (無効)
Enabled
NVIDAマルチインスタンスGPUマネージャ nvidiaMigManagerEnabled NVIDIA Multi Instance GPU Managerを有効にする。 true (有効、デフォルト)
false (無効)
Enabled
NVIDIA データセンターGPU Managerホストエンジンの導入 nvidiaDcgmEnabled NVIDIA Data Center GPU Manager Hostengine を別のポッドとして展開できるようにします。 true (有効、デフォルト)
false (無効)
Enabled
NVIDIA vGPU デバイスマネージャー nvidiaVgpuDeviceManagerEnabled NVIDIA vGPU デバイスマネージャーを有効にします。 true (有効、デフォルト)
false (無効)
Enabled

次のステップ