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

значение по умолчанию: None

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

_underlying_structure

значение по умолчанию: 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.

Возвращаемый тип

None

add_cntk_package

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

add_cntk_package(core_type='cpu')

Параметры

core_type

str

значение по умолчанию: cpu

"cpu" или "gpu".

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

"cpu" или "gpu".

version

str

значение по умолчанию: None

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

add_tensorflow_pip_package

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

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

Параметры

core_type

str

значение по умолчанию: cpu

"cpu" или "gpu".

version

str

значение по умолчанию: 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.8.13', pin_sdk_version=True)

Параметры

pip_indexurl

str

значение по умолчанию: None

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

pip_packages

list[str]

значение по умолчанию: None

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

conda_packages

list[str]

значение по умолчанию: None

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

python_version

str

значение по умолчанию: 3.8.13

Версия Python.

pin_sdk_version

bool

значение по умолчанию: True

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

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

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

Возвращаемый тип

CondaDependencies

get_default_number_of_packages

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

get_default_number_of_packages()

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

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

Возвращаемый тип

int

get_python_version

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

get_python_version()

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

Версия Python.

Возвращаемый тип

str

merge_requirements

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

static merge_requirements(requirements)

Параметры

requirements

list[str]

Обязательно

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

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

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

Возвращаемый тип

list[str]

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

значение по умолчанию: None

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

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

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

Возвращаемый тип

str

Исключения

UserErrorException

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

save_to_file

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

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

save_to_file(base_directory, conda_file_path=None)

Параметры

base_directory

str

Обязательно

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

conda_file_path

str

значение по умолчанию: None

Имя файла.

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

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

Возвращаемый тип

str

sdk_origin_url

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

static sdk_origin_url()

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

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

Возвращаемый тип

str

serialize_to_string

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

serialize_to_string()

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

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

Возвращаемый тип

str

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

list[str]

Обязательно

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

set_python_version

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

set_python_version(version)

Параметры

version

str

Обязательно

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

Возвращаемый тип

None

Атрибуты

conda_channels

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

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

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

Возвращаемый тип

iter

conda_packages

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

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

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

Возвращаемый тип

iter

pip_options

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

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

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

Возвращаемый тип

iter

pip_packages

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

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

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

Возвращаемый тип

iter

DEFAULT_NUMBER_OF_CONDA_PACKAGES

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0