ModelPackage Klasse

Diese Klasse stellt die Bündelung von einem oder mehreren Modellen und deren Abhängigkeiten in einem Docker-Image oder einem Dockerfile dar.

Ein ModelPackage-Objekt wird von der package-Methode der Model-Klasse zurückgegeben. Der generate_dockerfile-Parameter der package-Methode bestimmt, ob ein Docker-Image oder ein Dockerfile erstellt wird.

Initialisieren Sie pakete, die mit Modellen und Abhängigkeiten erstellt wurden.

Vererbung

builtins.object

ModelPackage

Konstruktor

ModelPackage(workspace, operation_id, environment)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Der Arbeitsbereich, in dem das Paket vorhanden ist
operation_id Erforderlich	str Die ID des Paketerstellungsvorgangs
environment Erforderlich	Environment Die Umgebung, in der das Modell gepackt wird
workspace Erforderlich	Workspace Der Arbeitsbereich, in dem das Paket vorhanden ist
operation_id Erforderlich	str Die ID des Paketerstellungsvorgangs
environment Erforderlich	Environment Die Umgebung, in der das Modell gepackt wird

Hinweise

Um ein Docker-Image zu erstellen, das Ihr Modell und seine Abhängigkeiten kapselt, können Sie die Option zur Modellpaketerstellung verwenden. Das Ausgabeimage wird an die ACR-Instanz Ihres Arbeitsbereichs pusht.

Sie müssen ein Environment-Objekt in Ihre Rückschlusskonfiguration einfügen, um die Model-Paketmethode verwenden zu können.

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

Anstelle eines vollständig erstellten Images können Sie ein Dockerfile generieren und alle Ressourcen herunterladen, die zum Erstellen eines Images auf der Grundlage Ihrer Umgebung erforderlich sind.

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

Variablen

Name	Beschreibung
azureml.core.model.ModelPackage.workspace	Der Arbeitsbereich, in dem das Paket erstellt wird

Methoden

get_container_registry	Gibt ein ContainerRegistry-Objekt zurück, das angibt, wo das Image oder Basisimage (Dockerfile-Pakete) gespeichert wird
get_logs	Ruft die Protokolle zur Paketerstellung ab
pull	Pullt die Paketausgabe auf den lokalen Computer Dieser Vorgang ist nur mit einem Docker-Imagepaket möglich
save	Speichert die Paketausgabe in einem lokalen Verzeichnis Dieser Vorgang ist nur mit einem Dockerfile-Paket möglich
serialize	Konvertiert diese ModelPackage-Klasse in ein mit JSON serialisierbares Wörterbuch zur Anzeige durch die CLI
update_creation_state	Aktualisiert den aktuellen Zustand des In-Memory-Objekts Diese Methode dient zum Durchführen eines direkten Updates der Eigenschaften des Objekts basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Sie wird in erster Linie für den manuellen Abruf des Erstellungszustands verwendet.
wait_for_creation	Wartet auf den Abschluss der Paketerstellung Diese Methode wartet darauf, dass die Paketerstellung abgeschlossen ist. Eine WebserviceException-Ausnahme wird ausgelöst, wenn der Vorgang nicht erfolgreich abgeschlossen werden kann.

get_container_registry

Gibt ein ContainerRegistry-Objekt zurück, das angibt, wo das Image oder Basisimage (Dockerfile-Pakete) gespeichert wird

get_container_registry()

Gibt zurück

Typ	Beschreibung
ContainerRegistry	Die Adresse und Anmeldeinformationen für die Containerregistrierung

get_logs

Ruft die Protokolle zur Paketerstellung ab

get_logs(decode=True, offset=0)

Parameter

Name	Beschreibung
decode	bool Gibt an, ob die unformatierten Protokollbytes in eine Zeichenfolge decodiert werden Standardwert: True
offset	int Der Byteoffset, ab dem die Protokolle gelesen werden Standardwert: 0

Gibt zurück

Typ	Beschreibung
bytes, str	Die Protokolle zur Paketerstellung

Ausnahmen

Typ	Beschreibung
WebserviceException

pull

Pullt die Paketausgabe auf den lokalen Computer

Dieser Vorgang ist nur mit einem Docker-Imagepaket möglich

pull()

Ausnahmen

Typ	Beschreibung
WebserviceException

save

Speichert die Paketausgabe in einem lokalen Verzeichnis

Dieser Vorgang ist nur mit einem Dockerfile-Paket möglich

save(output_directory)

Parameter

Name	Beschreibung
output_directory Erforderlich	str Das lokale Verzeichnis, das erstellt wird, um den Inhalt des Pakets zu speichern

Ausnahmen

Typ	Beschreibung
WebserviceException

serialize

Konvertiert diese ModelPackage-Klasse in ein mit JSON serialisierbares Wörterbuch zur Anzeige durch die CLI

serialize()

Gibt zurück

Typ	Beschreibung
dict	Die JSON-Darstellung dieser ModelPackage-Klasse

update_creation_state

Aktualisiert den aktuellen Zustand des In-Memory-Objekts

Diese Methode dient zum Durchführen eines direkten Updates der Eigenschaften des Objekts basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Sie wird in erster Linie für den manuellen Abruf des Erstellungszustands verwendet.

update_creation_state()

Ausnahmen

Typ	Beschreibung
WebserviceException

wait_for_creation

Wartet auf den Abschluss der Paketerstellung

Diese Methode wartet darauf, dass die Paketerstellung abgeschlossen ist. Eine WebserviceException-Ausnahme wird ausgelöst, wenn der Vorgang nicht erfolgreich abgeschlossen werden kann.

wait_for_creation(show_output=False)

Parameter

Name	Beschreibung
show_output	bool Gibt an, ob eine ausführlichere Ausgabe ausgegeben werden soll Standardwert: False

Ausnahmen

Typ	Beschreibung
WebserviceException