CondaEnvironment@0 - Conda 环境 v0 任务

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

重要

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

语法

# Conda environment v0
# Create and activate a Conda environment.
- task: CondaEnvironment@0
  inputs:
    environmentName: # string. Required. Environment name. 
    #packageSpecs: 'python=3' # string. Package specs. Default: python=3.
    #updateConda: true # boolean. Update to the latest Conda. Default: true.
  # Advanced
    #createOptions: # string. Environment creation options. 
    #cleanEnvironment: false # boolean. Clean the environment. Default: false.
# Conda Environment v0
# Create and activate a Conda environment.
- task: CondaEnvironment@0
  inputs:
    environmentName: # string. Required. Environment name. 
    #packageSpecs: 'python=3' # string. Package specs. Default: python=3.
    #updateConda: true # boolean. Update to the latest Conda. Default: true.
  # Advanced
    #createOptions: # string. Environment creation options. 
    #cleanEnvironment: false # boolean. Clean the environment. Default: false.

输入

environmentName - 环境名称
string. 必需。

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


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

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


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

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


createOptions - 环境创建选项
string.

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


cleanEnvironment - 清理环境
boolean. 默认值: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
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置变量 任意
代理版本 所有支持的代理版本。
任务类别