CondaEnvironment@1 – Conda-Umgebung v1-Aufgabe

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

Wichtig

Dieser Vorgang ist veraltet und wird am 31. Januar 2024 eingestellt. Verwenden Sie Conda-Befehle direkt in der Bash-Aufgabe oder Batchskriptaufgabe als Alternative.

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.

Eingänge

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

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

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

Der Name der Conda-Umgebung, die erstellt und aktiviert werden soll, oder reaktivieren, 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 - update to the latest Conda
boolean. Standardwert: true.

Aktualisiert Conda auf die neueste Version. Dies gilt für die Conda-Installation in PATH oder auf den pfad, der durch die CONDA Umgebungsvariable angegeben wird.

installOptions - Weitere Optionen für conda install
string. Wahlfrei. Wird verwendet, wenn createCustomEnvironment == false.

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

createOptions - Weitere Optionen für conda create
string. Wahlfrei. Wird verwendet, 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. Wahlfrei. Wird verwendet, 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 die Aufgabe eine vorhandene Umgebung reaktivieren.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

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

Wichtig

Diese Aufgabe ist veraltet. Verwenden Sie Conda-Befehle direkt in der Bash-Aufgabe oder Batchskriptaufgabe als Alternative.

Diese Aufgabe erstellt eine Conda-Umgebung und aktiviert sie für nachfolgende Buildaufgaben.

Wenn der Vorgang eine vorhandene Umgebung mit demselben Namen findet, wird die Aufgabe einfach reaktiviert. Dies ist für selbst gehostete Agents möglich. Um die Umgebung neu zu erstellen und eines seiner Pakete neu zu installieren, legen Sie die Option "Umgebung bereinigen" fest.

Wenn Sie mit der Option "Update to the latest Conda" ausgeführt werden, wird versucht, Conda vor dem Erstellen oder Aktivieren der Umgebung zu aktualisieren. Wenn Sie einen selbst gehosteten Agent ausführen und eine Conda-Installation für die Arbeit mit der Aufgabekonfiguriert haben, kann dies dazu führen, dass Ihre Conda-Installation aktualisiert wird.

Hinweis

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

Nach dem Ausführen dieser Aufgabe enthält PATH 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 Buildaufgaben ausführen, die Python, Conda oder die Befehlszeilenprogramme aus anderen Paketen ausführen, die Sie installieren. Sie können z. B. Tests mit pytest ausführen oder ein Paket mit dem Anaconda-Clientin die Anaconda-Cloud hochladen.

Tipp

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

Voraussetzungen

• Ein von Microsoft gehosteter Agent oder ein selbst gehosteter Agent, auf dem Anaconda oder Miniconda installiert ist.
• Wenn Sie einen selbst gehosteten Agent verwenden, müssen Sie entweder die conda ausführbare Datei zum PATH hinzufügen oder die CONDA Umgebungsvariable auf den Stamm der Conda-Installation festlegen.

Wie kann ich einen selbst gehosteten 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 selbst gehosteten Agent verwenden, müssen Sie die conda ausführbare Datei PATHhinzufügen. Alternativ können Sie die CONDA Umgebungsvariable auf den Stamm der Conda-Installation festlegen, d. h. das Verzeichnis, das Sie beim Installieren von Conda als "Präfix" angeben.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	Alle unterstützten Agentversionen.
Vorgangskategorie	Paket