Partager via


ContainerImageConfig Classe

Définit les paramètres de configuration d’image spécifiques aux déploiements de conteneurs : nécessite un script d’exécution et un runtime.

Dans les cas d’usage classiques, vous allez utiliser la image_configuration méthode de la ContainerImage classe pour créer un objet ContainerImageConfig.

Initialisez l’objet config.

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

Nom Description
execution_script
Obligatoire
str

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

runtime
Obligatoire
str

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

conda_file
str

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

Valeur par défaut: None
docker_file
str

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

Valeur par défaut: None
schema_file
str

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

Valeur par défaut: None
dependencies

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

Valeur par défaut: None
enable_gpu

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 qu’Azure Container Instances, Azure Machine Learning Compute, Les machines virtuelles Azure et Azure Kubernetes Service. Valeur par défaut False.

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

Dictionnaire de balises de valeur clé pour donner cette image.

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

Dictionnaire des propriétés de valeur de clé à donner à cette image. Ces propriétés ne peuvent pas être modifiées après le déploiement, mais de nouvelles paires clé-valeur peuvent être ajoutées.

Valeur par défaut: None
description
str

Description à donner à cette image.

Valeur par défaut: None
base_image
str

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

Valeur par défaut: None
base_image_registry

Registre d’images qui contient l’image de base.

Valeur par défaut: None
allow_absolute_path

Indique s’il faut autoriser le chemin absolu.

Valeur par défaut: False
cuda_version
str

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 qu’Azure Container Instances, Azure Machine Learning Compute, Les machines virtuelles Azure et Azure Kubernetes Service. Les versions prises en charge sont 9.0, 9.1 et 10.0. Si « enable_gpu » est défini, la valeur par défaut est « 9.1 ».

Valeur par défaut: None
execution_script
Obligatoire
str

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

runtime
Obligatoire
str

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

conda_file
Obligatoire
str

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

docker_file
Obligatoire
str

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

schema_file
Obligatoire
str

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

dependencies
Obligatoire

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

enable_gpu
Obligatoire

Indique s’il faut activer ou non la prise en charge du GPU dans l’image. L’image GPU doit être utilisée sur les services Microsoft Azure tels qu’Azure Container Instances, Azure Machine Learning Compute, Les machines virtuelles Azure et Azure Kubernetes Service. La valeur par défaut est false.

tags
Obligatoire

Dictionnaire de balises de valeur clé pour donner cette image

properties
Obligatoire

Dictionnaire de propriétés de valeur clé pour donner cette image. Ces propriétés ne peuvent pas être modifiées après le déploiement, mais de nouvelles paires clé-valeur peuvent être ajoutées

description
Obligatoire
str

Description à donner à cette image

base_image
Obligatoire
str

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

base_image_registry
Obligatoire

Registre d’images qui contient l’image de base.

allow_absolute_path
Obligatoire

Indicateur pour autoriser le chemin absolu

cuda_version
Obligatoire
str

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 qu’Azure Container Instances, Azure Machine Learning Compute, Les machines virtuelles Azure et Azure Kubernetes Service. Les versions prises en charge sont 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érez la charge utile de création pour l’image conteneur.

create_local_debug_payload

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

validate_configuration

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

Déclenche une exception :class :azureml.exceptions.WebserviceException' si la validation échoue.

build_create_payload

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

build_create_payload(workspace, name, model_ids)

Paramètres

Nom Description
workspace
Obligatoire

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

name
Obligatoire
str

Nom de l’image.

model_ids
Obligatoire

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

Retours

Type Description

Charge utile de création d’image conteneur.

Exceptions

Type Description

create_local_debug_payload

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

create_local_debug_payload(workspace, model_ids)

Paramètres

Nom Description
workspace
Obligatoire

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

model_ids
Obligatoire

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

Retours

Type Description

Charge utile de création d’image conteneur.

Exceptions

Type Description

validate_configuration

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

Déclenche une exception :class :azureml.exceptions.WebserviceException' si la validation échoue.

validate_configuration()

Exceptions

Type Description