CondaEnvironment@1 - Conda 環境 v1 工作

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

重要

此工作已被取代，且將于 2024 年 1 月 31 日淘汰。 直接在bash 工作或批次腳本工作中使用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.

輸入

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

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

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

規格需求

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