コンテナモデルを使用して画像をアップロードする

このページでは、コンテナを利用したモデルで画像をアップロードするプロセスを説明します。このワークフローでは、モデルを作成し、画像をモデルリソースにプッシュし、モデルバージョンを設定します。

1. モデルの作成

コンテナを利用したモデルを作成するには、まず画像がプッシュされるリソースを作成します。このリソースはモデルの権限を制御し、このリソースに Viewer 権限を持つユーザーは、画像をFoundryから取り出すことができます。

モデルを新規作成するには、任意のモデリング目的に移動し、+モデルを追加を選択し、次にコンテナ化されたモデルをインポートを選択します。

2. モデルに画像をプッシュする

Palantirでモデルリソースを作成した後、画像をアセットにプッシュする手順に従ってください。

トークンを生成を選択し、デフォルトのコマンドブロックをコピーして、example-package:<TAG>をローカルのDockerリポジトリに存在する画像名とタグ（またはダイジェスト）に置き換えます。タグは、画像要件により、'latest'にすることはできません。これらのコマンドを実行すると、関連する画像がモデルにプッシュされ、Viewer権限を持つユーザーがアクセスできるようになります。

画像が正常にプッシュされ、コンテナ画像リストに表示されるようになったら、モデルバージョンの作成を選択して、バージョンの設定を開始します。これを行うには、まずモデルアダプタライブラリテンプレートで作成されたコンテナモデルアダプタを作成する必要があります。

公開する前にモデルアダプタの実装を反復して調整するために、サイドカードコレータを使用して、モデルに既に存在するコンテナでロジックがどのように動作するかをテストします。サイドカートランスフォームデコレータのドキュメントで説明されている手順に従って、新しいトランスフォームリポジトリをデコレータが有効になった状態で作成し、作成したモデルをバッキングした作成物リポジトリとして使用します。次に、トランスフォームリポジトリ内にローカルPythonファイルを定義し、アダプタを実装し、以下のように手動でインスタンス化します：

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
from transforms.api import transform, Input, Output
from transforms.sidecar import sidecar, Volume
# 以下のコードは、`myproject`フォルダ内に testAdapter.py という Python クラスを作成し、palantir_models の ModelAdapter クラスを実装する TestModelAdapter クラスを定義していることを前提としています。
from myproject.testAdapter import TestModelAdapter
import palantir_models.transforms


@sidecar(image='image-name', tag='1.0.0', volumes=[Volume("shared")])
@transform(
    output=Output("ri.foundry.main.dataset.<RID>"),
    source_df=Input("ri.foundry.main.dataset.<RID>"),
)
def compute(source_df, output):
    testingEntrypoint = TestModelAdapter(
       "/opt/palantir/sidecars/shared-volumes/shared",
       # ここでのポートは、特定のイメージがリッスンしているポートを反映してください。
       "localhost:PORT")
    testingEntrypoint.transform_write(source_df, output)

3. モデルバージョンの設定

モデルバージョンの設定ページで、特定のモデルバージョンに含めるコンテナイメージを1つ以上選択します。次へを選択して、モデルバージョンの設定に進みます。

モデルの詳細ページのモデルの設定ダイアログで、行うセマンティックバージョンの変更のタイプを設定します。その後、オプションで説明と設定ファイルを追加し、作成したアダプターを選択します。モデルアダプター設定セクションでモデルアダプターのリポジトリを選択し、モデルアダプターを選択ドロップダウンはリポジトリで定義された有効なアダプターの最新バージョンを表示します。

最後に、各イメージの任意のランタイム情報を設定します。これには、メモリ制約、引数、環境変数、新しい exec コマンドが含まれます。アダプターが requests ライブラリを使用している場合、イメージがリッスンしているポートを指定することは重要です。モデルバージョンに選択された各イメージのランタイム情報を設定することができます。

モデルは、テレメトリログを生成するように設定することができます。ユーザーのコンテナがテレメトリをサポートしている場合、以下のスクリーンショットに示すステップでモデルバージョンにそれを有効にすることができます。

4. モデルバージョンの表示

モデルバージョンが作成されると、そのメタデータがモデルページのモデル概要タブに表示されます。ここで、左側のパネルを使用して過去のバージョンを表示し、それにナビゲートします。

このページから、右上の + アイコンまたは アクション ドロップダウンを使用して モデリング目標に提出するか、Pythonトランスフォームへの入力としてモデルを使用することができます。モデルがコンテナを利用した場合、ModelInput クラスの 2つ目のオプション引数を指定し、トランスフォームで使用するバージョン RID を選択する必要があります。また、ユーザーのトランスフォームリポジトリにモデルアダプターへの依存関係を追加する必要があります。これは以下のように見えるかもしれません：

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 必要なライブラリをインポートします
from transforms.api import transform, Input, Output
from palantir_models.transforms import ModelInput


# transform デコレーターを使用して関数を定義します
# output は出力データセットのパスを指定します
# model はモデルの名前とバージョンを指定します
# source_df は入力データセットのパスを指定します
@transform(
    output=Output("/path/to/output/output_dataset"),
    model=ModelInput(
        "ri.models.main.model.<RID>",
        "ri.models.main.model-version.<RID>"),
    source_df=Input("/path/to/input/input_dataset"),
)
def compute(model, source_df, output):
    # モデルを使用してソースデータフレームを変換し、結果を出力します
    model.transform_write(source_df, output)