Partage via


CondaEnvironment@1 - Tâche Conda environment v1

Utilisez cette tâche pour créer et activer un environnement Conda.

Important

Cette tâche est déconseillée et sera retirée le 31 janvier 2024. Utilisez des commandes conda directement dans la tâche bash ou la tâche de script batch comme alternative.

Utilisez cette tâche pour créer et activer un environnement Conda.

Important

Cette tâche a été dépréciée. Utilisez des commandes conda directement dans la tâche bash ou la tâche de script batch comme alternative.

Créez et activez un environnement 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.
# 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.

Entrées

createCustomEnvironment - Créer un environnement personnalisé
boolean. Valeur par défaut : false.

Si la valeur de ce booléen est définie sur true, la tâche crée ou réactive un environnement Conda au lieu d’utiliser l’environnement base . Il est recommandé de définir la valeur sur true pour les agents auto-hébergés.


environmentName - Nom de l’environnement
string. Nécessaire lorsque createCustomEnvironment == true.

Nom de l’environnement Conda à créer et à activer, ou à réactiver s’il existe déjà.


packageSpecs - Spécifications de package
string. Valeur par défaut : python=3.

Liste délimitée par l’espace des packages à installer dans l’environnement.


updateConda - Mettre à jour vers la dernière version de Conda
boolean. Valeur par défaut : true.

Mises à jour Conda à la dernière version. Cela s’applique à l’installation Conda trouvée dans PATH ou au chemin spécifié par la variable d’environnement CONDA .


installOptions - Autres options pour conda install
string. facultatif. Utilisez quand createCustomEnvironment == false.

Liste délimitée en espace des arguments supplémentaires à passer à la conda install commande.


createOptions - Autres options pour conda create
string. facultatif. Utilisez quand createCustomEnvironment == true.

Liste délimitée par un espace des options supplémentaires à passer à la conda create commande.


cleanEnvironment - Nettoyer l’environnement
boolean. facultatif. Utilisez quand createCustomEnvironment == true. Valeur par défaut : false.

Supprime l’environnement et le recrée s’il existe déjà. Si cette valeur booléenne n’est pas sélectionnée, la tâche réactivera un environnement existant.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche pour créer et activer un environnement Conda.

Important

Cette tâche a été dépréciée. Utilisez des commandes conda directement dans la tâche bash ou la tâche de script batch comme alternative.

Cette tâche crée un environnement Conda et l’active pour les tâches de génération suivantes.

Si la tâche trouve un environnement existant portant le même nom, elle la réactivera simplement. Cela est possible sur les agents auto-hébergés. Pour recréer l’environnement et réinstaller l’un de ses packages, définissez l’option « Nettoyer l’environnement ».

L’exécution avec l’option « Mettre à jour vers la dernière version de Conda » tente de mettre à jour Conda avant de créer ou d’activer l’environnement. Si vous exécutez un agent auto-hébergé et que vous avez configuré une installation Conda pour fonctionner avec la tâche, cela peut entraîner la mise à jour de votre installation de Conda.

Notes

Par défaut, les agents hébergés par Microsoft n’auront pas Conda dans leur PATH . Vous devrez exécuter cette tâche pour utiliser Conda.

Après avoir exécuté cette tâche, PATH contient le répertoire binaire de l’environnement activé, suivi des répertoires binaires pour l’installation de Conda elle-même. Vous pouvez exécuter des scripts en tant que tâches de génération suivantes qui exécutent Python, Conda ou les utilitaires de ligne de commande à partir d’autres packages que vous installez. Par exemple, vous pouvez exécuter des tests avec pytest ou charger un package dans Anaconda Cloud avec le client Anaconda.

Conseil

Après avoir exécuté cette tâche, l’environnement est « activé » et les packages que vous installez en appelant conda install sont installés dans cet environnement.

Prérequis

  • Un agent hébergé par Microsoft ou un agent auto-hébergé avec Anaconda ou Miniconda installé.
  • Si vous utilisez un agent auto-hébergé, vous devez ajouter l’exécutable conda à PATH ou définir la CONDA variable d’environnement à la racine de l’installation de Conda.

Comment configurer un agent auto-hébergé pour utiliser cette tâche ?

Vous pouvez utiliser cette tâche avec une installation complète d’Anaconda ou une installation Miniconda. Si vous utilisez un agent auto-hébergé, vous devez ajouter l’exécutable conda à PATH. Vous pouvez également définir la CONDA variable d’environnement sur la racine de l’installation de Conda, c’est-à-dire le répertoire que vous spécifiez comme « préfixe » lors de l’installation de Conda.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent Toutes les versions d’agent prises en charge.
Catégorie de la tâche Paquet