モデルレジストリーの使用

手順

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

2. ドロップダウンリストで、管理者によって設定された利用可能なカタログソースを選択します。デフォルトでは、Default Catalog が表示されます。

   注記

   OpenShift クラスター管理者は、追加のモデルカタログソースを設定できます。詳細は、Kubeflow Model Registry コミュニティードキュメントの Configuring Catalog Sources を参照してください。

3. 検索バーを使用してカタログ内のモデルを検索します。モデル名、説明、またはプロバイダーを入力して検索できます。
4. Model details ページを表示するには、モデルの名前をクリックします。
5. Register model をクリックします。
6. Model registry ドロップダウンリストから、モデルを登録するモデルレジストリーを選択します。

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

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

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

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

手順

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

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

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

4. Versions タブをクリックし、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. Overview タブでは、ラベル、説明、所有者、モデル ID、最終変更タイムスタンプと作成タイムスタンプ、カスタムプロパティーなどのモデルメタデータと、最新バージョンおよびデプロイメントを表示できます。
   2. Versions タブでは、モデルの登録済みバージョンを表示できます。
   3. Deployments タブでは、このモデルのモデルレジストリーから開始されたデプロイメントを表示できます。

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンリストから、表示するモデルバージョンが含まれているモデルレジストリーを選択します。
3. モデルの名前をクリックすると、Model details ページの Overview タブが表示されます。ここには、最新のモデルバージョンとデプロイメントが含まれています。

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

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

5. 検索バーを使用してリスト内のバージョンを検索します。デフォルトでは、モデル名、説明、またはラベルを入力することで、キーワードによるフィルタリングができます。または、検索バーのドロップダウンリストをクリックして Author を選択し、モデルの所有者を入力してフィルタリングすることもできます。

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

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

7. Details タブでは、ラベル、説明、カスタムプロパティー、バージョン ID、作成者、最終変更タイムスタンプと登録タイムスタンプなどの Version details メタデータを表示できます。これには、モデルの登録元、モデルの場所、モデル形式の情報も含まれます。

   また、Model details をクリックすると、ラベル、説明、所有者、モデル ID、最終変更タイムスタンプと作成タイムスタンプ、カスタムプロパティーなどのバージョン以外のメタデータを表示することもできます。

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

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

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

手順

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

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

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

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

      ヒント

      プロパティー値を URL として入力すると、クリック可能なリンクとして Properties セクションに表示されます (例: https://www.apache.org/licenses/LICENSE-2.0)。

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

手順

1. OpenShift AI ダッシュボードから、Models → Model registry をクリックします。
2. Model registry ドロップダウンリストから、編集するモデルバージョンが含まれているモデルレジストリーを選択します。
3. Model details ページを表示するには、モデルの名前をクリックします。
4. 利用可能なモデルバージョンを表示するには、Versions タブをクリックします。
5. バージョン名をクリックすると、Version details ページが表示されます。

6. Version details セクションでは、バージョンのメタデータを編集できます。

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

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

      ヒント

      プロパティー値を URL として入力すると、クリック可能なリンクとして Properties セクションに表示されます (例: https://www.apache.org/licenses/LICENSE-2.0)。

      1. 既存のプロパティーを編集するには、プロパティーの横にあるアクションメニュー (⋮) をクリックし、Edit をクリックします。
      2. プロパティーを削除するには、プロパティーの横にあるアクションメニュー (⋮) をクリックし、Delete をクリックします。
   4. Model format セクションで、Edit をクリックして、モデルバージョンの形式 (例: ONNX) を編集します。
   5. Model format version セクションで、Edit をクリックして、モデルバージョンの形式バージョンを編集します。

手順

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 フィールドに、モデルデプロイメントの一意の名前を入力します。このフィールドには、デフォルトでモデル名を含む値が自動入力されます。

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

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

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

手順

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

2. ドロップダウンリストで、管理者によって設定された利用可能なカタログソースを選択します。デフォルトでは、Default Catalog が表示されます。

   注記

   OpenShift クラスター管理者は、追加のモデルカタログソースを設定できます。詳細は、Kubeflow Model Registry コミュニティードキュメントの Configuring Catalog Sources を参照してください。

3. 検索バーを使用してカタログ内のモデルを検索します。モデル名、説明、またはプロバイダーを入力して検索できます。
4. Model details ページを表示するには、モデルの名前をクリックします。
5. Deploy model をクリックすると、Deploy model ダイアログが表示されます。

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

   注記

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

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

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

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

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

      重要

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

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

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

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

      注記

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

8. Deployment mode リストから、KServe RawDeployment または Knative Serverless を選択します。デプロイメントモードの詳細は、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 をクリックし、別のサービスアカウント名を入力します。
9. Source model location セクションで Current URI を選択し、カタログから選択したモデルをデプロイします。

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

    1. Additional serving runtime arguments の値を変更して、デプロイされるモデルの動作を定義します。
    2. モデルの環境内の変数を定義するには、Additional environment variables の値を変更します。
11. 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 をクリックします。

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