ContainerImageConfig Classe

Définit des paramètres de configuration d’image spécifiques aux déploiements de conteneur : requiert le script d’exécution et le runtime.

Dans les cas d’utilisation typiques, vous utiliserez la méthode image_configuration de la classe ContainerImage pour créer un objet ContainerImageConfig.

Initialisez l’objet config.

Héritage
ContainerImageConfig

Constructeur

ContainerImageConfig(execution_script, runtime, conda_file=None, docker_file=None, schema_file=None, dependencies=None, enable_gpu=None, tags=None, properties=None, description=None, base_image=None, base_image_registry=None, allow_absolute_path=False, cuda_version=None)

Paramètres

execution_script
str
Obligatoire

Chemin d’accès au fichier local contenant le code à exécuter pour l’image.

runtime
str
Obligatoire

Runtime à utiliser pour l’image. Actuellement, les runtimes pris en charge sont « spark-py » et « python ».

conda_file
str
valeur par défaut: None

Chemin d’accès au fichier local contenant une définition de l’environnement Conda à utiliser pour l’image.

docker_file
str
valeur par défaut: None

Chemin d’accès au fichier local contenant des étapes Docker supplémentaires à exécuter lors de la configuration de l’image.

schema_file
str
valeur par défaut: None

Chemin d’accès au fichier local contenant un schéma de service web à utiliser lorsque l’image est déployée.

dependencies
list[str]
valeur par défaut: None

Liste de chemins d’accès aux fichiers/dossiers supplémentaires dont l’image a besoin pour s’exécuter.

enable_gpu
bool
valeur par défaut: None

Indique s’il faut activer la prise en charge du GPU dans l’image. L’image GPU doit être utilisée sur les services Microsoft Azure tels que Azure Container Instances, Capacité de calcul Azure Machine Learning, Machines virtuelles Azure et Azure Kubernetes Service. Valeur par défaut False.

tags
dict[(str, str)]
valeur par défaut: None

Dictionnaire des étiquettes clé-valeur à attribuer à cette image.

properties
dict[(str, str)]
valeur par défaut: None

Dictionnaire des propriétés clé-valeur à attribuer à cette image. Ces propriétés ne peuvent pas être modifiées après le déploiement. De nouvelles paires clé/valeur peuvent toutefois être ajoutées.

description
str
valeur par défaut: None

Description à fournir à cette image.

base_image
str
valeur par défaut: None

Image personnalisée à utiliser comme image de base. Si aucune image de base n’est proposée, l’image de base sera utilisée en fonction d’un paramètre d’exécution donné.

base_image_registry
ContainerRegistry
valeur par défaut: None

Registre d’images contenant l’image de base.

allow_absolute_path
bool
valeur par défaut: False

Indique s’il faut autoriser le chemin absolu.

cuda_version
str
valeur par défaut: None

Version de CUDA à installer pour les images qui nécessitent une prise en charge du GPU. L’image GPU doit être utilisée sur les services Microsoft Azure tels que Azure Container Instances, Capacité de calcul Azure Machine Learning, Machines virtuelles Azure et Azure Kubernetes Service. Les versions prises en charge sont les versions 9.0, 9.1 et 10.0. Si « enable_gpu » est défini, la valeur par défaut est « 9.1 ».

execution_script
str
Obligatoire

Chemin d’accès au fichier local qui contient le code à exécuter pour l’image

runtime
str
Obligatoire

Runtime à utiliser pour l’image. Les runtimes actuellement pris en charge sont « spark-py » et « python »

conda_file
str
Obligatoire

Chemin d’accès au fichier local contenant une définition d’environnement conda à utiliser pour l’image

docker_file
str
Obligatoire

Chemin d’accès au fichier local contenant des étapes Docker supplémentaires à exécuter lors de la configuration de l’image

schema_file
str
Obligatoire

Chemin d’accès au fichier local contenant un schéma de service web à utiliser lors du déploiement de l’image

dependencies
list[str]
Obligatoire

Liste des chemins d’accès aux fichiers/dossiers supplémentaires que l’image doit exécuter

enable_gpu
bool
Obligatoire

Activer ou non la prise en charge GPU dans l’image. L’image GPU doit être utilisée sur les services Microsoft Azure tels que Azure Container Instances, Capacité de calcul Azure Machine Learning, Machines virtuelles Azure et Azure Kubernetes Service. La valeur par défaut est false.

tags
dict[str, str]
Obligatoire

Dictionnaire de balises de valeur clé pour donner cette image

properties
dict[str, str]
Obligatoire

Dictionnaire des propriétés de valeur de clé à attribuer à cette image. Vous ne pouvez pas changer ces propriétés après le déploiement. Toutefois, vous pouvez ajouter de nouvelles paires clé-valeur

description
str
Obligatoire

Description à donner à cette image

base_image
str
Obligatoire

Image personnalisée à utiliser comme image de base. Si aucune image de base n’est proposée, l’image de base sera utilisée en fonction d’un paramètre d’exécution donné.

base_image_registry
ContainerRegistry
Obligatoire

Registre d’images contenant l’image de base.

allow_absolute_path
bool
Obligatoire

Indicateur permettant d’autoriser le chemin absolu

cuda_version
str
Obligatoire

Version de CUDA à installer pour les images nécessitant une prise en charge GPU. L’image GPU doit être utilisée sur les services Microsoft Azure tels que Azure Container Instances, Capacité de calcul Azure Machine Learning, Machines virtuelles Azure et Azure Kubernetes Service. Les versions prises en charge sont les versions 9.0, 9.1 et 10.0. Si « enable_gpu » est défini, la valeur par défaut est « 9.1 ».

Méthodes

build_create_payload

Génère la charge utile de création pour l’image conteneur.

create_local_debug_payload

Génère la charge utile de création pour l’image conteneur.

validate_configuration

Vérifie que les valeurs de configuration spécifiées sont valides.

Lève une exception :class:azureml.exceptions.WebserviceException` si la validation échoue.

build_create_payload

Génère la charge utile de création pour l’image conteneur.

build_create_payload(workspace, name, model_ids)

Paramètres

workspace
Workspace
Obligatoire

Objet d’espace de travail dans lequel créer l’image.

name
str
Obligatoire

Nom de l'image.

model_ids
list[str]
Obligatoire

Liste d’ID de modèle à empaqueter dans l’image.

Retours

Charge utile de création de l’image conteneur.

Type de retour

Exceptions

create_local_debug_payload

Génère la charge utile de création pour l’image conteneur.

create_local_debug_payload(workspace, model_ids)

Paramètres

workspace
Workspace
Obligatoire

Objet d’espace de travail dans lequel créer l’image.

model_ids
list[str]
Obligatoire

Liste d’ID de modèle à empaqueter dans l’image.

Retours

Charge utile de création de l’image conteneur.

Type de retour

Exceptions

validate_configuration

Vérifie que les valeurs de configuration spécifiées sont valides.

Lève une exception :class:azureml.exceptions.WebserviceException` si la validation échoue.

validate_configuration()

Exceptions