すべてのプロダクト
Search
ドキュメントセンター

Container Service for Kubernetes:Arena を使用した MLflow モデルレジストリでのモデル管理

最終更新日:Mar 26, 2025

クラウドネイティブ AI スイートを使用して、MLflow モデルレジストリ内のモデルを管理できます。このトピックでは、Arena CLI を使用してモデルを管理する方法について説明します。

背景情報

MLflow は、オープンソースの機械学習ライフサイクル管理プラットフォームであり、モデルのトレーニング情報の追跡、機械学習モデルの管理、および機械学習モデルのデプロイに使用できます。 MLflow モデルレジストリの詳細については、「MLflow Model Registry - MLflow ドキュメント」をご参照ください。

前提条件

  • Kubernetes 1.20 以降を実行する Container Service for Kubernetes (ACK) Pro マネージドクラスターが作成されていること。詳細については、「ACK マネージドクラスターの作成」をご参照ください。

  • RAM コンソールで Resource Access Management (RAM) ユーザーが作成され、クォータグループに関連付けられていること。詳細については、「RAM ユーザーを作成する」をご参照ください。クォータグループを RAM ユーザーに関連付ける方法の詳細については、「ステップ 1: RAM ユーザーのクォータグループを作成する」をご参照ください。

  • MLflow コンポーネントが、ACK クラスターの kube-ai 名前空間にデプロイされていること。詳細については、「MLflow モデルレジストリを構成する」をご参照ください。

  • Arena を使用してモデルを管理するには、Arena クライアントを構成します。 Arena のバージョンは 0.9.14 以降である必要があります。詳細については、「Arena クライアントを構成する」をご参照ください。

Arena を使用してモデルを管理する

Arena を使用してモデルを管理する方法の詳細については、「モデル管理ガイド - Arena ドキュメント」をご参照ください。

モデルバージョンを追加する

モデルバージョンを追加するには、次のコマンドを実行します。

arena model create \
    --name my-model \
    --tags key1,key2=value2 \
    --description "This is some description about my-model" \
    --version-tags key3,key4=value4 \
    --version-description "This is some description about my-model v1" \
    --source pvc://my-pvc/models/my-model/1

期待される出力:

INFO[0000] registered model "my-model" created     // 登録済みモデル "my-model" が作成されました
INFO[0000] model version 1 for "my-model" created  // "my-model" のモデルバージョン 1 が作成されました

登録済みモデルまたはモデルバージョンを照会する

  • 登録済みモデルを照会する

    my-model という名前の登録済みモデルを照会するには、次のコマンドを実行します。

    arena model get \
        --name my-model

    期待される出力:

    Name:                my-model // 名前
    LatestVersion        1 // 最新バージョン
    CreationTime:        2024-04-29T16:15:26+08:00 // 作成時刻
    LastUpdatedTime:     2024-04-29T16:44:17+08:00 // 最終更新時刻
    Description: // 説明
      This is some description about my-model! // これは my-model についての説明です!
    Tags: // タグ
      key1: 
      key2: value2
    Versions: // バージョン
      Version    Source // バージョン ソース
      ---        ---
      1          pvc://my-pvc/models/my-model/1
  • モデルバージョンを照会する

    モデル名が my-model でバージョン番号が 1 のモデルバージョンを照会するには、次のコマンドを実行します。

    arena model get \
        --name my-model \
        --version 1

    期待される出力:

    Name:                my-model // 名前
    Version:             1 // バージョン
    CreationTime:        2024-04-29T16:42:18+08:00 // 作成時刻
    LastUpdatedTime:     2024-04-29T16:42:18+08:00 // 最終更新時刻
    Source:              pvc://my-pvc/models/my-model/1 // ソース
    Description: // 説明
      This is some description about my-model v1 // これは my-model v1 についての説明です
    Tags: // タグ
      createdBy: arena // 作成者: arena
      key3: 
      key4: value4

すべての登録済みモデルを一覧表示する

すべての登録済みモデルを一覧表示するには、次のコマンドを実行します。

arena model list 

登録済みモデルまたはモデルバージョンを更新する

my-model という名前の登録済みモデルを更新するには、次のコマンドを実行します。

arena model update \
    --name my-model \
    --description "This is some updated description" \
    --tags key1=updatedValue1,key2=updatedValue2 

期待される出力:

INFO[0000] model version "my-model/1" updated // モデルバージョン "my-model/1" が更新されました

モデルのタグを削除するには、タグにハイフン (-) を追加します。次の例では、key1key2=value2key3、および key4=value4 タグが削除されます。

arena model update \
    --name my-model \
    --tags key1-,key2=value2- \
    --version 1 \
    --version-tags key3-,key4=value4-

登録済みモデルまたはモデルバージョンを削除する

警告

登録済みモデルを削除すると、そのモデルに関連付けられているすべてのモデルバージョンも削除されます。注意して操作してください。

  • 登録済みモデルを削除する

    たとえば、my-model という名前の登録済みモデルを削除するには、次のコマンドを実行します。

    arena model delete \
        --name my-model

    ユーザーエラーを防ぐため、上記のコマンドを実行すると、指定したモデルを削除するかどうかを確認するメッセージが表示されます。 yes または no を入力して確認します。

    自動スクリプトを使用する場合、または削除操作を確認する必要がない場合は、--force を追加して確認ステップをスキップし、モデルを直接削除します。例:

    arena model delete \
        --name my-model \
        --force
  • モデルバージョンを削除する

    たとえば、モデル名が my-model でバージョン番号が 1 のモデルバージョンを削除するには、次のコマンドを実行します。

    arena model delete \
        --name my-model \
        --version 1

    ユーザーエラーを防ぐため、上記のコマンドを実行すると、指定したモデルバージョンを削除するかどうかを確認するメッセージが表示されます。yes または no を入力して確認します。

    自動スクリプトを使用する場合、または削除操作を確認する必要がない場合は、--force を追加して確認ステップをスキップし、モデルバージョンを直接削除します。例:

    arena model delete \
        --name my-model \
        --version 1 \
        --force