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 バージョンを確認してください。
| 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 モードでインストールされます。 アドバンスモードを使用する場合は、アドオンをインストールした後、 オプションの手順を 完了する必要があります。
開始前に
アドオンをインストールする前に、以下の手順を完了してください。
-
アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。
-
オプション :まだお持ちでない場合は、 VPC Public Gateway を作成して ください。
-
OpenShift Pipelines、 Node Feature Discovery、または NVIDIA GPU オペレータを OpenShift AI アドオンと共に使用する場合は、クラスタで OperatorHub を有効にし、送信トラフィック保護を無効にする必要があります。 それらの演算子を使用したくない場合は、このステップをスキップしてください。
- クラスタで OperatorHub を有効にします。
oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'- 送信トラフィック保護を無効にする。
送信トラフィック保護を無効にすると、すべての外部ネットワーク接続が許可されます。 詳細は 、「VPCクラスターにおける送信トラフィック保護の管理 」を参照してください。
ibmcloud oc vpc outbound-traffic-protection disable --cluster CLUSTER
前提条件
アドオンをインストールする前に、以下の手順を完了してください。
-
アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。
-
オプション :まだお持ちでない場合は、 VPC Public Gateway を作成して ください。
-
OpenShift Pipelines、 Node Feature Discovery、または NVIDIA GPU オペレータを OpenShift AI アドオンと共に使用する場合は、クラスタで OperatorHub を有効にし、送信トラフィック保護を無効にする必要があります。 それらの演算子を使用したくない場合は、このステップをスキップしてください。
- クラスタで OperatorHub を有効にします。
oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'- 送信トラフィック保護を無効にする。
送信トラフィック保護を無効にすると、すべての外部ネットワーク接続が許可されます。 詳細は 、「VPCクラスターにおける送信トラフィック保護の管理 」を参照してください。
- コンソールで Clustersページに移動し、該当するクラスターをクリックします。
- クラスタの[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アドオンをインストールします。
-
クラスターページに移動し、該当するクラスターをクリックします。
-
クラスタの詳細ページで、 アドオンのセクションを見つけます。 Red Hat OpenShift のAI オプションを見つけ、 インストールをクリックします。
-
「機能」セクションで、利用可能なアドオンカスタマイズオプションの説明を確認し、インストールに含めるオプションを有効にします。
-
追加推奨オペレータセクションで、各オペレータをクリックして展開し、追加するカスタマイズオプションを選択します。 これらの追加オペレーターとカスタマイズは、特定の Red Hat OpenShift AI機能に推奨されます。 これらのオプションは、 OperatorHub を使用するか、またはオペレータ固有のインストール手順に従うことで、後からインストールすることができます。
お客様は、これらのオペレータの管理責任を負うものとし、これにはアップデート、監視、復旧、再インストールなどが含まれますが、これらに限定されません。
-
**「インストール」**をクリックします。
ステップ4: OpenShift AIダッシュボードにアクセスする
OpenShift AIアドオンをインストールすると、 OpenShift AIダッシュボードにアクセスできます。
- クラスタの概要ページから、「 OpenShift 」Webコンソールをクリックします。
- Application launcher
、 Red Hat OpenShift AI dashboardオプションを選択します。
- プロンプトが表示されたら、
Log in with OpenShiftをクリックします。
オプションアドバンスモードでKServeを設定する
KServeをアドバンスモードで使用する場合は、以下の手順を完了する必要があります。
- OperatorHub から OpenShift Serverless Operator をインストールしてください。
- OperatorHub から OpenShift Service Mesh Operator をインストールしてください。
- データ・サイエンス・クラスタの初期化CRで、サービス・メッシュの管理状態を
Managed。serviceMesh: controlPlane: metricsCollection: Istio name: data-science-smcp namespace: istio-system managementState: Managed - データ・サイエンス・クラスタのカスタム・リソースで、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 セクションに含まれている。
| カスタマイズ | CLIパラメータ | 説明 | 値 | デフォルト値 |
|---|---|---|---|---|
| OpenShift AIプラットフォームのマイナーアップデートおよびパッチアップデートの承認方針 | oaiInstallPlanApproval |
マイナーアップデートとパッチアップデートを自動または手動で適用します。 | AutomaticまたはManual |
Automatic |
| OpenShift AI削除ポリシー | oaiDeletePolicy |
アドオンを削除する場合は、アドオンによってインストールされたオペレータまたはコンポーネントを保持するか削除します。 | RetainまたはDelete |
Retain |
| データハブダッシュボードを開く | oaiDashboard |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
Managed (有効) |
| クエ | oaiKueue |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
Managed (有効) |
| CodeFlare | oaiCodeflare |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
Managed (有効) |
| ModelMesh サービング | oaiModelmeshserving |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
Managed (有効) |
| ワークベンチ | oaiWorkbenches |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
Managed (有効) |
| データサイエンスパイプライン | oaiDataSciencePipelines |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
Managed (有効) |
| Kサーブ | oaiKserve |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
Managed (有効) |
| Ray | oaiRay |
コンポーネントを有効または無効にします。 有効化されている場合、 OpenShift AIプラットフォームによって管理されます。 | ManagedRemoved を有効にするには無効にする |
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 によってのみ変更可能です。
| カスタマイズ | 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 を編集することで、これらの設定を変更できます。
| カスタマイズ | 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 |
次のステップ
- OpenShift AIを使った不正検知のチュートリアルをお試しください。
- InstructLab で学習させたモデルを、 OpenShift AI を使って展開する 方法をご紹介します。
- OpenShift AIアドオンの管理 に関する情報をご覧ください。
- OpenShift AIアドオンの アップデートプロセスを 理解していることを確認してください。