ModelPackage Klasa

Reprezentuje opakowanie jednego lub większej liczby modeli i ich zależności w obrazie platformy Docker lub pliku Dockerfile.

Obiekt ModelPackage jest zwracany z package metody klasy Model. Parametr generate_dockerfile metody pakietu określa, czy jest tworzony obraz platformy Docker lub plik Dockerfile.

Zainicjuj pakiet utworzony za pomocą modeli i zależności.

Dziedziczenie

builtins.object

ModelPackage

Konstruktor

ModelPackage(workspace, operation_id, environment)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obszar roboczy, w którym istnieje pakiet.
operation_id Wymagane	str Identyfikator operacji tworzenia pakietu.
environment Wymagane	Environment Środowisko, w którym model jest pakowany.
workspace Wymagane	Workspace Obszar roboczy, w którym istnieje pakiet.
operation_id Wymagane	str Identyfikator operacji tworzenia pakietu.
environment Wymagane	Environment Środowisko, w którym model jest pakowany.

Uwagi

Aby utworzyć obraz platformy Docker, który hermetyzuje model i jego zależności, możesz użyć opcji pakowania modelu. Obraz wyjściowy zostanie wypchnięty do usługi ACR obszaru roboczego.

Aby użyć metody pakietu Model, należy uwzględnić obiekt Środowisko w konfiguracji wnioskowania.

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

Zamiast w pełni utworzonego obrazu możesz zamiast tego wygenerować plik Dockerfile i pobrać wszystkie zasoby potrzebne do utworzenia obrazu na podstawie środowiska.

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

Zmienne

Nazwa	Opis
azureml.core.model.ModelPackage.workspace	Obszar roboczy, w którym jest tworzony pakiet.

Metody

get_container_registry	Zwróć obiekt ContainerRegistry wskazujący, gdzie jest przechowywany obraz lub obraz podstawowy (pakiety Dockerfile).
get_logs	Pobierz dzienniki tworzenia pakietu.
pull	Ściąganie danych wyjściowych pakietu na maszynę lokalną. Może to być używane tylko z pakietem obrazów platformy Docker.
save	Zapisz dane wyjściowe pakietu w katalogu lokalnym. Może to być używane tylko z pakietem Dockerfile.
serialize	Przekonwertuj ten pakiet ModelPackage na słownik z możliwością serializacji JSON do wyświetlania przez interfejs wiersza polecenia.
update_creation_state	Odśwież bieżący stan obiektu w pamięci. Ta metoda wykonuje aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu tworzenia.
wait_for_creation	Poczekaj na zakończenie tworzenia pakietu. Ta metoda czeka na utworzenie pakietu, aby osiągnąć stan terminalu. Zgłosi błąd WebserviceException , jeśli osiągnie stan terminalu, który nie powiedzie się.

get_container_registry

Zwróć obiekt ContainerRegistry wskazujący, gdzie jest przechowywany obraz lub obraz podstawowy (pakiety Dockerfile).

get_container_registry()

Zwraca

Typ	Opis
ContainerRegistry	Adres i poświadczenia logowania dla rejestru kontenerów.

get_logs

Pobierz dzienniki tworzenia pakietu.

get_logs(decode=True, offset=0)

Parametry

Nazwa	Opis
decode	bool Wskazuje, czy dekodować nieprzetworzone bajty dziennika do ciągu. Domyślna wartość: True
offset	int Przesunięcie bajtu, z którego chcesz rozpocząć odczytywanie dzienników. Domyślna wartość: 0

Zwraca

Typ	Opis
bytes, str	Dzienniki tworzenia pakietu.

Wyjątki

Typ	Opis
WebserviceException

pull

Ściąganie danych wyjściowych pakietu na maszynę lokalną.

Może to być używane tylko z pakietem obrazów platformy Docker.

pull()

Wyjątki

Typ	Opis
WebserviceException

save

Zapisz dane wyjściowe pakietu w katalogu lokalnym.

Może to być używane tylko z pakietem Dockerfile.

save(output_directory)

Parametry

Nazwa	Opis
output_directory Wymagane	str Katalog lokalny, który zostanie utworzony w celu przechowywania zawartości pakietu.

Wyjątki

Typ	Opis
WebserviceException

serialize

Przekonwertuj ten pakiet ModelPackage na słownik z możliwością serializacji JSON do wyświetlania przez interfejs wiersza polecenia.

serialize()

Zwraca

Typ	Opis
dict	Reprezentacja JSON tego pakietu ModelPackage.

update_creation_state

Odśwież bieżący stan obiektu w pamięci.

Ta metoda wykonuje aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu tworzenia.

update_creation_state()

Wyjątki

Typ	Opis
WebserviceException

wait_for_creation

Poczekaj na zakończenie tworzenia pakietu.

Ta metoda czeka na utworzenie pakietu, aby osiągnąć stan terminalu. Zgłosi błąd WebserviceException , jeśli osiągnie stan terminalu, który nie powiedzie się.

wait_for_creation(show_output=False)

Parametry

Nazwa	Opis
show_output	bool Wskazuje, czy wydrukować więcej pełnych danych wyjściowych. Domyślna wartość: False

Wyjątki

Typ	Opis
WebserviceException