CondaDependencies Classe

Référence

Gère les dépendances d’application dans un environnement Azure Machine Learning.

Notes

Si aucun paramètre n’est spécifié, azureml-defaults est ajouté en tant que seule dépendance pip.

Si le paramètre conda_dependencies_file_path n’est pas spécifié, l’objet CondaDependencies contient uniquement les packages Azure Machine Learning (azureml-defaults). La dépendance azureml-defaults n’est pas épinglée à une version spécifique. Elle cible la dernière version disponible sur PyPi.

Initialisez un nouvel objet pour gérer les dépendances.

Héritage: builtins.object

CondaDependencies

Constructeur

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Paramètres

conda_dependencies_file_path: str

valeur par défaut: None

Chemin local d’un fichier config Conda. L’utilisation de ce paramètre permet de charger et de modifier un fichier d’environnement Conda existant.

_underlying_structure

valeur par défaut: None

Remarques

Vous pouvez charger un fichier d’environnement Conda existant ou choisir de configurer et gérer les dépendances d’application en mémoire. Durant l’envoi de l’expérience, une étape de préparation est exécutée. Elle permet la création et la mise en cache d’un environnement Conda dans lequel l’expérience s’exécute.

Si votre dépendance est disponible à la fois via Conda et pip (à partir de PyPi), utilisez la version Conda, car les packages Conda sont généralement fournis avec des fichiers binaires prédéfinis qui rendent l’installation plus fiable. Pour plus d’informations, consultez Compréhension de Conda et PIP.

Pour plus d’informations sur les dépendances d’image de base, consultez le dépôt https://github.com/Azure/AzureML-Containers.

L’exemple suivant montre comment ajouter un package à l’aide de add_conda_package.


   from azureml.core.authentication import MsiAuthentication

   msi_auth = MsiAuthentication()

   ws = Workspace(subscription_id="my-subscription-id",
                  resource_group="my-ml-rg",
                  workspace_name="my-ml-workspace",
                  auth=msi_auth)

   print("Found workspace {} at location {}".format(ws.name, ws.location))

L’exemple complet est disponible sur https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

Vous pouvez également ajouter un package pip et définir les dépendances dans l’objet Environment.


   conda_dep.add_pip_package("pillow==6.2.1")
   myenv.python.conda_dependencies=conda_dep

L’exemple complet est disponible sur https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb

Méthodes

add_channel	Ajoute un canal Conda. Vous trouverez une liste des canaux sur https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/
add_cntk_package	Ajoute un package CNTK (Microsoft Cognitive Toolkit).
add_conda_package	Ajoute un package Conda.
add_pip_package	Ajoute un package pip. Notes L’ajout d’une dépendance d’un package déjà référencé entraîne la suppression de la référence précédente et l’ajout d’une nouvelle référence à la fin de la liste des dépendances. Cela peut changer l’ordre des dépendances.
add_tensorflow_conda_package	Ajoute un package Conda TensorFlow.
add_tensorflow_pip_package	Ajoute un package pip TensorFlow.
as_dict	Retourne les dépendances Conda.
create	Initialise un nouvel objet CondaDependencies. Retourne une instance d’un objet CondaDependencies avec les dépendances spécifiées par l’utilisateur. Notes Si pip_packages n’est pas spécifié, azureml-defaults est ajouté en tant que dépendances par défaut. Les dépendances pip_packages spécifiées par l’utilisateur remplacent les valeurs par défaut. Si pin_sdk_version a la valeur true, les dépendances pip des packages distribués dans le cadre du kit SDK Azure Machine Learning pour Python sont épinglées à la version du kit SDK installée dans l’environnement actuel.
get_default_number_of_packages	Retourne le nombre de packages par défaut.
get_python_version	Retourne la version de Python.
merge_requirements	Fusionne les conditions relatives aux packages.
remove_channel	Supprime un canal Conda.
remove_conda_package	Supprime un package Conda.
remove_pip_option	Supprime une option pip.
remove_pip_package	Supprime un package pip.
save	Enregistre l’objet de dépendances Conda dans un fichier.
save_to_file	DÉPRÉCIÉ, utilisez save. Enregistre l’objet de dépendances Conda dans un fichier.
sdk_origin_url	Retourne l’URL d’index d’origine du kit SDK.
serialize_to_string	Sérialise l’objet de dépendances Conda dans une chaîne.
set_pip_index_url	Définit l’URL d’index pip.
set_pip_option	Ajoute une option pip.
set_pip_requirements	Remplace l’intégralité de la section pip des dépendances Conda.
set_python_version	Définit la version de Python.

add_channel

Ajoute un canal Conda.

Vous trouverez une liste des canaux sur https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/

add_channel(channel)

Paramètres

channel: str

Obligatoire

Canal Conda à ajouter.

Type de retour

None

add_cntk_package

Ajoute un package CNTK (Microsoft Cognitive Toolkit).

add_cntk_package(core_type='cpu')

Paramètres

core_type: str

valeur par défaut: cpu

« cpu » ou « gpu ».

add_conda_package

Ajoute un package Conda.

add_conda_package(conda_package)

Paramètres

conda_package: str

Obligatoire

Package Conda à ajouter.

add_pip_package

Ajoute un package pip.

Notes

L’ajout d’une dépendance d’un package déjà référencé entraîne la suppression de la référence précédente et l’ajout d’une nouvelle référence à la fin de la liste des dépendances. Cela peut changer l’ordre des dépendances.

add_pip_package(pip_package)

Paramètres

pip_package: str

Obligatoire

Package pip à ajouter.

add_tensorflow_conda_package

Ajoute un package Conda TensorFlow.

add_tensorflow_conda_package(core_type='cpu', version=None)

Paramètres

core_type: str

valeur par défaut: cpu

« cpu » ou « gpu ».

version: str

valeur par défaut: None

Version du package.

add_tensorflow_pip_package

Ajoute un package pip TensorFlow.

add_tensorflow_pip_package(core_type='cpu', version=None)

Paramètres

core_type: str

valeur par défaut: cpu

« cpu » ou « gpu ».

version: str

valeur par défaut: None

Version du package.

as_dict

Retourne les dépendances Conda.

as_dict() -> Any

create

Initialise un nouvel objet CondaDependencies.

Retourne une instance d’un objet CondaDependencies avec les dépendances spécifiées par l’utilisateur.

Notes

Si pip_packages n’est pas spécifié, azureml-defaults est ajouté en tant que dépendances par défaut. Les dépendances pip_packages spécifiées par l’utilisateur remplacent les valeurs par défaut.

Si pin_sdk_version a la valeur true, les dépendances pip des packages distribués dans le cadre du kit SDK Azure Machine Learning pour Python sont épinglées à la version du kit SDK installée dans l’environnement actuel.

static create(pip_indexurl=None, pip_packages=None, conda_packages=None, python_version='3.8.13', pin_sdk_version=True)

Paramètres

pip_indexurl: str

valeur par défaut: None

URL de l’index pip. En l’absence d’indication, l’URL d’index d’origine du kit SDK est utilisée.

pip_packages: list[str]

valeur par défaut: None

Liste des packages pip.

conda_packages: list[str]

valeur par défaut: None

Liste des packages Conda.

python_version: str

valeur par défaut: 3.8.13

Version de Python.

pin_sdk_version: bool

valeur par défaut: True

Indique s’il est nécessaire d’épingler les packages du kit SDK à la version client.

Retours

Objet de dépendance Conda.

Type de retour

CondaDependencies

get_default_number_of_packages

Retourne le nombre de packages par défaut.

get_default_number_of_packages()

Retours

Nombre par défaut de packages Conda et pip.

Type de retour

int

get_python_version

Retourne la version de Python.

get_python_version()

Retours

Version de Python.

Type de retour

str

merge_requirements

Fusionne les conditions relatives aux packages.

static merge_requirements(requirements)

Paramètres

requirements: list[str]

Obligatoire

Liste des conditions relatives aux packages à fusionner.

Retours

Liste des conditions relatives aux packages fusionnées.

Type de retour

list[str]

remove_channel

Supprime un canal Conda.

remove_channel(channel)

Paramètres

channel: str

Obligatoire

Canal Conda à supprimer.

remove_conda_package

Supprime un package Conda.

remove_conda_package(conda_package)

Paramètres

conda_package: str

Obligatoire

Package Conda à supprimer.

remove_pip_option

Supprime une option pip.

remove_pip_option(pip_option)

Paramètres

pip_option: str

Obligatoire

Option pip à supprimer.

remove_pip_package

Supprime un package pip.

remove_pip_package(pip_package)

Paramètres

pip_package: str

Obligatoire

Package pip à supprimer.

save

Enregistre l’objet de dépendances Conda dans un fichier.

save(path=None)

Paramètres

path: str

valeur par défaut: None

Chemin complet du fichier dans lequel vous souhaitez effectuer l’enregistrement.

Retours

Chemin Conda normalisé.

Type de retour

str

Exceptions

UserErrorException

Exception levée en cas de problèmes liés à l’enregistrement des dépendances.

save_to_file

DÉPRÉCIÉ, utilisez save.

Enregistre l’objet de dépendances Conda dans un fichier.

save_to_file(base_directory, conda_file_path=None)

Paramètres

base_directory: str

Obligatoire

Répertoire de base où enregistrer le fichier.

conda_file_path: str

valeur par défaut: None

Nom du fichier.

Retours

Chemin Conda normalisé.

Type de retour

str

sdk_origin_url

Retourne l’URL d’index d’origine du kit SDK.

static sdk_origin_url()

Retours

Retourne l’URL d’index d’origine du kit SDK.

Type de retour

str

serialize_to_string

Sérialise l’objet de dépendances Conda dans une chaîne.

serialize_to_string()

Retours

Objet de dépendances Conda sérialisé dans une chaîne.

Type de retour

str

set_pip_index_url

Définit l’URL d’index pip.

set_pip_index_url(index_url)

Paramètres

index_url: str

Obligatoire

URL d’index pip à utiliser.

set_pip_option

Ajoute une option pip.

set_pip_option(pip_option)

Paramètres

pip_option: str

Obligatoire

Option pip à ajouter.

set_pip_requirements

Remplace l’intégralité de la section pip des dépendances Conda.

set_pip_requirements(pip_requirements)

Paramètres

pip_requirements: list[str]

Obligatoire

Liste des packages et options pip.

set_python_version

Définit la version de Python.

set_python_version(version)

Paramètres

version: str

Obligatoire

Version de Python à ajouter.

Type de retour

None

Attributs

conda_channels

Retourne les canaux Conda.

Retours

Retourne les dépendances des canaux. Les dépendances retournées sont une copie. Les changements apportés aux canaux retournés n’entraînent pas de mise à jour des canaux Conda dans cet objet.

Type de retour

iter

conda_packages

Retourne les packages Conda.

Retours

Retourne les dépendances des packages. Retourne une copie des packages Conda. Les modifications apportées à la liste retournée ne sont pas reflétées dans les packages Conda de cet objet.

Type de retour

iter

pip_options

Retourne les options pip.

Retours

Retourne les options pip. Retourne une copie des options pip. Les modifications apportées à la liste retournée ne sont pas reflétées dans les options pip de cet objet.

Type de retour

iter

pip_packages

Retourne les dépendances pip.

Retours

Retourne les dépendances pip. Retourne une copie des packages pip. Les modifications apportées à la liste retournée ne sont pas reflétées dans les packages pip de cet objet.

Type de retour

iter

DEFAULT_NUMBER_OF_CONDA_PACKAGES

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0