ModelPackage クラス
1 つ以上のモデルとその依存関係を Docker イメージまたは Dockerfile にパッケージ化することを表します。
ModelPackage オブジェクトは、Model クラスの package メソッドから返されます。 パッケージ メソッドの generate_dockerfile
パラメーターによって、Docker イメージまたは Dockerfile が作成されるかどうかが決まります。
モデルと依存関係を使用して作成されたパッケージを初期化します。
コンストラクター
ModelPackage(workspace, operation_id, environment)
パラメーター
名前 | 説明 |
---|---|
workspace
必須
|
パッケージが存在するワークスペース。 |
operation_id
必須
|
パッケージ作成操作の ID。 |
environment
必須
|
モデルがパッケージ化されている環境。 |
workspace
必須
|
パッケージが存在するワークスペース。 |
operation_id
必須
|
パッケージ作成操作の ID。 |
environment
必須
|
モデルがパッケージ化されている環境。 |
注釈
モデルとその依存関係をカプセル化する Docker イメージを構築するには、モデル パッケージ オプションを使用できます。 出力イメージがワークスペースの ACR にプッシュされます。
Model パッケージ メソッドを使用するには、推論構成に Environment オブジェクトを含める必要があります。
package = Model.package(ws, [model], inference_config)
package.wait_for_creation(show_output=True) # Or show_output=False to hide the Docker build logs.
package.pull()
完全にビルドされたイメージの代わりに、Dockerfile を生成し、環境の上にイメージをビルドするために必要なすべての資産をダウンロードできます。
package = Model.package(ws, [model], inference_config, generate_dockerfile=True)
package.wait_for_creation(show_output=True)
package.save("./local_context_dir")
変数
名前 | 説明 |
---|---|
azureml.core.model.ModelPackage.workspace
|
パッケージが作成されるワークスペース。 |
メソッド
get_container_registry |
イメージまたは基本イメージ (Dockerfile パッケージ) が格納されている場所を示す ContainerRegistry オブジェクトを返します。 |
get_logs |
パッケージ作成ログを取得します。 |
pull |
パッケージ出力をローカル コンピューターにプルします。 これは Docker イメージ パッケージでのみ使用できます。 |
save |
パッケージ出力をローカル ディレクトリに保存します。 これは Dockerfile パッケージでのみ使用できます。 |
serialize |
この ModelPackage を JSON でシリアル化可能なディクショナリに変換し、CLI で表示します。 |
update_creation_state |
メモリ内オブジェクトの現在の状態を更新します。 このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいて、オブジェクトのプロパティのインプレース更新を実行します。 これは主に、作成状態の手動ポーリングに使用されます。 |
wait_for_creation |
パッケージの作成が完了するまで待ちます。 このメソッドは、パッケージの作成が終了状態になるまで待機します。 正常でない終了状態に達すると、 WebserviceException がスローされます。 |
get_container_registry
イメージまたは基本イメージ (Dockerfile パッケージ) が格納されている場所を示す ContainerRegistry オブジェクトを返します。
get_container_registry()
戻り値
型 | 説明 |
---|---|
コンテナー レジストリのアドレスとログイン資格情報。 |
get_logs
パッケージ作成ログを取得します。
get_logs(decode=True, offset=0)
パラメーター
名前 | 説明 |
---|---|
decode
|
生ログ バイトを文字列にデコードするかどうかを示します。 規定値: True
|
offset
|
ログの読み取りを開始するバイト オフセット。 規定値: 0
|
戻り値
型 | 説明 |
---|---|
パッケージ作成ログ。 |
例外
型 | 説明 |
---|---|
pull
save
パッケージ出力をローカル ディレクトリに保存します。
これは Dockerfile パッケージでのみ使用できます。
save(output_directory)
パラメーター
名前 | 説明 |
---|---|
output_directory
必須
|
パッケージの内容を格納するために作成されるローカル ディレクトリ。 |
例外
型 | 説明 |
---|---|
serialize
この ModelPackage を JSON でシリアル化可能なディクショナリに変換し、CLI で表示します。
serialize()
戻り値
型 | 説明 |
---|---|
この ModelPackage の JSON 表記。 |
update_creation_state
メモリ内オブジェクトの現在の状態を更新します。
このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいて、オブジェクトのプロパティのインプレース更新を実行します。 これは主に、作成状態の手動ポーリングに使用されます。
update_creation_state()
例外
型 | 説明 |
---|---|
wait_for_creation
パッケージの作成が完了するまで待ちます。
このメソッドは、パッケージの作成が終了状態になるまで待機します。 正常でない終了状態に達すると、 WebserviceException がスローされます。
wait_for_creation(show_output=False)
パラメーター
名前 | 説明 |
---|---|
show_output
|
より詳細な出力を出力するかどうかを示します。 規定値: False
|
例外
型 | 説明 |
---|---|