CondaDependencies Класс
Управляет зависимостями приложений в среде Машинного обучения Microsoft Azure.
Примечание
Если параметры не указаны, то в качестве единственной зависимости PIP добавляется значение "azureml-default".
Если параметр conda_dependencies_file_path
не указан, то объект CondaDependencies содержит только пакеты Машинного обучения Microsoft Azure (azureml-defaults).
Зависимость azureml-defaults не будет закреплена в определенной версии и будет нацелена на последнюю версию, доступную в PyPi.
Инициализация нового объекта для управления зависимостями.
- Наследование
-
builtins.objectCondaDependencies
Конструктор
CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)
Параметры
Имя | Описание |
---|---|
conda_dependencies_file_path
|
Локальный путь к файлу конфигурации 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
Обязательно
|
Добавляемый канал Conda. |
Возвращаемое значение
Тип | Описание |
---|---|
add_cntk_package
Добавляет пакет Microsoft Cognitive Toolkit (CNTK).
add_cntk_package(core_type='cpu')
Параметры
Имя | Описание |
---|---|
core_type
|
"cpu" или "gpu". Default value: cpu
|
add_conda_package
Добавляет пакет Conda.
add_conda_package(conda_package)
Параметры
Имя | Описание |
---|---|
conda_package
Обязательно
|
Добавляемый пакет Conda. |
add_pip_package
Добавляет пакет PIP.
Примечание
Добавление зависимости от уже указанного пакета приведет к удалению предыдущей ссылки и добавлению новой ссылки в конец списка зависимостей. Это может изменить порядок зависимостей.
add_pip_package(pip_package)
Параметры
Имя | Описание |
---|---|
pip_package
Обязательно
|
Добавляемый пакет PIP. |
add_tensorflow_conda_package
Добавляет пакет Conda Tensorflow.
add_tensorflow_conda_package(core_type='cpu', version=None)
Параметры
Имя | Описание |
---|---|
core_type
|
"cpu" или "gpu". Default value: cpu
|
version
|
Версия пакета. Default value: None
|
add_tensorflow_pip_package
Добавляет пакет PIP Tensorflow.
add_tensorflow_pip_package(core_type='cpu', version=None)
Параметры
Имя | Описание |
---|---|
core_type
|
"cpu" или "gpu". Default value: cpu
|
version
|
Версия пакета. 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
|
URL-адрес индекса PIP. Если он не указан, то будет использоваться URL-адрес исходного индекса SDK. Default value: None
|
pip_packages
|
Список пакетов PIP. Default value: None
|
conda_packages
|
Список пакетов Conda. Default value: None
|
python_version
|
Версия Python. Default value: 3.9.12
|
pin_sdk_version
|
Указывает, следует ли привязывать пакеты SDK к версии клиента. Default value: True
|
Возвращаемое значение
Тип | Описание |
---|---|
Объект зависимости Conda. |
get_default_number_of_packages
Возвращает число пакетов по умолчанию.
get_default_number_of_packages()
Возвращаемое значение
Тип | Описание |
---|---|
Число пакетов Conda и PIP по умолчанию. |
get_python_version
Возвращает версию Python.
get_python_version()
Возвращаемое значение
Тип | Описание |
---|---|
Версия Python. |
merge_requirements
Объединяет требования к пакетам.
static merge_requirements(requirements)
Параметры
Имя | Описание |
---|---|
requirements
Обязательно
|
Список требований к пакетам для объединения. |
Возвращаемое значение
Тип | Описание |
---|---|
Список объединенных требований к пакетам. |
remove_channel
Удаляет канал Conda.
remove_channel(channel)
Параметры
Имя | Описание |
---|---|
channel
Обязательно
|
Удаляемый канал Conda. |
remove_conda_package
Удаляет пакет Conda.
remove_conda_package(conda_package)
Параметры
Имя | Описание |
---|---|
conda_package
Обязательно
|
Удаляемый пакет Conda. |
remove_pip_option
Удаляет параметр PIP.
remove_pip_option(pip_option)
Параметры
Имя | Описание |
---|---|
pip_option
Обязательно
|
Удаляемый параметр PIP. |
remove_pip_package
Удаляет пакет PIP.
remove_pip_package(pip_package)
Параметры
Имя | Описание |
---|---|
pip_package
Обязательно
|
Удаляемый пакет PIP. |
save
Сохраняет объект зависимостей Conda в файл.
save(path=None)
Параметры
Имя | Описание |
---|---|
path
|
Полный путь к файлу, который необходимо сохранить. Default value: None
|
Возвращаемое значение
Тип | Описание |
---|---|
Нормализованный путь Conda. |
Исключения
Тип | Описание |
---|---|
Вызывается в случае проблем, связанных с сохранением зависимостей. |
save_to_file
Не рекомендуется, используйте save.
Сохраняет объект зависимостей Conda в файл.
save_to_file(base_directory, conda_file_path=None)
Параметры
Имя | Описание |
---|---|
base_directory
Обязательно
|
Базовый каталог для сохранения файла. |
conda_file_path
|
Имя файла. Default value: None
|
Возвращаемое значение
Тип | Описание |
---|---|
Нормализованный путь Conda. |
sdk_origin_url
Возвращает URL-адрес исходного индекса SDK.
static sdk_origin_url()
Возвращаемое значение
Тип | Описание |
---|---|
Возвращает URL-адрес исходного индекса SDK. |
serialize_to_string
Сериализует объект зависимостей Conda в строку.
serialize_to_string()
Возвращаемое значение
Тип | Описание |
---|---|
Объект зависимостей Conda, сериализованный в строку. |
set_pip_index_url
Задает URL-адрес индекса PIP.
set_pip_index_url(index_url)
Параметры
Имя | Описание |
---|---|
index_url
Обязательно
|
Используемый URL-адрес индекса PIP. |
set_pip_option
Добавляет параметр PIP.
set_pip_option(pip_option)
Параметры
Имя | Описание |
---|---|
pip_option
Обязательно
|
Добавляемый параметр PIP. |
set_pip_requirements
Перезаписывает весь раздел PIP зависимостей Conda.
set_pip_requirements(pip_requirements)
Параметры
Имя | Описание |
---|---|
pip_requirements
Обязательно
|
Список пакетов и параметров PIP. |
set_python_version
Задает версию Python.
set_python_version(version)
Параметры
Имя | Описание |
---|---|
version
Обязательно
|
Добавляемая версия 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