ModelPackage Classe

  • Riferimento

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