ModelPackage Classe

Représente un empaquetage d’un ou de plusieurs modèles et de leurs dépendances dans une image Docker ou un fichier Docker.

Un objet ModelPackage est retourné à partir de la méthode package de la classe Model. Le paramètre generate_dockerfile de la méthode de package détermine si une image Docker ou fichier Docker est créé(e).

Initialisez le package créé avec des modèles et des dépendances.

Héritage

builtins.object

ModelPackage

Constructeur

ModelPackage(workspace, operation_id, environment)

Paramètres

workspace

Workspace

Obligatoire

Espace de travail dans lequel se trouve le package.

operation_id

str

Obligatoire

ID de l’opération de création du package.

environment

Environment

Obligatoire

Environnement dans lequel le modèle est empaqueté.

workspace

Workspace

Obligatoire

Espace de travail dans lequel se trouve le package.

operation_id

str

Obligatoire

ID de l’opération de création du package.

environment

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 sera envoyée (push) dans l’ACR de votre espace de travail.

Vous devez inclure un objet Environment dans votre configuration d’inférence pour utiliser la méthode Empaquetage 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 générée, vous pouvez à la place générer un Dockerfile et télécharger toutes les ressources nécessaires pour créer une image en plus 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

azureml.core.model.ModelPackage.workspace

Espace de travail dans lequel est créé le package.

Méthodes

get_container_registry	Retourne un objet ContainerRegistry indiquant l’emplacement de stockage de l’image ou de l’image de base (packages Dockerfile).
get_logs	Récupère les journaux de création du package.
pull	Extrait la sortie du package sur l’ordinateur local. Ne peut être utilisé qu’avec un package d’images Docker.
save	Enregistre la sortie du package dans un répertoire local. Ne peut être utilisé qu’avec un package Dockerfile.
serialize	Convertit ce ModelPackage en dictionnaire JSON sérialisable pour affichage par l’interface CLI.
update_creation_state	Actualise 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. Elle est principalement utilisée pour l’interrogation manuelle de l’état de création.
wait_for_creation	Attend que la création du package soit terminée. Cette méthode attend que la création du package atteigne un état terminal. Lève une exception WebserviceException si elle atteint un état terminal infructueux.

get_container_registry

Retourne un objet ContainerRegistry indiquant l’emplacement de stockage de l’image ou de l’image de base (packages Dockerfile).

get_container_registry()

Retours

Adresse et informations de connexion du registre de conteneurs.

Type de retour

ContainerRegistry

get_logs

Récupère les journaux de création du package.

get_logs(decode=True, offset=0)

Paramètres

decode

bool

valeur par défaut: True

Indique s’il faut décoder les octets de journal bruts en chaîne.

offset

int

valeur par défaut: 0

Décalage d’octet à partir duquel commencer la lecture des journaux.

Retours

Journaux de création du package.

Type de retour

bytes,

str

Exceptions

WebserviceException

pull

Extrait la sortie du package sur l’ordinateur local.

Ne peut être utilisé qu’avec un package d’images Docker.

pull()

Exceptions

WebserviceException

save

Enregistre la sortie du package dans un répertoire local.

Ne peut être utilisé qu’avec un package Dockerfile.

save(output_directory)

Paramètres

output_directory

str

Obligatoire

Répertoire local qui sera créé pour inclure le contenu du package.

Exceptions

WebserviceException

serialize

Convertit ce ModelPackage en dictionnaire JSON sérialisable pour affichage par l’interface CLI.

serialize()

Retours

Représentation JSON de ce ModelPackage.

Type de retour

dict

update_creation_state

Actualise 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. Elle est principalement utilisée pour l’interrogation manuelle de l’état de création.

update_creation_state()

Exceptions

WebserviceException

wait_for_creation

Attend que la création du package soit terminée.

Cette méthode attend que la création du package atteigne un état terminal. Lève une exception WebserviceException si elle atteint un état terminal infructueux.

wait_for_creation(show_output=False)

Paramètres

show_output

bool

valeur par défaut: False

Indique s’il est nécessaire d’imprimer une sortie plus détaillée.

Exceptions

WebserviceException