ModelPackage 類別
表示將一或多個模型及其相依性封裝成 Docker 映射或 Dockerfile。
ModelPackage 物件是從 package Model 類別的 方法傳回。 封裝 generate_dockerfile 方法的 參數會判斷是否已建立 Docker 映射或 Dockerfile。
初始化使用模型建立的套件 () 和相依性。
- 繼承
-
builtins.objectModelPackage
建構函式
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 |
|---|---|