ModelPackage Klas
Vertegenwoordigt een verpakking van een of meer modellen en de bijbehorende afhankelijkheden in een Docker-installatiekopieën of Dockerfile.
Er wordt een ModelPackage-object 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 model(s) en afhankelijkheden.
- Overname
-
builtins.objectModelPackage
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 bouwen die uw model en de bijbehorende afhankelijkheden inkapselen, kunt u de optie modelpakketten gebruiken. De uitvoerafbeelding wordt naar de ACR van uw werkruimte gepusht.
U moet een Omgevingsobject opnemen in uw 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ën kunt u in plaats daarvan een Dockerfile genereren en alle assets downloaden die nodig zijn om een installatiekopieën op uw omgeving te bouwen.
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 is gemaakt. |
Methoden
get_container_registry |
Retourneer een ContainerRegistry-object dat aangeeft waar de installatiekopie of basisinstallatiekopie (Dockerfile-pakketten) is opgeslagen. |
get_logs |
Haal de logboeken voor het maken van pakketten op. |
pull |
Haal de pakketuitvoer op 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 dit 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 van de eigenschappen van het object uitgevoerd op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor het handmatig peilen 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
Retourneer 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 pakketten op.
get_logs(decode=True, offset=0)
Parameters
Name | Description |
---|---|
decode
|
Geeft aan 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 op 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 dit 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 van de eigenschappen van het object uitgevoerd op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor het handmatig peilen 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 uitgebreidere uitvoer moet worden afgedrukt. Default value: False
|
Uitzonderingen
Type | Description |
---|---|