Freigeben über


CondaEnvironment@1 : Task "Conda-Umgebung v1"

Verwenden Sie diese Aufgabe, um eine Conda-Umgebung zu erstellen und zu aktivieren.

Wichtig

Diese Aufgabe ist veraltet und wird am 31. Januar 2024 eingestellt. Verwenden Sie als Alternative conda-Befehle direkt im Bash-Task oder Batchskripttask .

Verwenden Sie diese Aufgabe, um eine Conda-Umgebung zu erstellen und zu aktivieren.

Wichtig

Diese Aufgabe ist veraltet. Verwenden Sie als Alternative conda-Befehle direkt im Bash-Task oder Batchskripttask .

Erstellen und aktivieren Sie eine Conda-Umgebung.

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.

Eingaben

createCustomEnvironment - Erstellen einer benutzerdefinierten Umgebung
boolean. Standardwert. false.

Wenn der Wert für diesen booleschen Wert auf truefestgelegt ist, erstellt oder reaktiviert der Task eine Conda-Umgebung, anstatt die base Umgebung zu verwenden. Das Festlegen des Werts auf true wird für selbstgehostete Agents empfohlen.


environmentName - Umgebungsname
string. Erforderlich, wenn createCustomEnvironment == true.

Der Name der Conda-Umgebung, die erstellt und aktiviert oder reaktiviert werden soll, wenn sie bereits vorhanden ist.


packageSpecs - Paketspezifikationen
string. Standardwert. python=3.

Die Durch Leerzeichen getrennte Liste der Pakete, die in der Umgebung installiert werden sollen.


updateConda - Aktualisieren auf die neueste Conda
boolean. Standardwert. true.

Updates Conda auf die neueste Version. Dies gilt für die Conda-Installation in PATH oder für den pfad, der von der CONDA Umgebungsvariablen angegeben wird.


installOptions - Weitere Optionen für conda install
string. Optional. Verwenden Sie , wenn createCustomEnvironment == false.

Die Durch Leerzeichen getrennte Liste zusätzlicher Argumente, die an den conda install Befehl übergeben werden sollen.


createOptions - Weitere Optionen für conda create
string. Optional. Verwenden Sie , wenn createCustomEnvironment == true.

Die Durch Leerzeichen getrennte Liste mit zusätzlichen Optionen, die an den conda create Befehl übergeben werden sollen.


cleanEnvironment - Bereinigen der Umgebung
boolean. Optional. Verwenden Sie , wenn createCustomEnvironment == true. Standardwert. false.

Löscht die Umgebung und erstellt sie neu, wenn sie bereits vorhanden ist. Wenn dieser boolesche Wert nicht ausgewählt ist, wird eine vorhandene Umgebung durch die Aufgabe reaktiviert.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe, um eine Conda-Umgebung zu erstellen und zu aktivieren.

Wichtig

Diese Aufgabe ist veraltet. Verwenden Sie als Alternative conda-Befehle direkt im Bash-Task oder Batchskripttask .

Mit dieser Aufgabe wird eine Conda-Umgebung erstellt und für nachfolgende Buildaufgaben aktiviert.

Wenn der Task eine vorhandene Umgebung mit demselben Namen findet, wird sie von der Aufgabe einfach reaktiviert. Dies ist für selbstgehostete Agents möglich. Um die Umgebung neu zu erstellen und jedes ihrer Pakete neu zu installieren, legen Sie die Option "Umgebung bereinigen" fest.

Wenn Sie mit der Option "Auf neueste Conda aktualisieren" ausführen, wird versucht, Conda zu aktualisieren, bevor Sie die Umgebung erstellen oder aktivieren. Wenn Sie einen selbstgehosteten Agent ausführen und eine Conda-Installation für den Task konfiguriert haben, kann dies dazu führen, dass Ihre Conda-Installation aktualisiert wird.

Hinweis

Von Microsoft gehostete Agents verfügen standardmäßig nicht über Conda PATH . Sie müssen diese Aufgabe ausführen, um Conda verwenden zu können.

Nach dem Ausführen dieser Aufgabe PATH enthält das Binärverzeichnis für die aktivierte Umgebung, gefolgt von den binären Verzeichnissen für die Conda-Installation selbst. Sie können Skripts als nachfolgende Buildtasks ausführen, die Python, Conda oder die Befehlszeilenprogramme aus anderen Paketen ausführen, die Sie installieren. Sie können beispielsweise Tests mit pytest ausführen oder mit dem Anaconda-Client ein Paket in anaconda Cloud hochladen.

Tipp

Nach dem Ausführen dieser Aufgabe wird die Umgebung aktiviert, und Pakete, die Sie durch Aufrufen conda install installieren, werden in dieser Umgebung installiert.

Voraussetzungen

  • Ein von Microsoft gehosteter Agent oder ein selbstgehostete Agent mit installierter Anaconda oder Miniconda.
  • Wenn Sie einen selbstgehosteten Agent verwenden, müssen Sie entweder die conda ausführbare Datei hinzufügen PATH oder die CONDA Umgebungsvariable auf den Stamm der Conda-Installation festlegen.

Wie kann ich einen selbstgehosteten Agent für die Verwendung dieser Aufgabe konfigurieren?

Sie können diese Aufgabe entweder mit einer vollständigen Anaconda-Installation oder einer Miniconda-Installation verwenden. Wenn Sie einen selbstgehosteten Agent verwenden, müssen Sie die conda ausführbare Datei hinzufügen.PATH Alternativ können Sie die Umgebungsvariable CONDA auf den Stamm der Conda-Installation festlegen, d. h. das Verzeichnis, das Sie bei der Installation von Conda als "Präfix" angeben.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Setzbare Variablen Any
Agent-Version Alle unterstützten Agent-Versionen.
Aufgabenkategorie Paket