ModelPackage 類別
表示將一或多個模型及其相依性封裝至 Docker 映射或 Dockerfile。
ModelPackage 對像是從 package Model 類別的 方法傳回。
generate_dockerfile封裝方法的參數會判斷是否已建立 Docker 映像或 Dockerfile。
初始化以model（s） 和相依性建立的套件。
建構函式
ModelPackage(workspace, operation_id, environment)參數
| 名稱 | Description |
|---|---|
|
workspace
必要
|
封裝所在的工作區。 |
|
operation_id
必要
|
封裝建立作業的標識碼。 |
|
environment
必要
|
正在封裝模型的環境。 |
|
workspace
必要
|
封裝所在的工作區。 |
|
operation_id
必要
|
封裝建立作業的標識碼。 |
|
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")
變數
| 名稱 | Description |
|---|---|
|
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()傳回
| 類型 | Description |
|---|---|
|
容器登錄的位址和登入認證。 |
get_logs
擷取封裝建立記錄。
get_logs(decode=True, offset=0)參數
| 名稱 | Description |
|---|---|
|
decode
|
指出是否將原始記錄位元組譯碼為字串。 預設值: True
|
|
offset
|
要開始讀取記錄的位元組位移。 預設值: 0
|
傳回
| 類型 | Description |
|---|---|
|
封裝建立記錄。 |
例外狀況
| 類型 | Description |
|---|---|
pull
save
將封裝輸出儲存到本機目錄。
這隻能與 Dockerfile 套件搭配使用。
save(output_directory)參數
| 名稱 | Description |
|---|---|
|
output_directory
必要
|
將建立以包含封裝內容的本機目錄。 |
例外狀況
| 類型 | Description |
|---|---|
serialize
將此 ModelPackage 轉換成 JSON 可串行化字典，以供 CLI 顯示。
serialize()傳回
| 類型 | Description |
|---|---|
|
此 ModelPackage 的 JSON 表示法。 |
update_creation_state
重新整理記憶體內部物件的目前狀態。
這個方法會根據對應雲端物件的目前狀態，執行對象的屬性就地更新。 這主要用於手動輪詢建立狀態。
update_creation_state()例外狀況
| 類型 | Description |
|---|---|
wait_for_creation
等候套件完成建立。
此方法會等候套件建立到達終端機狀態。 如果它達到非成功的終端狀態，則會擲回 WebserviceException 。
wait_for_creation(show_output=False)參數
| 名稱 | Description |
|---|---|
|
show_output
|
指出是否要列印更詳細的輸出。 預設值: False
|
例外狀況
| 類型 | Description |
|---|---|