CondaDependencies 类

管理 Azure 机器学习环境中的应用程序依赖项。

注释

如果未指定任何参数，azureml-defaults 将添加为唯一的 pip 依赖项。

conda_dependencies_file_path如果未指定参数，则 CondaDependencies 对象仅包含 Azure 机器学习包（azureml-defaults）。 azureml-defaults 依赖项不会固定到特定版本，并将面向 PyPi 上可用的最新版本。

初始化用于管理依赖项的新对象。

构造函数

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

参数

名称	说明
conda_dependencies_file_path	str conda 配置文件的本地路径。使用此参数可以加载和编辑现有 Conda 环境文件。默认值: None
_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 通道。可以在中找到频道列表
add_cntk_package	添加Microsoft认知工具包（CNTK）包。
add_conda_package	添加 conda 包。
add_pip_package	添加 pip 包。注释添加已引用包的依赖项将删除以前的引用，并向依赖项列表末尾添加新引用。这可能会更改依赖项的顺序。
add_tensorflow_conda_package	添加 Tensorflow conda 包。
add_tensorflow_pip_package	添加 Tensorflow pip 包。
as_dict	返回 conda 依赖项。
create	初始化新的 CondaDependencies 对象。返回具有用户指定依赖项的 CondaDependencies 对象的实例。注释如果未指定pip_packages，azureml-defaults 将添加为默认依赖项。用户指定的pip_packages依赖项将覆盖默认值。如果pin_sdk_version设置为 true，则作为 Azure 机器学习 Python SDK 一部分分发的包的 pip 依赖项将固定到当前环境中安装的 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	返回 SDK 源索引 URL。
serialize_to_string	将 conda dependencies 对象序列化为字符串。
set_pip_index_url	设置 pip 索引 URL。
set_pip_option	添加 pip 选项。
set_pip_requirements	覆盖 conda 依赖项的整个 pip 部分。
set_python_version	设置 Python 版本。

add_channel

添加 conda 通道。

可以在中找到频道列表

add_channel(channel)

参数

名称	说明
channel 必需	str 要添加的 conda 通道。

类型	说明
None

add_cntk_package

添加Microsoft认知工具包（CNTK）包。

add_cntk_package(core_type='cpu')

参数

名称	说明
core_type	str “cpu”或“gpu”。默认值: 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

添加 Tensorflow conda 包。

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

参数

名称	说明
core_type	str “cpu”或“gpu”。默认值: cpu
version	str 包版本。默认值: None

add_tensorflow_pip_package

添加 Tensorflow pip 包。

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

参数

名称	说明
core_type	str “cpu”或“gpu”。默认值: cpu
version	str 包版本。默认值: None

as_dict

返回 conda 依赖项。

as_dict() -> Any

create

初始化新的 CondaDependencies 对象。

返回具有用户指定依赖项的 CondaDependencies 对象的实例。

注释

如果未指定pip_packages，azureml-defaults 将添加为默认依赖项。用户指定的pip_packages依赖项将覆盖默认值。

如果pin_sdk_version设置为 true，则作为 Azure 机器学习 Python SDK 一部分分发的包的 pip 依赖项将固定到当前环境中安装的 SDK 版本。

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

参数

名称	说明
pip_indexurl	str pip 索引 URL。如果未指定，将使用 SDK 源索引 URL。默认值: None
pip_packages	list[str] pip 包的列表。默认值: None
conda_packages	list[str] conda 包的列表。默认值: None
python_version	str Python 版本。默认值: 3.9.12
pin_sdk_version	bool 指示是否将 SDK 包固定到客户端版本。默认值: True

类型	说明
CondaDependencies	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 必需	list[str] 要合并的包要求的列表。

类型	说明
list[str]	合并包要求的列表。

remove_channel

删除 conda 通道。

remove_channel(channel)

参数

名称	说明
channel 必需	str 要删除的 conada 通道。

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

类型	说明
str	规范化 conda 路径。

例外

类型	说明
UserErrorException	保存依赖项时出现问题。

save_to_file

已弃用，使用 save。

将 conda 依赖项对象保存到文件中。

save_to_file(base_directory, conda_file_path=None)

参数

名称	说明
base_directory 必需	str 要保存文件的基目录。
conda_file_path	str 文件名。默认值: None

类型	说明
str	规范化 conda 路径。

sdk_origin_url

返回 SDK 源索引 URL。

static sdk_origin_url()

类型	说明
str	返回 SDK 源索引 URL。

serialize_to_string

将 conda dependencies 对象序列化为字符串。

serialize_to_string()

类型	说明
str	序列化为字符串的 conda 依赖项对象。

set_pip_index_url

设置 pip 索引 URL。

set_pip_index_url(index_url)

参数

名称	说明
index_url 必需	str 要使用的 pip 索引 URL。

set_pip_option

添加 pip 选项。

set_pip_option(pip_option)

参数

名称	说明
pip_option 必需	str 要添加的 pip 选项。

set_pip_requirements

覆盖 conda 依赖项的整个 pip 部分。

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 通道。

类型	说明
iter	返回通道依赖项。返回的依赖项是副本，返回的通道的任何更改都不会更新此对象中的 conda 通道。

conda_packages

返回 conda 包。

类型	说明
iter	返回包依赖项。返回 conda 包的副本，返回的列表的任何编辑都不会反映在此对象的 conda 包中。

pip_options

返回 pip 选项。

类型	说明
iter	返回 pip 选项。返回 pip 选项的副本，并且返回的列表的任何编辑都不会反映在此对象的 pip 选项中。

pip_packages

返回 pip 依赖项。

类型	说明
iter	返回 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

通过