Compartilhar via


CondaEnvironment@1 – Tarefa conda environment v1

Use essa tarefa para criar e ativar um ambiente do Conda.

Importante

Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use comandos conda diretamente na tarefa bash ou na tarefa de script em lotes como alternativa.

Use essa tarefa para criar e ativar um ambiente do Conda.

Importante

Esta tarefa foi preterida. Use comandos conda diretamente na tarefa bash ou na tarefa de script em lotes 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 padrão: false.

Se o valor desse booliano for definido truecomo , a tarefa criará ou reativará um ambiente Conda em vez de usar o base ambiente. A configuração do valor true como é recomendada para agentes auto-hospedados.


environmentName - Nome do ambiente
string. Obrigatório quando createCustomEnvironment == true.

O nome do ambiente conda a ser criado e ativado ou reativado se ele já existir.


packageSpecs - Especificações de pacote
string. Valor padrão: python=3.

A lista delimitada por espaço de pacotes a serem instalados no ambiente.


updateConda - Atualizar para o Conda mais recente
boolean. Valor padrão: true.

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


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

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


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

A lista delimitada por espaço de opções adicionais a serem passadas para o conda create comando.


cleanEnvironment - Limpar o ambiente
boolean. Opcional. Use quando createCustomEnvironment == true. Valor padrão: false.

Exclui o ambiente e o recria se ele já existir. Se esse booliano não estiver selecionado, a tarefa reativará um ambiente existente.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Use essa tarefa para criar e ativar um ambiente do Conda.

Importante

Esta tarefa foi preterida. Use comandos conda diretamente na tarefa bash ou na tarefa de script em lotes como alternativa.

A tarefa criará um ambiente do Conda e o ativará nas tarefas de build subsequentes.

Se a tarefa encontrar um ambiente existente com o mesmo nome, ela simplesmente o reativará. Isso é possível em agentes auto-hospedados. Para recriar o ambiente e reinstalar um de seus pacotes, defina a opção "Limpar o ambiente".

A execução com a opção "Atualizar para o Conda mais recente" tentará atualizar o Conda antes de criar ou ativar o ambiente. Se você estiver executando um agente auto-hospedado e tiver configurado uma instalação do Conda para trabalhar com a tarefa, isso poderá resultar na atualização da instalação do Conda.

Observação

Os agentes hospedados pela Microsoft não terão o Conda no seu PATH por padrão. Você precisará executar essa tarefa para usar o Conda.

Depois de executar essa tarefa, PATH conterá o diretório binário para o ambiente ativado, seguido pelos diretórios binários para a própria instalação do Conda. Você pode executar scripts como tarefas de build subsequentes que executam Python, Conda ou utilitários de linha de comando de outros pacotes instalados. Por exemplo, você pode executar testes com pytest ou carregar um pacote na Nuvem do Anaconda com o cliente Anaconda.

Dica

Depois de executar essa tarefa, o ambiente será "ativado", e os pacotes que você instalar chamando conda install serão instalados nesse ambiente.

Pré-requisitos

  • Um agente hospedado pela Microsoft ou um agente auto-hospedado com o Anaconda ou o Miniconda instalado.
  • Se estiver usando um agente auto-hospedado, você precisará adicionar o conda executável ao PATH ou definir a variável de ambiente CONDA à raiz da instalação do Conda.

Como posso configurar um agente auto-hospedado para usar essa tarefa?

Você pode usar essa tarefa com uma instalação completa do Anaconda ou uma instalação do Miniconda. Se estiver usando um agente auto-hospedado, você precisará adicionar o executável conda ao PATH. Como alternativa, você pode definir a variável de ambiente CONDA como a raiz da instalação do Conda, ou seja, o diretório especificado como o "prefixo" na instalação do Conda.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões do agente com suporte.
Categoria da tarefa Pacote