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 tarefa de script em lote como alternativa.

Sintaxe

# 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 - Criar um ambiente personalizado
boolean. Valor padrão: false.

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

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

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

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

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

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

Atualiza o 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 ambiente CONDA.

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

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

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

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

Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

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

Importante

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

Essa tarefa criará um ambiente conda e o ativará para tarefas de build subsequentes.

Se a tarefa encontrar um ambiente existente com o mesmo nome, a tarefa simplesmente o reativará. Isso é possível em agentes auto-hospedados. Para recriar o ambiente e reinstalar qualquer 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 em seus 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 da própria instalação do Conda. Você pode executar scripts como tarefas de build subsequentes que executam Python, Conda ou os utilitários de linha de comando de outros pacotes instalados. Por exemplo, você pode executar testes com pytest ou carregar um pacote no Anaconda Cloud com o cliente Anaconda.

Dica

Depois de executar essa tarefa, o ambiente será "ativado" e os pacotes instalados 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ê deverá adicionar o executável conda para PATH ou definir a variável de ambiente CONDA como a 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ê deverá adicionar o executável conda ao PATH. Como alternativa, você pode definir a variável de ambiente CONDA para a raiz da instalação do Conda, ou seja, o diretório especificado como o "prefixo" ao instalar o Conda.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	Todas as versões de agente com suporte.
Categoria de tarefa	Pacote