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 bash o la tarea de script por lotes como alternativa.

Syntax

# 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 - Creación de un entorno personalizado
boolean. Valor predeterminado: false.

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

environmentName - Nombre del entorno
string. Necesario cuando createCustomEnvironment == true.

Nombre del entorno de Conda que se va a crear y activar, o reactivar si ya existe.

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

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

updateConda - Actualización a la versión más reciente de Conda
boolean. Valor predeterminado: true.

Novedades 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 CONDA entorno.

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 conda install comando.

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

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

cleanEnvironment - Limpieza del 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 las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

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

Importante

Esta tarea está en desuso. Use comandos de Conda directamente en la tarea bash o la 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 reinstalar cualquiera de sus paquetes, establezca la opción "Limpiar el entorno".

Al ejecutarse con la opción "Actualizar a la versión más reciente de Conda", se intentará actualizar Conda antes de crear o activar el entorno. Si está ejecutando 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 su PATH forma predeterminada. Tendrá que ejecutar esta tarea para usar Conda.

Después de ejecutar esta tarea, PATH contendrá el directorio binario para el entorno activado, seguido de los directorios binarios para la propia 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 el cliente de Anaconda.

Sugerencia

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

Requisitos previos

• 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 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
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	Todas las versiones de agente compatibles.
Categoría de la tarea:	Paquete