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 i comandi conda direttamente nell'attività bash o nell'attività script batch come alternativa.

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

Importante

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

Creare e attivare un ambiente Conda.

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

Input

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

Se il valore per questo 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 dallo spazio dei pacchetti da installare nell'ambiente.


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

Aggiornamenti Conda alla versione più recente. Ciò si applica all'installazione di Conda trovata in PATH o al percorso specificato dalla CONDA variabile di ambiente.


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

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


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

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


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

Elimina l'ambiente e lo ricrea se esiste già. Se questo 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 i comandi conda direttamente nell'attività bash o nell'attività script batch come alternativa.

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à verrà semplicemente riattivata. Ciò è possibile sugli agenti self-hosted. Per ricreare l'ambiente e reinstallare uno dei relativi pacchetti, impostare l'opzione "Pulire l'ambiente".

L'esecuzione con l'opzione "Update to the latest Conda" tenterà di aggiornare Conda prima di creare o attivare l'ambiente. Se si esegue un agente self-hosted e si è configurato un'installazione di Conda per lavorare con l'attività, ciò potrebbe causare l'aggiornamento dell'installazione di Conda.

Nota

Gli agenti ospitati da Microsoft non avranno Conda per PATH 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 stessa di Conda. È 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 il conda file eseguibile a PATH o impostare la CONDA variabile di ambiente sulla radice dell'installazione di Conda.

Come è possibile configurare un agente self-hosted per usare 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 il conda file eseguibile a PATH. In alternativa, è possibile impostare la CONDA variabile di ambiente 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
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Pacchetto