CondaEnvironment@1 - Tarefa v1 do ambiente Conda

  • Artigo

Utilize esta tarefa para criar e ativar um ambiente Conda.

Importante

Esta tarefa foi preterida e será descontinuada a 31 de janeiro de 2024. Utilize comandos conda diretamente na tarefa bash ou na tarefa de script de lote como alternativa.

Utilize esta tarefa para criar e ativar um ambiente Conda.

Importante

Esta tarefa foi preterida. Utilize comandos conda diretamente na tarefa bash ou na tarefa de script de lote como alternativa.

Criar e ativar um ambiente Conda.

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.

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

Entradas

createCustomEnvironment - Criar um ambiente personalizado
boolean. Valor predefinido: false.

Se o valor deste booleano estiver definido como true, a tarefa cria ou reativa um ambiente Conda em vez de utilizar o base ambiente. A definição do valor como true é recomendada para agentes autoalojados.


environmentName - Nome do ambiente
string. Necessário quando createCustomEnvironment == true.

O nome do ambiente Conda para criar e ativar ou reativar se já existir.


packageSpecs - Especificações do pacote
string. Valor predefinido: python=3.

A lista de pacotes delimitados pelo espaço a instalar no ambiente.


updateConda - Atualizar para a Conda mais recente
boolean. Valor predefinido: true.

Atualizações Conda para a versão mais recente. Isto aplica-se à instalação conda encontrada em PATH ou ao caminho especificado pela variável de CONDA ambiente.


installOptions - Outras opções para conda install
string. Opcional. Utilize quando createCustomEnvironment == false.

A lista delimitada por espaço de argumentos adicionais a transmitir para o conda install comando .


createOptions - Outras opções para conda create
string. Opcional. Utilize quando createCustomEnvironment == true.

A lista delimitada por espaço de opções adicionais para transmitir ao conda create comando.


cleanEnvironment - Limpar o ambiente
boolean. Opcional. Utilize quando createCustomEnvironment == true. Valor predefinido: false.

Elimina o ambiente e recria-o se já existir. Se este booleano não estiver selecionado, a tarefa reativará um ambiente existente.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para criar e ativar um ambiente Conda.

Importante

Esta tarefa foi preterida. Utilize comandos conda diretamente na tarefa bash ou na tarefa de script de lote como alternativa.

Esta tarefa irá criar um ambiente Conda e ativá-lo para tarefas de compilação subsequentes.

Se a tarefa encontrar um ambiente existente com o mesmo nome, a tarefa irá simplesmente reativá-lo. Isto é possível em agentes autoalojados. Para recriar o ambiente e reinstalar qualquer um dos pacotes, defina a opção "Limpar o ambiente".

A execução com a opção "Atualizar para a Conda mais recente" tentará atualizar o Conda antes de criar ou ativar o ambiente. Se estiver a executar um agente autoalojado e tiver configurado uma instalação conda para funcionar com a tarefa, tal poderá resultar na atualização da instalação do Conda.

Nota

Por predefinição, os agentes alojados na Microsoft não terão o Conda.PATH Terá de executar esta tarefa para utilizar o Conda.

Depois de executar esta tarefa, PATH irá conter o diretório binário do ambiente ativado, seguido dos diretórios binários da própria instalação do Conda. Pode executar scripts como tarefas de compilação subsequentes que executam Python, Conda ou os utilitários da linha de comandos a partir de outros pacotes que instalar. Por exemplo, pode executar testes com pytest ou carregar um pacote para a Cloud do Anaconda com o cliente Anaconda.

Dica

Depois de executar esta tarefa, o ambiente será "ativado" e os pacotes que instalar ao chamar conda install serão instalados neste ambiente.

Pré-requisitos

  • Um agente alojado pela Microsoft ou um agente autoalojado com o Anaconda ou o Miniconda instalado.
  • Se estiver a utilizar um agente autoalojado, tem de adicionar o conda executável ou PATH definir a variável de CONDA ambiente para a raiz da instalação do Conda.

Como posso configurar um agente autoalojado para utilizar esta tarefa?

Pode utilizar esta tarefa com uma instalação completa do Anaconda ou uma instalação Miniconda. Se estiver a utilizar um agente autoalojado, tem de adicionar o conda executável a PATH. Em alternativa, pode definir a CONDA variável de ambiente para a raiz da instalação do Conda, ou seja, o diretório que especificar como o "prefixo" ao instalar o Conda.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria da tarefa Pacote