CondaEnvironment@1: tarea del entorno de Conda v1

Use esta tarea para crear y activar un entorno de Conda.

Importante

Esta tarea está en desuso y se retirará el 31 de enero de 2024. Use comandos de Conda directamente en la tarea de bash de o tarea de script por lotes como alternativa.

Sintaxis

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

Entradas

createCustomEnvironment - Crear un entorno personalizado
boolean. Valor predeterminado: false.

Si el valor de este valor booleano se establece en true, la tarea crea o reactiva un entorno de Conda en lugar de usar el entorno de base. Se recomienda establecer el valor en true para los agentes autohospedados.

nombre del entorno de environmentName -
string. Obligatorio cuando createCustomEnvironment == true.

Nombre del entorno de Conda para crear y activar o reactivar si ya existe.

de especificaciones del paquete de packageSpecs -
string. Valor predeterminado: python=3.

Lista delimitada por espacios de paquetes que se van a instalar en el entorno.

updateConda - Actualizar a la última de Conda
boolean. Valor predeterminado: true.

Actualiza Conda a la versión más reciente. Esto se aplica a la instalación de Conda que se encuentra en PATH o a la ruta de acceso especificada por la variable de entorno CONDA.

installOptions - Otras opciones para conda install
string. Opcional. Use cuando createCustomEnvironment == false.

Lista delimitada por espacios de argumentos adicionales que se van a pasar al comando conda install.

createOptions - Otras opciones para conda create
string. Opcional. Use cuando createCustomEnvironment == true.

Lista delimitada por espacio de opciones adicionales que se van a pasar al comando conda create.

cleanEnvironment - Limpiar el entorno
boolean. Opcional. Use cuando createCustomEnvironment == true. Valor predeterminado: false.

Elimina el entorno y lo vuelve a crear si ya existe. Si no se selecciona este valor booleano, la tarea reactivará un entorno existente.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para crear y activar un entorno de Conda.

Importante

Esta tarea ha quedado en desuso. Use comandos de Conda directamente en la tarea de bash de o tarea de script por lotes como alternativa.

Esta tarea creará un entorno de Conda y lo activará para las tareas de compilación posteriores.

Si la tarea encuentra un entorno existente con el mismo nombre, la tarea simplemente la reactivará. Esto es posible en agentes autohospedados. Para volver a crear el entorno y volver a instalar cualquiera de sus paquetes, establezca la opción "Limpiar el entorno".

Al ejecutar con la opción "Actualizar a la última conda" se intentará actualizar Conda antes de crear o activar el entorno. Si ejecuta un agente autohospedado y ha configurado una instalación de Conda para que funcione con la tarea, esto puede dar lugar a que la instalación de Conda se actualice.

Nota:

Los agentes hospedados por Microsoft no tendrán Conda en sus PATH de forma predeterminada. Tendrá que ejecutar esta tarea para poder usar Conda.

Después de ejecutar esta tarea, PATH contendrá el directorio binario del entorno activado, seguido de los directorios binarios para la instalación de Conda. Puede ejecutar scripts como tareas de compilación posteriores que ejecuten Python, Conda o las utilidades de la línea de comandos desde otros paquetes que instale. Por ejemplo, puede ejecutar pruebas con pytest o cargar un paquete en Anaconda Cloud con la cliente de Anaconda.

Sugerencia

Después de ejecutar esta tarea, el entorno se "activará" y los paquetes que instale llamando a conda install se instalarán en este entorno.

Prerrequisitos

• Un agente hospedado por Microsoft o un agente autohospedado con Anaconda o Miniconda instalado.
• Si usa un agente autohospedado, debe agregar el archivo ejecutable conda a PATH o establecer la variable de entorno CONDA en la raíz de la instalación de Conda.

¿Cómo puedo configurar un agente autohospedado para usar esta tarea?

Puede usar esta tarea con una instalación completa de Anaconda o una instalación de Miniconda. Si usa un agente autohospedado, debe agregar el archivo ejecutable de conda a PATH. Como alternativa, puede establecer la variable de entorno CONDA en la raíz de la instalación de Conda; es decir, el directorio que especifique como el "prefijo" al instalar Conda.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	Todas las versiones de agente admitidas.
Categoría de tarea	Paquete