Поделиться через


CondaDependencies Класс

Управляет зависимостями приложений в среде Машинного обучения Microsoft Azure.

Примечание

Если параметры не указаны, то в качестве единственной зависимости PIP добавляется значение "azureml-default".

Если параметр conda_dependencies_file_path не указан, то объект CondaDependencies содержит только пакеты Машинного обучения Microsoft Azure (azureml-defaults). Зависимость azureml-defaults не будет закреплена в определенной версии и будет нацелена на последнюю версию, доступную в PyPi.

Инициализация нового объекта для управления зависимостями.

Наследование
builtins.object
CondaDependencies

Конструктор

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Параметры

Имя Описание
conda_dependencies_file_path
str

Локальный путь к файлу конфигурации Conda. С помощью этого параметра можно загрузить и изменить существующий файл среды Conda.

Default value: None
_underlying_structure
Default value: None

Комментарии

Вы можете загрузить существующий файл среды Conda или настроить зависимости приложений и управлять ими в памяти. Во время отправки эксперимента выполняется этап подготовки, на котором создается и кэшируется среда Conda, в которой выполняется эксперимент.

Если зависимость доступна как в Conda, так и в PIP (из PyPi), используйте версию Conda, так как пакеты Conda обычно поставляются с предварительно созданными двоичными файлами, которые повышают надежность установки. Для получения дополнительной информации см. раздел Основные сведения о Conda и PIP.

Дополнительные сведения о зависимостях базовых образов см. в репозитории https://github.com/Azure/AzureML-Containers.

В следующем примере демонстрируется, как добавить пакет с помощью 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))

Полный пример можно найти по адресу: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

Также можно добавить пакет PIP и задать зависимости в объекте Environment.


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

Полный пример можно найти по адресу: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb

Методы

add_channel

Добавляет канал Conda.

Список каналов можно найти по адресу https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/

add_cntk_package

Добавляет пакет Microsoft Cognitive Toolkit (CNTK).

add_conda_package

Добавляет пакет Conda.

add_pip_package

Добавляет пакет PIP.

Примечание

Добавление зависимости от уже указанного пакета приведет к удалению предыдущей ссылки и добавлению новой ссылки в конец списка зависимостей. Это может изменить порядок зависимостей.

add_tensorflow_conda_package

Добавляет пакет Conda Tensorflow.

add_tensorflow_pip_package

Добавляет пакет PIP Tensorflow.

as_dict

Возвращает зависимости Conda.

create

Инициализирует новый объект CondaDependencies.

Возвращает экземпляр объекта CondaDependencies с заданными пользователем зависимостями.

Примечание

Если параметр pip_packages не указан, то в качестве зависимостей по умолчанию будут добавлены значения azureml-default. Указанные пользователем зависимости pip_packages будут переопределять значения по умолчанию.

Если pin_sdk_version имеет значение true, то зависимости пакетов PIP, распространяемые в составе пакета SDK Машинного обучения Azure для Python, будут привязаны к версии пакета SDK, установленного в текущей среде.

get_default_number_of_packages

Возвращает число пакетов по умолчанию.

get_python_version

Возвращает версию Python.

merge_requirements

Объединяет требования к пакетам.

remove_channel

Удаляет канал Conda.

remove_conda_package

Удаляет пакет Conda.

remove_pip_option

Удаляет параметр PIP.

remove_pip_package

Удаляет пакет PIP.

save

Сохраняет объект зависимостей Conda в файл.

save_to_file

Не рекомендуется, используйте save.

Сохраняет объект зависимостей Conda в файл.

sdk_origin_url

Возвращает URL-адрес исходного индекса SDK.

serialize_to_string

Сериализует объект зависимостей Conda в строку.

set_pip_index_url

Задает URL-адрес индекса PIP.

set_pip_option

Добавляет параметр PIP.

set_pip_requirements

Перезаписывает весь раздел PIP зависимостей Conda.

set_python_version

Задает версию Python.

add_channel

Добавляет канал Conda.

Список каналов можно найти по адресу https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/

add_channel(channel)

Параметры

Имя Описание
channel
Обязательно
str

Добавляемый канал Conda.

Возвращаемое значение

Тип Описание

add_cntk_package

Добавляет пакет Microsoft Cognitive Toolkit (CNTK).

add_cntk_package(core_type='cpu')

Параметры

Имя Описание
core_type
str

"cpu" или "gpu".

Default value: cpu

add_conda_package

Добавляет пакет Conda.

add_conda_package(conda_package)

Параметры

Имя Описание
conda_package
Обязательно
str

Добавляемый пакет Conda.

add_pip_package

Добавляет пакет PIP.

Примечание

Добавление зависимости от уже указанного пакета приведет к удалению предыдущей ссылки и добавлению новой ссылки в конец списка зависимостей. Это может изменить порядок зависимостей.

add_pip_package(pip_package)

Параметры

Имя Описание
pip_package
Обязательно
str

Добавляемый пакет PIP.

add_tensorflow_conda_package

Добавляет пакет Conda Tensorflow.

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

Параметры

Имя Описание
core_type
str

"cpu" или "gpu".

Default value: cpu
version
str

Версия пакета.

Default value: None

add_tensorflow_pip_package

Добавляет пакет PIP Tensorflow.

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

Параметры

Имя Описание
core_type
str

"cpu" или "gpu".

Default value: cpu
version
str

Версия пакета.

Default value: None

as_dict

Возвращает зависимости Conda.

as_dict() -> Any

create

Инициализирует новый объект CondaDependencies.

Возвращает экземпляр объекта CondaDependencies с заданными пользователем зависимостями.

Примечание

Если параметр pip_packages не указан, то в качестве зависимостей по умолчанию будут добавлены значения azureml-default. Указанные пользователем зависимости pip_packages будут переопределять значения по умолчанию.

Если pin_sdk_version имеет значение true, то зависимости пакетов PIP, распространяемые в составе пакета SDK Машинного обучения Azure для Python, будут привязаны к версии пакета SDK, установленного в текущей среде.

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

Параметры

Имя Описание
pip_indexurl
str

URL-адрес индекса PIP. Если он не указан, то будет использоваться URL-адрес исходного индекса SDK.

Default value: None
pip_packages

Список пакетов PIP.

Default value: None
conda_packages

Список пакетов Conda.

Default value: None
python_version
str

Версия Python.

Default value: 3.9.12
pin_sdk_version

Указывает, следует ли привязывать пакеты SDK к версии клиента.

Default value: True

Возвращаемое значение

Тип Описание

Объект зависимости Conda.

get_default_number_of_packages

Возвращает число пакетов по умолчанию.

get_default_number_of_packages()

Возвращаемое значение

Тип Описание
int

Число пакетов Conda и PIP по умолчанию.

get_python_version

Возвращает версию Python.

get_python_version()

Возвращаемое значение

Тип Описание
str

Версия Python.

merge_requirements

Объединяет требования к пакетам.

static merge_requirements(requirements)

Параметры

Имя Описание
requirements
Обязательно

Список требований к пакетам для объединения.

Возвращаемое значение

Тип Описание

Список объединенных требований к пакетам.

remove_channel

Удаляет канал Conda.

remove_channel(channel)

Параметры

Имя Описание
channel
Обязательно
str

Удаляемый канал Conda.

remove_conda_package

Удаляет пакет Conda.

remove_conda_package(conda_package)

Параметры

Имя Описание
conda_package
Обязательно
str

Удаляемый пакет Conda.

remove_pip_option

Удаляет параметр PIP.

remove_pip_option(pip_option)

Параметры

Имя Описание
pip_option
Обязательно
str

Удаляемый параметр PIP.

remove_pip_package

Удаляет пакет PIP.

remove_pip_package(pip_package)

Параметры

Имя Описание
pip_package
Обязательно
str

Удаляемый пакет PIP.

save

Сохраняет объект зависимостей Conda в файл.

save(path=None)

Параметры

Имя Описание
path
str

Полный путь к файлу, который необходимо сохранить.

Default value: None

Возвращаемое значение

Тип Описание
str

Нормализованный путь Conda.

Исключения

Тип Описание

Вызывается в случае проблем, связанных с сохранением зависимостей.

save_to_file

Не рекомендуется, используйте save.

Сохраняет объект зависимостей Conda в файл.

save_to_file(base_directory, conda_file_path=None)

Параметры

Имя Описание
base_directory
Обязательно
str

Базовый каталог для сохранения файла.

conda_file_path
str

Имя файла.

Default value: None

Возвращаемое значение

Тип Описание
str

Нормализованный путь Conda.

sdk_origin_url

Возвращает URL-адрес исходного индекса SDK.

static sdk_origin_url()

Возвращаемое значение

Тип Описание
str

Возвращает URL-адрес исходного индекса SDK.

serialize_to_string

Сериализует объект зависимостей Conda в строку.

serialize_to_string()

Возвращаемое значение

Тип Описание
str

Объект зависимостей Conda, сериализованный в строку.

set_pip_index_url

Задает URL-адрес индекса PIP.

set_pip_index_url(index_url)

Параметры

Имя Описание
index_url
Обязательно
str

Используемый URL-адрес индекса PIP.

set_pip_option

Добавляет параметр PIP.

set_pip_option(pip_option)

Параметры

Имя Описание
pip_option
Обязательно
str

Добавляемый параметр PIP.

set_pip_requirements

Перезаписывает весь раздел PIP зависимостей Conda.

set_pip_requirements(pip_requirements)

Параметры

Имя Описание
pip_requirements
Обязательно

Список пакетов и параметров PIP.

set_python_version

Задает версию Python.

set_python_version(version)

Параметры

Имя Описание
version
Обязательно
str

Добавляемая версия Python.

Возвращаемое значение

Тип Описание

Атрибуты

conda_channels

Возвращает каналы Conda.

Возвращаемое значение

Тип Описание

Возвращает зависимости канала. Возвращенные зависимости являются копией, и любые изменения в возвращенных каналах не будут отражены в каналах Conda в этом объекте.

conda_packages

Возвращает пакеты Conda.

Возвращаемое значение

Тип Описание

Возвращает зависимости пакета. Возвращает копию пакетов Conda, и любые изменения в возвращенном списке не будут отражены в пакетах Conda этого объекта.

pip_options

Возвращает параметры PIP.

Возвращаемое значение

Тип Описание

Возвращает параметры PIP. Возвращает копию параметров PIP, и любые изменения в возвращенном списке не будут отражены в параметрах PIP этого объекта.

pip_packages

Возвращает зависимости PIP.

Возвращаемое значение

Тип Описание

Возвращает зависимости PIP. Возвращает копию пакетов PIP, и любые изменения в возвращенном списке не будут отражены в пакетах PIP этого объекта.

DEFAULT_NUMBER_OF_CONDA_PACKAGES

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0