共用方式為


CondaEnvironment@1 - Conda 環境 v1 工作

使用此工作來建立並啟用 Conda 環境。

重要

此工作已被取代,且將于 2024 年 1 月 31 日淘汰。 直接在bash 工作批次腳本工作中使用conda 命令作為替代方案。

使用此工作來建立並啟用 Conda 環境。

重要

此工作已被取代。 直接在bash 工作批次腳本工作中使用conda 命令作為替代方案。

建立並啟用 Conda 環境。

Syntax

# 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.
# Conda Environment v1
# Create and activate a Conda environment.
- 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 裝載的代理程式預設不會有 Conda PATH 。 您必須執行這項工作,才能使用 Conda。

執行這項工作之後, PATH 將會包含已啟用環境的二進位目錄,後面接著 Conda 安裝本身的二進位目錄。 您可以執行腳本作為後續建置工作,以執行 Python、Conda 或您安裝之其他套件的命令列公用程式。 例如,您可以使用 pytest 執行測試,或使用 Anaconda 用戶端將套件上傳至 Anaconda Cloud。

提示

執行這項工作之後,環境將會「啟動」,而您藉由呼叫 conda install 安裝的套件將會安裝到此環境。

必要條件

  • Microsoft 裝載的代理程式,或已安裝 Anaconda 或 Miniconda 的自我裝載代理程式。
  • 如果使用自我裝載代理程式,您必須將可執行檔新增 condaPATH 或將環境變數設定 CONDA 為 Conda 安裝的根目錄。

如何設定自我裝載代理程式以使用這項工作?

您可以使用這項工作搭配完整的 Anaconda 安裝或 Miniconda 安裝。 如果使用自我裝載代理程式,您必須將 conda 可執行檔新增至 PATH 。 或者,您可以將環境變數設定 CONDA 為 Conda 安裝的根目錄,也就是您在安裝 Conda 時指定為「前置詞」的目錄。

規格需求

需求 描述
管線類型 YAML、傳統組建、傳統版本
在 上執行 Agent、DeploymentGroup
要求
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任何
可設定變數 任何
代理程式版本 所有支援的代理程式版本。
工作類別 套件