ModelPackage 類別

表示將一或多個模型及其相依性封裝成 Docker 映射或 Dockerfile。

ModelPackage 物件是從 package Model 類別的 方法傳回。 封裝 generate_dockerfile 方法的 參數會判斷是否已建立 Docker 映射或 Dockerfile。

初始化使用模型建立的套件 () 和相依性。

繼承

builtins.object

ModelPackage

建構函式

ModelPackage(workspace, operation_id, environment)

參數

workspace

Workspace

必要

套件所在的工作區。

operation_id

str

必要

封裝建立作業的識別碼。

environment

Environment

必要

正在封裝模型的環境。

workspace

Workspace

必要

套件所在的工作區。

operation_id

str

必要

封裝建立作業的識別碼。

environment

Environment

必要

正在封裝模型的環境。

備註

若要建置封裝模型及其相依性的 Docker 映射，您可以使用模型封裝選項。 輸出映射會推送至工作區的 ACR。

您必須在推斷組態中包含 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	會傳回 ContainerRegistry 物件，指出儲存) Dockerfile 套件 (映射或基底映射的位置。
get_logs	擷取套件建立記錄。
pull	將封裝輸出提取到本機電腦。 這只能與 Docker 映射套件搭配使用。
save	將封裝輸出儲存至本機目錄。 這只能與 Dockerfile 套件搭配使用。
serialize	將此 ModelPackage 轉換成 JSON 可序列化字典，以供 CLI 顯示。
update_creation_state	重新整理記憶體內建物件的目前狀態。 這個方法會根據對應雲端物件的目前狀態，就地更新物件的屬性。 這主要用於手動輪詢建立狀態。
wait_for_creation	等候封裝完成建立。 此方法會等候套件建立到達終端機狀態。 如果達到非成功的終端機狀態，將會擲回 WebserviceException 。

get_container_registry

會傳回 ContainerRegistry 物件，指出儲存) Dockerfile 套件 (映射或基底映射的位置。

get_container_registry()

傳回

容器登錄的位址和登入認證。

傳回類型

ContainerRegistry

get_logs

擷取套件建立記錄。

get_logs(decode=True, offset=0)

參數

decode

bool

預設值: True

指出是否將原始記錄位元組解碼為字串。

offset

int

預設值: 0

要開始讀取記錄的位元組位移。

傳回

封裝建立記錄。

傳回類型

bytes,

str

例外狀況

WebserviceException

pull

將封裝輸出提取到本機電腦。

這只能與 Docker 映射套件搭配使用。

pull()

例外狀況

WebserviceException

save

將封裝輸出儲存至本機目錄。

這只能與 Dockerfile 套件搭配使用。

save(output_directory)

參數

output_directory

str

必要

將建立以包含封裝內容的本機目錄。

例外狀況

WebserviceException

serialize

將此 ModelPackage 轉換成 JSON 可序列化字典，以供 CLI 顯示。

serialize()

傳回

這個 ModelPackage 的 JSON 標記法。

傳回類型

dict

update_creation_state

重新整理記憶體內建物件的目前狀態。

這個方法會根據對應雲端物件的目前狀態，就地更新物件的屬性。 這主要用於手動輪詢建立狀態。

update_creation_state()

例外狀況

WebserviceException

wait_for_creation

等候封裝完成建立。

此方法會等候套件建立到達終端機狀態。 如果達到非成功的終端機狀態，將會擲回 WebserviceException 。

wait_for_creation(show_output=False)

參數

show_output

bool

預設值: False

指出是否要列印更詳細的輸出。

例外狀況

WebserviceException