CondaEnvironment@1 - Conda 环境 v1 任务

使用此任务创建和激活 Conda 环境。

重要

此任务已弃用，将于 2024 年 1 月 31 日停用。 直接在 bash 任务或批处理脚本任务中使用 conda 命令作为替代方法。

语法

# Conda environment v1
# This task is deprecated. Use `conda` directly in script to work with Anaconda environments.
- task: CondaEnvironment@1
  inputs:
    #createCustomEnvironment: false # boolean. Create a custom environment. Default: false.
    #environmentName: # string. Required when createCustomEnvironment == true. Environment name. 
    #packageSpecs: 'python=3' # string. Package specs. Default: python=3.
    #updateConda: true # boolean. Update to the latest Conda. Default: true.
    #installOptions: # string. Optional. Use when createCustomEnvironment == false. Other options for `conda install`. 
    #createOptions: # string. Optional. Use when createCustomEnvironment == true. Other options for `conda create`. 
    #cleanEnvironment: false # boolean. Optional. Use when createCustomEnvironment == true. Clean the environment. Default: false.

输入

createCustomEnvironment - 创建自定义环境
boolean. 默认值：false。

如果此布尔值的值设置为 true，则任务 将创建 或重新激活 Conda 环境，而不是使用 base 环境。 对于自托管代理，建议将值设置为 true 。

environmentName - 环境名称
string. 当 createCustomEnvironment == true 时，需要此选项。

要创建和激活或重新激活的 Conda 环境的名称（如果已存在）。

packageSpecs - 包规格
string. 默认值：python=3。

要安装在环境中的包的空格分隔列表。

updateConda - 更新到最新的 Conda
boolean. 默认值：true。

汇报 Conda 升级到最新版本。 这适用于在 或 环境变量指定的路径中找到 PATH 的 CONDA Conda 安装。

installOptions - 的其他选项 conda install
string. 可选。 在 时 createCustomEnvironment == false使用 。

要传递给 conda install 命令的其他参数的空格分隔列表。

createOptions - 的其他选项 conda create
string. 可选。 在 时 createCustomEnvironment == true使用 。

要传递给 conda create 命令的其他选项的空格分隔列表。

cleanEnvironment - 清洁环境
boolean. 可选。 在 时 createCustomEnvironment == true使用 。 默认值：false。

删除环境并重新创建它（如果已存在）。 如果未选择此布尔值，则任务将重新激活现有环境。

任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

备注

使用此任务创建和激活 Conda 环境。

重要

此任务已弃用。 直接在 bash 任务或批处理脚本任务中使用 conda 命令作为替代方法。

此任务将创建 Conda 环境并将其激活，用于后续生成任务。

如果任务找到一个具有相同名称的现有环境，则任务只需重新激活它即可。 这在自托管代理上是可能的。 若要重新创建环境并重新安装其所有包，请设置“清理环境”选项。

使用“更新到最新 Conda”选项运行时，系统会尝试在创建或激活环境之前更新 Conda。 如果正在运行自托管代理并已配置了 Conda 安装来处理任务，则可能会导致 Conda 安装被更新。

注意

默认情况下，Microsoft 托管代理在其 PATH 中不会有 Conda。 需要运行此任务才能使用 Conda。

运行此任务后，PATH 将包含已激活环境的二进制目录，后跟 Conda 安装本身的二进制目录。 可以将脚本作为运行 Python、Conda 或安装的其他包中的命令行实用工具的后续生成任务来运行。 例如，可以使用 pytest 来运行测试，或使用 Anaconda 客户端将包上传到 Anaconda Cloud。

提示

运行此任务后，环境会被“激活”，你通过调用 conda install 安装的包会安装到此环境中。

先决条件

• Microsoft 托管代理，或安装了 Anaconda 或 Miniconda 的自托管代理。
• 如果使用自托管代理，必须将 conda 可执行文件添加到 PATH 或将 CONDA 环境变量设置为 Conda 安装的根目录。

如何将自托管代理配置为使用此任务？

可以将此任务用于完整 Anaconda 安装或 Miniconda 安装。 如果使用自托管代理，必须将 conda 可执行文件添加到 PATH。 也可将 CONDA 环境变量设置为 Conda 安装的根目录，即你在安装 Conda 时指定为“前缀”的目录。

要求

要求	说明
管道类型	YAML，经典内部版本，经典版本
运行平台	Agent、DeploymentGroup
需求	无
功能	此任务不满足作业中后续任务的任何要求。
命令限制	任意
可设置的变量	任意
代理版本	所有支持的代理版本。
任务类别	包