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 mise hors service le 31 janvier 2024. Utilisez commandes conda directement dans le de tâche bash ou tâche de script par lots comme alternative.

Syntaxe

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

Entrées

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

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

nom de l’environnement environmentName -
string. Obligatoire 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 - Mise à jour vers la dernière Conda
boolean. Valeur par défaut : true.

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

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

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

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

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

cleanEnvironment - Nettoyer l’environnement
boolean. Optionnel. 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é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.

Remarques

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

Important

Cette tâche a été déconseillée. Utilisez commandes conda directement dans le de tâche bash ou 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, la tâche 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 configuré une installation de Conda pour fonctionner avec la tâche, cela peut entraîner la mise à jour de votre installation de Conda.

Remarque

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

Après avoir exécuté cette tâche, PATH contiendra le répertoire binaire de l’environnement activé, suivi des répertoires binaires de l’installation 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 / Astuce

Une fois cette tâche exécutée, l’environnement est « activé », et les packages que vous installez en appelant conda install seront installés dans cet environnement.

Conditions préalables

• 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 variable d’environnement CONDA à 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 variable d’environnement CONDA à 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.

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent, DeploymentGroup
demandes	Aucun
fonctionnalités de	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	N'importe quel
variables settables	N'importe quel
Version de l’agent	Toutes les versions de l’agent prises en charge.
Catégorie de tâche	Paquet