ModelPackage Klas
Vertegenwoordigt een verpakking van een of meer modellen en de bijbehorende afhankelijkheden in een Docker-installatiekopieën of Dockerfile.
Een ModelPackage-object wordt geretourneerd uit de package methode van de klasse Model. De generate_dockerfile parameter van de pakketmethode bepaalt of er een Docker-installatiekopieën of Dockerfile wordt gemaakt.
Initialiseer het pakket dat is gemaakt met modellen en afhankelijkheden.
Constructor
ModelPackage(workspace, operation_id, environment)Parameters
| Name | Description |
|---|---|
|
workspace
Vereist
|
De werkruimte waarin het pakket bestaat. |
|
operation_id
Vereist
|
Id van de bewerking voor het maken van het pakket. |
|
environment
Vereist
|
Omgeving waarin het model wordt verpakt. |
|
workspace
Vereist
|
De werkruimte waarin het pakket bestaat. |
|
operation_id
Vereist
|
Id van de bewerking voor het maken van het pakket. |
|
environment
Vereist
|
Omgeving waarin het model wordt verpakt. |
Opmerkingen
Als u een Docker-installatiekopieën wilt maken waarmee uw model en de bijbehorende afhankelijkheden worden ingekapseld, kunt u de optie voor modelverpakkingen gebruiken. De uitvoerafbeelding wordt naar de ACR van uw werkruimte gepusht.
U moet een omgevingsobject opnemen in de deductieconfiguratie om de modelpakketmethode te kunnen gebruiken.
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()
In plaats van een volledig gebouwde installatiekopie kunt u in plaats daarvan een Dockerfile genereren en alle assets downloaden die nodig zijn om een installatiekopie te bouwen boven op uw omgeving.
package = Model.package(ws, [model], inference_config, generate_dockerfile=True)
package.wait_for_creation(show_output=True)
package.save("./local_context_dir")
Variabelen
| Name | Description |
|---|---|
|
azureml.core.model.ModelPackage.workspace
|
De werkruimte waarin het pakket wordt gemaakt. |
Methoden
| get_container_registry |
Retourneert een ContainerRegistry-object dat aangeeft waar de installatiekopie of basisinstallatiekopie (Dockerfile-pakketten) is opgeslagen. |
| get_logs |
Haal de logboeken voor het maken van het pakket op. |
| pull |
Haal de pakketuitvoer naar de lokale computer. Dit kan alleen worden gebruikt met een Docker-installatiekopieënpakket. |
| save |
Sla de pakketuitvoer op in een lokale map. Dit kan alleen worden gebruikt met een Dockerfile-pakket. |
| serialize |
Converteer deze ModelPackage naar een JSON-serialiseerbare woordenlijst voor weergave door de CLI. |
| update_creation_state |
Vernieuw de huidige status van het object in het geheugen. Met deze methode wordt een in-place update uitgevoerd van de eigenschappen van het object op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de aanmaakstatus. |
| wait_for_creation |
Wacht totdat het pakket is gemaakt. Met deze methode wordt gewacht totdat het pakket een terminalstatus heeft bereikt. Genereert een WebserviceException als deze een niet-geslaagde terminalstatus bereikt. |
get_container_registry
Retourneert een ContainerRegistry-object dat aangeeft waar de installatiekopie of basisinstallatiekopie (Dockerfile-pakketten) is opgeslagen.
get_container_registry()Retouren
| Type | Description |
|---|---|
|
Het adres en de aanmeldingsreferenties voor het containerregister. |
get_logs
Haal de logboeken voor het maken van het pakket op.
get_logs(decode=True, offset=0)Parameters
| Name | Description |
|---|---|
|
decode
|
Hiermee wordt aangegeven of de onbewerkte logboekbytes moeten worden gedecodeerd naar een tekenreeks. Default value: True
|
|
offset
|
De byte-offset van waaruit de logboeken moeten worden gelezen. Default value: 0
|
Retouren
| Type | Description |
|---|---|
|
De logboeken voor het maken van pakketten. |
Uitzonderingen
| Type | Description |
|---|---|
pull
Haal de pakketuitvoer naar de lokale computer.
Dit kan alleen worden gebruikt met een Docker-installatiekopieënpakket.
pull()Uitzonderingen
| Type | Description |
|---|---|
save
Sla de pakketuitvoer op in een lokale map.
Dit kan alleen worden gebruikt met een Dockerfile-pakket.
save(output_directory)Parameters
| Name | Description |
|---|---|
|
output_directory
Vereist
|
De lokale map die wordt gemaakt om de inhoud van het pakket te bevatten. |
Uitzonderingen
| Type | Description |
|---|---|
serialize
Converteer deze ModelPackage naar een JSON-serialiseerbare woordenlijst voor weergave door de CLI.
serialize()Retouren
| Type | Description |
|---|---|
|
De JSON-weergave van dit ModelPackage. |
update_creation_state
Vernieuw de huidige status van het object in het geheugen.
Met deze methode wordt een in-place update uitgevoerd van de eigenschappen van het object op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de aanmaakstatus.
update_creation_state()Uitzonderingen
| Type | Description |
|---|---|
wait_for_creation
Wacht totdat het pakket is gemaakt.
Met deze methode wordt gewacht totdat het pakket een terminalstatus heeft bereikt. Genereert een WebserviceException als deze een niet-geslaagde terminalstatus bereikt.
wait_for_creation(show_output=False)Parameters
| Name | Description |
|---|---|
|
show_output
|
Geeft aan of u uitgebreidere uitvoer wilt afdrukken. Default value: False
|
Uitzonderingen
| Type | Description |
|---|---|