使用此任务创建和激活 Conda 环境。
重要
此任务已弃用，将于 2024 年 1 月 31 日停用。 将 conda 命令直接bash 任务 或 批处理脚本任务 作为替代方法。
使用此任务创建和激活 Conda 环境。
重要
此任务已弃用。 将 conda 命令直接bash 任务 或 批处理脚本任务 作为替代方法。
语法
# 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 环境。
重要
此任务已弃用。 将 conda 命令直接bash 任务 或 批处理脚本任务 作为替代方法。
此任务将创建 Conda 环境，并将其激活为后续生成任务。
如果任务找到具有相同名称的现有环境，该任务将只重新激活它。 这可以在自承载代理上实现。 若要重新创建环境并重新安装其任何包，请设置“清理环境”选项。
在创建或激活环境之前，使用“更新到最新的 Conda”选项运行将尝试更新 Conda。 如果运行的是自承载代理，并且已 将 Conda 安装配置为使用任务，则可能会导致 Conda 安装更新。
注释
默认情况下，Microsoft托管的代理在其 PATH 中没有 Conda。 需要运行此任务才能使用 Conda。
运行此任务后，PATH 将包含已激活环境的二进制目录，后跟 Conda 安装本身的二进制目录。
可以将脚本作为后续生成任务运行，这些任务运行 Python、Conda 或安装的其他包中的命令行实用工具。
例如，可以使用 pytest 运行测试，或使用 Anaconda 客户端将包上传到 Anaconda Cloud。
小提示
运行此任务后，环境将“激活”，通过调用 conda install 安装的包将安装到此环境。
先决条件
- 安装了 anaconda 或 Miniconda 的Microsoft托管代理或自承载代理。
- 如果使用自承载代理，则必须将
conda可执行文件添加到PATH，或将CONDA环境变量设置为 Conda 安装的根目录。
如何配置自承载代理以使用此任务？
可以将此任务用于完整的 Anaconda 安装或 Miniconda 安装。
如果使用自承载代理，则必须将 conda 可执行文件添加到 PATH。
或者，可以将 CONDA 环境变量设置为 Conda 安装的根目录，即在安装 Conda 时指定为“前缀”的目录。