モデルレジストリーの操作

手順

1. OpenShift AI ダッシュボードから、Models → Model catalog をクリックします。

2. Red Hat models セクションから、登録するモデルの名前をクリックします。

   モデルの詳細ページが開きます。

3. Register model をクリックします。

4. Model details セクションで、モデルの全バージョンに適用する詳細を設定します。

   1. オプション: Model name フィールドに、モデルの特定の名前を入力します。
   2. オプション: Model description フィールドで、モデルの説明を更新します。

5. Version details セクションに、モデルの最初のバージョンに適用する詳細を入力します。

   1. Version name フィールドに、モデルバージョンの名前を入力します。
   2. オプション: Version description フィールドに、モデルの最初のバージョンの説明を入力します。
   3. Source model format フィールドに、モデル形式の名前 (例: onnx) を入力します。
   4. Source model format version フィールドに、モデル形式のバージョンを入力します。
6. Model location セクションに、モデルの URI が表示されます。
7. Register model をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューで、モデルの登録先となるモデルレジストリーを選択します。

3. Model name 列で、新しいバージョンを登録するモデルの名前をクリックします。

   モデルの詳細ページが開きます。

4. Register new version をクリックします。

5. Version details セクションに、モデルの最初のバージョンに適用する詳細を入力します。

   1. Version name フィールドに、モデルバージョンの名前を入力します。
   2. オプション: Version description フィールドに、モデルの最初のバージョンの説明を入力します。
   3. Source model format フィールドに、モデル形式の名前 (例: onnx) を入力します。
   4. Source model format version フィールドに、モデル形式のバージョンを入力します。

6. Model location セクションで、オブジェクトストレージの詳細または URI を指定して、モデルの場所を指定します。

   1. オブジェクトストレージの詳細を指定するには、Object storage ラジオボタンが選択されていることを確認します。

      1. 既存の接続の詳細を自動入力するには、次の手順を実行します。

         1. Autofill from connection をクリックします。
         2. Autofill from connection ダイアログが開きます。このダイアログで、Project ドロップダウンリストから、目的の接続を含むデータサイエンスプロジェクトを選択します。

         3. Connection name ドロップダウンリストから、使用する接続を選択します。

            このリストには、バケットを含むオブジェクトストレージタイプのみが含まれます。

         4. Autofill をクリックします。

      2. または、オブジェクトストレージの詳細を手動で入力します。

         1. Endpoint フィールドに、S3 互換オブジェクトストレージバケットのエンドポイントを入力します。
         2. Bucket フィールドに、S3 互換のオブジェクトストレージバケットの名前を入力します。
         3. Region フィールドに、S3 互換オブジェクトストレージアカウントのリージョンを入力します。
         4. Path フィールドに、モデルまたはフォルダーへのパスを入力します。このパスは、ルートフォルダーを指すことはできません。

   2. URI を指定するには、URI ラジオボタンが選択されていることを確認します。

      1. URI フィールドに、モデルの URI を入力します。

         重要

         URI を使用して登録されたモデルのデプロイメントは、現在、パブリック OCI リポジトリーでのみサポートされています。

7. Register new version をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューから、表示するモデルが含まれているモデルレジストリーを選択します。

3. Model registry ページには、モデル名、ラベル、最終変更タイムスタンプ、各モデルの所有者など、登録済みモデルの概要が表示されます。

   デフォルトでは、モデルは 最終変更 タイムスタンプで並べ替えられます。

4. 検索バーを使用してリスト内のモデルを検索します。デフォルトのキーワード検索を使用するか、検索バーのドロップダウンメニューをクリックして Owner を選択し、モデル所有者で検索できます。

   キーワードで検索すると、登録されているモデルとそのバージョンの名前、説明、ラベルで検索が実行されます。

5. 詳細を表示するには、モデルの名前をクリックします。

   モデルの詳細ページが開きます。

   1. Versions タブでは、モデルの登録済みバージョンを表示できます。
   2. Details タブでは、モデルの説明、ラベル、カスタムプロパティー、モデル ID、所有者、最終変更日時と作成日時のタイムスタンプを表示できます。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューから、表示するモデルバージョンが含まれているモデルレジストリーを選択します。

3. モデルの名前をクリックすると、そのバージョンが表示されます。

   モデルの詳細ページが開きます。

4. Versions タブでは、モデルの登録済みバージョンを表示できます。

   デフォルトでは、バージョンは 最終更新日時 のタイムスタンプで並べ替えられます。

5. 検索バーを使用してリスト内のバージョンを検索します。デフォルトのキーワード検索を使用するか、検索バーのドロップダウンメニューをクリックして Author を選択し、モデル作成者で検索できます。

   キーワードで検索すると、登録されているモデルとそのバージョンの名前、説明、ラベルで検索が実行されます。

6. 詳細を表示するには、バージョンの名前をクリックします。

   バージョンの詳細ページが開きます。

7. Details タブでは、モデルの説明、ラベル、カスタムプロパティー、バージョン ID、作成者、最終変更日時および登録日時のタイムスタンプを表示できます。モデルのソースモデル形式と場所の情報も表示できます。

8. Deployments タブでは、このバージョンのモデルレジストリーから開始されたデプロイメントを表示できます。

   1. デプロイメントの名前をクリックしてメトリクスページを開きます。

      シングルモデルサービングプラットフォーム上のモデルメトリクスの詳細は、デプロイされたモデルのパフォーマンスメトリクスの表示 を参照してください。マルチモデルサービングプラットフォームのモデルメトリクスの詳細は、マルチモデルサービングプラットフォームのモデルサービングランタイムメトリクスの表示 を参照してください。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューから、編集するモデルが含まれているモデルレジストリーを選択します。
3. Model registry ページには、モデル名、ラベル、最終変更タイムスタンプ、各モデルの所有者など、登録済みモデルの概要が表示されます。

4. 詳細を表示するには、モデルの名前をクリックします。

   モデルの詳細ページが開きます。

5. Details タブでは、モデルのメタデータを編集できます。

   1. Description セクションで、Edit をクリックしてモデルの説明を編集します。
   2. Labels セクションで、Edit をクリックしてモデルのラベルを編集します。

   3. Properties セクションで、Add property をクリックしてモデルに新しいプロパティーを追加します。

      1. 既存のプロパティーを編集するには、プロパティーの横にあるアクションメニュー (⋮) をクリックし、Edit をクリックします。
      2. プロパティーを削除するには、プロパティーの横にあるアクションメニュー (⋮) をクリックし、Delete をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューから、編集するモデルバージョンが含まれているモデルレジストリーを選択します。

3. 詳細を表示するには、モデルの名前をクリックします。

   モデルの詳細ページが開きます。

4. 詳細を表示するには、バージョンの名前をクリックします。

   バージョンの詳細ページが開きます。

5. Details タブでは、バージョンメタデータを編集できます。

   1. Description セクションで、Edit をクリックしてバージョンの説明を編集します。
   2. Labels セクションで、Edit をクリックしてバージョンのラベルを編集します。

   3. Properties セクションで、Add property をクリックしてバージョンに新しいプロパティーを追加します。

      1. 既存のプロパティーを編集するには、プロパティーの横にあるアクションメニュー (⋮) をクリックし、Edit をクリックします。
      2. プロパティーを削除するには、プロパティーの横にあるアクションメニュー (⋮) をクリックし、Delete をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューから、モデルバージョンをデプロイするモデルレジストリーを選択します。

3. Model name 列で、デプロイするバージョンが含まれているモデルの名前をクリックします。

   モデルバージョンの詳細ページが開きます。

4. デプロイするモデルバージョンの横にあるアクションメニュー (⋮) をクリックします。
5. Deploy をクリックします。

6. Deploy model ダイアログで、モデルをデプロイするためのプロパティーを設定します。

   1. Project ドロップダウンリストで、ターゲットプロジェクトを選択します。
   2. Deploy をクリックします。

7. モデルをデプロイするには、次のプロパティーを設定します。

   1. Project ドロップダウンリストで、モデルをデプロイするプロジェクトを選択します。

   2. オプション: Model deployment name フィールドに、モデルデプロイメントの名前を入力します。

      各デプロイメントには、デフォルトで次の形式で名前が付けられます。

      <model name> <model version name> <deployment creation timestamp>

      これは、モデルがデプロイされたときに作成される推論サービスの名前になります。

8. マルチモデルサービングプラットフォームを使用したモデルのデプロイ または シングルモデルサービングプラットフォームへのモデルのデプロイ の説明に従って、モデルをデプロイするための残りのプロパティーを設定します。

   1. Deploy をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model catalog をクリックします。

2. Red Hat models セクションから、デプロイするモデルの名前をクリックします。

   モデルの詳細ページが開きます。

3. Deploy model をクリックします。

   Deploy model ダイアログが開きます。

4. Project ドロップダウンリストで、モデルをデプロイするプロジェクトを選択します。

   注記

   OCI ストレージを使用するモデルは、シングルモデルサービングプラットフォームにのみデプロイできます。マルチモデルサービングプラットフォームを使用するプロジェクトは、プロジェクトリストに表示されません。

5. モデルのデプロイメント セクションでは、次の操作を行います。

   1. オプション: Model deployment name フィールドに、モデルデプロイメントの一意の名前を入力します。Model deployment name には、デフォルトでモデル名を含む値が自動入力されます。

      これは、モデルがデプロイされたときに作成される推論サービスの名前です。

   2. オプション: Edit resource name をクリックし、Resource name フィールドにモデルデプロイメントの特定のリソース名を入力します。デフォルトでは、リソース名はモデルレジストリーの名前と一致します。

      重要

      リソース名は、OpenShift でリソースに付けられるラベルです。リソース名は 253 文字を超えることはできません。小文字の英数字または - で構成され、先頭と末尾は英数字である必要があります。リソース名は作成後に編集できません。

      リソース名は、OpenShift クラスター内の他のモデルデプロイメントリソースの名前と同じにならないようにしてください。

   3. Serving runtime リストから、OpenShift AI デプロイメントにインストールされ有効になっているモデルサービングランタイムを選択します。プロジェクトスコープのランタイムが存在する場合、Serving runtime リストには、グローバルランタイムとプロジェクトスコープのランタイムを区別するためのサブ見出しが含まれます。

   4. Model framework リストから、モデルのフレームワークを選択します。

      注記

      Model framework リストには、モデルをデプロイしたときに指定したモデルサービングランタイムでサポートされているフレームワークのみが表示されます。

6. Deployment mode リストから、Standard または Advanced を選択します。デプロイメントモードの詳細は、KServe デプロイメントモードについて を参照してください。

   1. Number of model server replicas to deploy フィールドに値を指定します。
   2. Model server size リストから値を選択します。

   3. ハードウェアプロファイルを作成した場合は、Hardware profile リストからハードウェアプロファイルを選択します。プロジェクトスコープのハードウェアプロファイルが存在する場合、Hardware profile リストには、グローバルハードウェアプロファイルとプロジェクトスコープのハードウェアプロファイルを区別するためのサブ見出しが含まれます。

      重要

      デフォルトでは、ハードウェアプロファイルはダッシュボードのナビゲーションメニューとユーザーインターフェイスに表示されません。非推奨となったアクセラレータープロファイル機能に関連付けられたユーザーインターフェイスコンポーネントは、引き続き表示されます。ダッシュボードのナビゲーションメニューに Settings → Hardware profiles オプションと、ハードウェアプロファイルに関連付けられたユーザーインターフェイスコンポーネントを表示するには、OpenShift の OdhDashboardConfig カスタムリソース (CR) で、disableHardwareProfiles 値を false に設定します。ダッシュボード設定オプションの設定に関する詳細は、ダッシュボードのカスタマイズ を参照してください。

   4. Model route セクションで、Make deployed models available through an external route チェックボックスをオンにして、デプロイされたモデルを外部クライアントが利用できるようにします。

   5. Token authentication セクションで、Require token authentication チェックボックスをオンにすると、モデルサーバーでトークン認証を必須にできます。トークン認証の設定を完了するには、次のアクションを実行します。

      1. Service account name フィールドに、トークンが生成されるサービスアカウント名を入力します。生成されたトークンは、モデルサーバーの設定時に作成され、Token secret フィールドに表示されます。
      2. 追加のサービスアカウントを追加するには、Add a service account をクリックし、別のサービスアカウント名を入力します。
7. Source model location セクションで Current URI を選択し、カタログから選択したモデルをデプロイします。

8. オプション: Configuration parameters セクションでランタイムパラメーターをカスタマイズします。

   1. Additional serving runtime arguments の値を変更して、デプロイされるモデルの動作を定義します。
   2. モデルの環境内の変数を定義するには、Additional environment variables の値を変更します。
9. Deploy をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューから、編集するモデルが含まれているモデルレジストリーを選択します。

3. 詳細を表示するには、モデルの名前をクリックします。

   モデルの詳細ページが開きます。

4. 削除するデプロイメントのモデルバージョンの名前をクリックします。

   モデルバージョンの詳細ページが開きます。

5. Deployments をクリックします。

6. デプロイメントを削除するには、デプロイメントの横にあるアクションメニュー (⋮) をクリックし、Delete をクリックします。

   Delete deployed model? ダイアログが開きます。

7. テキストフィールドにモデルデプロイメントの名前を入力して、削除を確定します。
8. Delete deployed model をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューで、モデルのアーカイブ先となるモデルレジストリーを選択します。
3. アーカイブするモデルの横にあるアクションメニュー (⋮) をクリックします。
4. Archive model をクリックします。
5. 表示される Archive model? ダイアログで、テキストフィールドにモデルの名前を入力して、アーカイブを確定します。
6. Archive をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューで、モデルのアーカイブ先となるモデルレジストリーを選択します。

3. Model name 列で、アーカイブするバージョンが含まれているモデルの名前をクリックします。

   モデルバージョンの詳細ページが開きます。

4. アーカイブするバージョンの横にあるアクションメニュー (⋮) をクリックします。
5. Archive model version をクリックします。
6. 開いた Archive version? ダイアログで、テキストフィールドにモデルバージョンの名前を入力して、アーカイブを確定します。
7. Archive をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューで、モデルの復元先となるモデルレジストリーを選択します。

3. Register model ドロップダウンメニューの横にあるアクションメニュー (⋮) をクリックし、View archived models をクリックします。

   モデルレジストリーのアーカイブ済みモデルページが開きます。

4. 復元するモデルの横にあるアクションメニュー (⋮) をクリックします。
5. Restore model をクリックします。
6. 表示される Restore model? ダイアログで、Restore をクリックします。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンメニューで、モデルの復元先となるモデルレジストリーを選択します。

3. Model name 列で、復元するバージョンが含まれているモデルの名前をクリックします。

   モデルバージョンの詳細ページが開きます。

4. Register new version ドロップダウンメニューの横にあるアクションメニュー (⋮) をクリックし、View archived versions をクリックします。

   モデルのアーカイブ済みバージョンページが開きます。

5. 復元するバージョンの横にあるアクションメニュー (⋮) をクリックします。
6. Restore version をクリックします。

7. 開いた Restore version? ダイアログで、Restore をクリックします。

   バージョンの詳細ページが開きます。