ModelPackage Classe

Rappresenta un pacchetto di uno o più modelli e le relative dipendenze in un'immagine Docker o in un Dockerfile.

Un oggetto ModelPackage viene restituito dal package metodo della classe Model. Il generate_dockerfile parametro del metodo del pacchetto determina se viene creata un'immagine Docker o un Dockerfile.

Inizializzare il pacchetto creato con modelli e dipendenze.

Ereditarietà

builtins.object

ModelPackage

Costruttore

ModelPackage(workspace, operation_id, environment)

Parametri

workspace

Workspace

Necessario

Area di lavoro in cui è presente il pacchetto.

operation_id

str

Necessario

ID dell'operazione di creazione del pacchetto.

environment

Environment

Necessario

Ambiente in cui viene creato il pacchetto del modello.

workspace

Workspace

Necessario

Area di lavoro in cui è presente il pacchetto.

operation_id

str

Necessario

ID dell'operazione di creazione del pacchetto.

environment

Environment

Necessario

Ambiente in cui viene creato il pacchetto del modello.

Commenti

Per creare un'immagine Docker che incapsula il modello e le relative dipendenze, è possibile usare l'opzione di creazione di pacchetti del modello. L'immagine di output verrà inserita nel Registro Azure Container dell'area di lavoro.

È necessario includere un oggetto Environment nella configurazione dell'inferenza per usare il metodo del pacchetto Model.

   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()

Anziché un'immagine completamente compilata, è invece possibile generare un Dockerfile e scaricare tutti gli asset necessari per compilare un'immagine sopra l'ambiente.

   package = Model.package(ws, [model], inference_config, generate_dockerfile=True)
   package.wait_for_creation(show_output=True)
   package.save("./local_context_dir")

Variabili

azureml.core.model.ModelPackage.workspace

Area di lavoro in cui viene creato il pacchetto.

Metodi

get_container_registry	Restituisce un oggetto ContainerRegistry che indica dove è archiviata l'immagine o l'immagine di base (pacchetti Dockerfile).
get_logs	Recuperare i log di creazione del pacchetto.
pull	Eseguire il pull dell'output del pacchetto nel computer locale. Questa operazione può essere usata solo con un pacchetto di immagini Docker.
save	Salvare l'output del pacchetto in una directory locale. Può essere usato solo con un pacchetto Dockerfile.
serialize	Convertire questo ModelPackage in un dizionario serializzabile JSON per la visualizzazione dall'interfaccia della riga di comando.
update_creation_state	Aggiornare lo stato corrente dell'oggetto in memoria. Questo metodo esegue un aggiornamento sul posto delle proprietà dell'oggetto in base allo stato corrente dell'oggetto cloud corrispondente. Viene usato principalmente per il polling manuale dello stato di creazione.
wait_for_creation	Attendere il completamento della creazione del pacchetto. Questo metodo attende che la creazione del pacchetto raggiunga uno stato terminale. Genererà un'eccezione WebserviceException se raggiunge uno stato terminale non riuscito.

get_container_registry

Restituisce un oggetto ContainerRegistry che indica dove è archiviata l'immagine o l'immagine di base (pacchetti Dockerfile).

get_container_registry()

Restituisce

L'indirizzo e le credenziali di accesso per il registro contenitori.

Tipo restituito

ContainerRegistry

get_logs

Recuperare i log di creazione del pacchetto.

get_logs(decode=True, offset=0)

Parametri

decode

bool

valore predefinito: True

Indica se decodificare i byte di log non elaborati in una stringa.

offset

int

valore predefinito: 0

Offset di byte da cui iniziare a leggere i log.

Restituisce

Log di creazione del pacchetto.

Tipo restituito

bytes,

str

Eccezioni

WebserviceException

pull

Eseguire il pull dell'output del pacchetto nel computer locale.

Questa operazione può essere usata solo con un pacchetto di immagini Docker.

pull()

Eccezioni

WebserviceException

save

Salvare l'output del pacchetto in una directory locale.

Può essere usato solo con un pacchetto Dockerfile.

save(output_directory)

Parametri

output_directory

str

Necessario

Directory locale che verrà creata per contenere il contenuto del pacchetto.

Eccezioni

WebserviceException

serialize

Convertire questo ModelPackage in un dizionario serializzabile JSON per la visualizzazione dall'interfaccia della riga di comando.

serialize()

Restituisce

Rappresentazione JSON di questo ModelPackage.

Tipo restituito

dict

update_creation_state

Aggiornare lo stato corrente dell'oggetto in memoria.

Questo metodo esegue un aggiornamento sul posto delle proprietà dell'oggetto in base allo stato corrente dell'oggetto cloud corrispondente. Viene usato principalmente per il polling manuale dello stato di creazione.

update_creation_state()

Eccezioni

WebserviceException

wait_for_creation

Attendere il completamento della creazione del pacchetto.

Questo metodo attende che la creazione del pacchetto raggiunga uno stato terminale. Genererà un'eccezione WebserviceException se raggiunge uno stato terminale non riuscito.

wait_for_creation(show_output=False)

Parametri

show_output

bool

valore predefinito: False

Indica se stampare un output più dettagliato.

Eccezioni

WebserviceException