Partager via

CondaEnvironment@0 - Tâche Conda environment v0

  • Article

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

Important

Cette tâche a été déconseillée. Utilisez des commandes conda directement dans la tâche bash ou la tâche de script par lots comme alternative.

Syntax

# 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.

# 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.

Entrées

environmentName - Nom de l’environnement
string. Obligatoire.

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


packageSpecs - Spécifications du 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 vers 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 .


createOptions - Options de création d’environnement
string.

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


cleanEnvironment - Nettoyer l’environnement
boolean. 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éactive 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éconseillée. Utilisez des commandes conda directement dans la tâche bash ou la tâche de script par lots 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 De Conda pour qu’elle fonctionne avec la tâche, cela peut entraîner la mise à jour de votre installation de Conda.

Notes

Les agents hébergés par Microsoft n’ont pas Conda dans leur PATH par défaut. Vous devez exécuter cette tâche pour utiliser Conda.

Après l’exécution de 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 sur Anaconda Cloud avec le client Anaconda.

Conseil

Après avoir exécuté cette tâche, l’environnement sera « activé », et les packages que vous installez en appelant conda install seront 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 De 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 commande Quelconque
Variables paramétrables Quelconque
Version de l’agent Toutes les versions d’agent prises en charge.
Catégorie de la tâche Paquet