CondaEnvironment@0 - Conda environment v0 工作

發行項
07/02/2024

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

重要

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

Syntax

# 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 至最新版本。這適用于在中 PATH 找到的 Conda 安裝，或套用至環境變數所 CONDA 指定的路徑。

createOptions - 環境建立選項
string.

要傳遞至 conda create 命令之其他選項的空間分隔清單。

cleanEnvironment - 清除環境
boolean. 預設值：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 的自我裝載代理程式。
如果使用自我裝載代理程式，您必須將可執行檔新增 conda 至 PATH 或將環境變數設定 CONDA 為 Conda 安裝的根目錄。

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

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

規格需求

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

共用方式為