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

Nome	Descrizione
workspace Necessario	Workspace Area di lavoro in cui è presente il pacchetto.
operation_id Necessario	str ID dell'operazione di creazione del pacchetto.
environment Necessario	Environment Ambiente in cui viene creato il pacchetto del modello.
workspace Necessario	Workspace Area di lavoro in cui è presente il pacchetto.
operation_id Necessario	str ID dell'operazione di creazione del pacchetto.
environment Necessario	Environment 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

Nome	Descrizione
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

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

get_logs

Recuperare i log di creazione del pacchetto.

get_logs(decode=True, offset=0)

Parametri

Nome	Descrizione
decode	bool Indica se decodificare i byte di log non elaborati in una stringa. Valore predefinito: True
offset	int Offset di byte da cui iniziare a leggere i log. Valore predefinito: 0

Restituisce

Tipo	Descrizione
bytes, str	Log di creazione del pacchetto.

Eccezioni

Tipo	Descrizione
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

Tipo	Descrizione
WebserviceException

save

Salvare l'output del pacchetto in una directory locale.

Può essere usato solo con un pacchetto Dockerfile.

save(output_directory)

Parametri

Nome	Descrizione
output_directory Necessario	str Directory locale che verrà creata per contenere il contenuto del pacchetto.

Eccezioni

Tipo	Descrizione
WebserviceException

serialize

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

serialize()

Restituisce

Tipo	Descrizione
dict	Rappresentazione JSON di questo ModelPackage.

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

Tipo	Descrizione
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

Nome	Descrizione
show_output	bool Indica se stampare un output più dettagliato. Valore predefinito: False

Eccezioni

Tipo	Descrizione
WebserviceException