CondaEnvironment@1 - Attività Ambiente Conda v1

Usare questa attività per creare e attivare un ambiente Conda.

Importante

Questa attività è deprecata e verrà ritirata il 31 gennaio 2024. Usare comandi conda direttamente nell'attività bash o attività script batch alternativamente.

Sintassi

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

Ingressi dati

createCustomEnvironment - Creare un ambiente personalizzato
boolean. Valore predefinito: false

Se il valore per questo valore booleano è impostato su true, l'attività crea o riattiva un ambiente Conda anziché usare l'ambiente base. L'impostazione del valore su true è consigliata per gli agenti self-hosted.

environmentName - Nome ambiente
string. Obbligatorio quando createCustomEnvironment == true.

Nome dell'ambiente Conda da creare e attivare o riattivare se esiste già.

packageSpecs - specifiche del pacchetto
string. Valore predefinito: python=3

Elenco delimitato da spazi di pacchetti da installare nell'ambiente.

updateConda - Aggiornamento alla versione più recente di Conda
boolean. Valore predefinito: true

Aggiorna Conda alla versione più recente. Questo vale per l'installazione di Conda presente in PATH o per il percorso specificato dalla variabile di ambiente CONDA.

installOptions - Altre opzioni per conda install
string. Opzionale. Usare quando createCustomEnvironment == false.

Elenco delimitato da spazi di argomenti aggiuntivi da passare al comando conda install.

createOptions - Altre opzioni per conda create
string. Opzionale. Usare quando createCustomEnvironment == true.

Elenco delimitato da spazi di opzioni aggiuntive da passare al comando conda create.

cleanEnvironment - Pulire l'ambiente
boolean. Opzionale. Usare quando createCustomEnvironment == true. Valore predefinito: false

Elimina l'ambiente e lo ricrea se esiste già. Se questo valore booleano non è selezionato, l'attività riattiva un ambiente esistente.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

Usare questa attività per creare e attivare un ambiente Conda.

Importante

Questa attività è stata deprecata. Usare comandi conda direttamente nell'attività bash o attività script batch alternativamente.

Questa attività creerà un ambiente Conda e lo attiverà per le attività di compilazione successive.

Se l'attività trova un ambiente esistente con lo stesso nome, l'attività lo riattiva semplicemente. Ciò è possibile sugli agenti self-hosted. Per ricreare l'ambiente e reinstallare uno dei relativi pacchetti, impostare l'opzione "Pulisci l'ambiente".

L'esecuzione con l'opzione "Aggiorna alla versione più recente di Conda" tenterà di aggiornare Conda prima di creare o attivare l'ambiente. Se si esegue un agente self-hosted e si ha configurato un'installazione di Conda per funzionare con l'attività, questo potrebbe comportare l'aggiornamento dell'installazione di Conda.

Nota

Gli agenti ospitati da Microsoft non avranno Conda nel PATH per impostazione predefinita. È necessario eseguire questa attività per usare Conda.

Dopo aver eseguito questa attività, PATH conterrà la directory binaria per l'ambiente attivato, seguita dalle directory binarie per l'installazione di Conda stessa. È possibile eseguire script come attività di compilazione successive che eseguono Python, Conda o le utilità della riga di comando da altri pacchetti installati. Ad esempio, è possibile eseguire test con pytest o caricare un pacchetto in Anaconda Cloud con il client Anaconda.

Suggerimento

Dopo aver eseguito questa attività, l'ambiente verrà "attivato" e i pacchetti installati chiamando conda install verranno installati in questo ambiente.

Prerequisiti

• Un agente ospitato da Microsoft o un agente self-hosted con Anaconda o Miniconda installato.
• Se si usa un agente self-hosted, è necessario aggiungere l'eseguibile conda a PATH o impostare la variabile di ambiente CONDA alla radice dell'installazione di Conda.

Come è possibile configurare un agente self-hosted per l'uso di questa attività?

È possibile usare questa attività con un'installazione completa di Anaconda o un'installazione miniconda. Se si usa un agente self-hosted, è necessario aggiungere l'eseguibile conda a PATH. In alternativa, è possibile impostare la variabile di ambiente CONDA sulla radice dell'installazione di Conda, ovvero la directory specificata come "prefisso" durante l'installazione di Conda.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	Tutte le versioni dell'agente supportate.
Categoria attività	Pacchetto