CondaEnvironment@0 - Conda environment v0 工作
語法
# 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 環境。
此工作會建立 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 |
| 需求 | 沒有 |
| 功能 | 此工作不符合作業中後續工作的任何需求。 |
| 命令限制 | 任意 |
| Settable 變數 | 任意 |
| 代理程式版本 | 所有支援的代理程式版本。 |
| 工作類別 | 套件/包裹 |