ModelPackage Classe
Représente un empaquetage d’un ou plusieurs modèles et de leurs dépendances dans une image Docker ou un fichier Dockerfile.
Un objet ModelPackage est retourné à partir de la package méthode de la classe Model. Le generate_dockerfile paramètre de la méthode de package détermine si une image Docker ou un fichier Dockerfile est créé.
Initialisez le package créé avec des modèles et des dépendances.
Constructeur
ModelPackage(workspace, operation_id, environment)Paramètres
| Nom | Description |
|---|---|
|
workspace
Obligatoire
|
Espace de travail dans lequel le package existe. |
|
operation_id
Obligatoire
|
ID de l’opération de création de package. |
|
environment
Obligatoire
|
Environnement dans lequel le modèle est empaqueté. |
|
workspace
Obligatoire
|
Espace de travail dans lequel le package existe. |
|
operation_id
Obligatoire
|
ID de l’opération de création de package. |
|
environment
Obligatoire
|
Environnement dans lequel le modèle est empaqueté. |
Remarques
Pour générer une image Docker qui encapsule votre modèle et ses dépendances, vous pouvez utiliser l’option d’empaquetage de modèle. L’image de sortie est envoyée (push) à l’ACR de votre espace de travail.
Vous devez inclure un objet Environment dans votre configuration d’inférence pour utiliser la méthode de package de modèle.
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()
Au lieu d’une image entièrement intégrée, vous pouvez générer un fichier Dockerfile et télécharger toutes les ressources nécessaires pour générer une image au-dessus de votre environnement.
package = Model.package(ws, [model], inference_config, generate_dockerfile=True)
package.wait_for_creation(show_output=True)
package.save("./local_context_dir")
Variables
| Nom | Description |
|---|---|
|
azureml.core.model.ModelPackage.workspace
|
Espace de travail dans lequel le package est créé. |
Méthodes
| get_container_registry |
Retourne un objet ContainerRegistry indiquant où l’image ou l’image de base (packages Dockerfile) est stockée. |
| get_logs |
Récupérez les journaux de création de package. |
| pull |
Extrayez la sortie du package sur l’ordinateur local. Cela ne peut être utilisé qu’avec un package d’images Docker. |
| save |
Enregistrez la sortie du package dans un répertoire local. Cela ne peut être utilisé qu’avec un package Dockerfile. |
| serialize |
Convertissez ce ModelPackage en dictionnaire sérialisable JSON pour l’affichage par l’interface CLI. |
| update_creation_state |
Actualisez l’état actuel de l’objet en mémoire. Cette méthode effectue une mise à jour sur place des propriétés de l’objet en fonction de l’état actuel de l’objet cloud correspondant. Cela est principalement utilisé pour l’interrogation manuelle de l’état de création. |
| wait_for_creation |
Attendez que le package termine la création. Cette méthode attend que la création du package atteigne un état terminal. Lève une WebserviceException exception si elle atteint un état terminal non réussi. |
get_container_registry
Retourne un objet ContainerRegistry indiquant où l’image ou l’image de base (packages Dockerfile) est stockée.
get_container_registry()Retours
| Type | Description |
|---|---|
|
Adresse et informations d’identification de connexion pour le registre de conteneurs. |
get_logs
Récupérez les journaux de création de package.
get_logs(decode=True, offset=0)Paramètres
| Nom | Description |
|---|---|
|
decode
|
Indique s’il faut décoder les octets de journal bruts dans une chaîne. Valeur par défaut: True
|
|
offset
|
Décalage d’octet à partir duquel commencer à lire les journaux. Valeur par défaut: 0
|
Retours
| Type | Description |
|---|---|
|
Journaux de création de package. |
Exceptions
| Type | Description |
|---|---|
pull
Extrayez la sortie du package sur l’ordinateur local.
Cela ne peut être utilisé qu’avec un package d’images Docker.
pull()Exceptions
| Type | Description |
|---|---|
save
Enregistrez la sortie du package dans un répertoire local.
Cela ne peut être utilisé qu’avec un package Dockerfile.
save(output_directory)Paramètres
| Nom | Description |
|---|---|
|
output_directory
Obligatoire
|
Répertoire local qui sera créé pour contenir le contenu du package. |
Exceptions
| Type | Description |
|---|---|
serialize
Convertissez ce ModelPackage en dictionnaire sérialisable JSON pour l’affichage par l’interface CLI.
serialize()Retours
| Type | Description |
|---|---|
|
Représentation JSON de ce ModelPackage. |
update_creation_state
Actualisez l’état actuel de l’objet en mémoire.
Cette méthode effectue une mise à jour sur place des propriétés de l’objet en fonction de l’état actuel de l’objet cloud correspondant. Cela est principalement utilisé pour l’interrogation manuelle de l’état de création.
update_creation_state()Exceptions
| Type | Description |
|---|---|
wait_for_creation
Attendez que le package termine la création.
Cette méthode attend que la création du package atteigne un état terminal. Lève une WebserviceException exception si elle atteint un état terminal non réussi.
wait_for_creation(show_output=False)Paramètres
| Nom | Description |
|---|---|
|
show_output
|
Indique s’il faut imprimer une sortie plus détaillée. Valeur par défaut: False
|
Exceptions
| Type | Description |
|---|---|