CondaEnvironment@0 - Tarefa v0 do ambiente Conda

Artigo
07/02/2024

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.

Syntax

# Conda environment v0
# Create and activate a Conda environment.
- task: CondaEnvironment@0
  inputs:
    environmentName: # string. Required. Environment name. 
    #packageSpecs: 'python=3' # string. Package specs. Default: python=3.
    #updateConda: true # boolean. Update to the latest Conda. Default: true.
  # Advanced
    #createOptions: # string. Environment creation options. 
    #cleanEnvironment: false # boolean. Clean the environment. Default: false.

# Conda Environment v0
# Create and activate a Conda environment.
- task: CondaEnvironment@0
  inputs:
    environmentName: # string. Required. Environment name. 
    #packageSpecs: 'python=3' # string. Package specs. Default: python=3.
    #updateConda: true # boolean. Update to the latest Conda. Default: true.
  # Advanced
    #createOptions: # string. Environment creation options. 
    #cleanEnvironment: false # boolean. Clean the environment. Default: false.

Entradas

environmentName - Nome do ambiente
string. Obrigatório.

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.

createOptions - Opções de criação de ambiente
string.

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

cleanEnvironment - Limpar o ambiente
boolean. 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

Partilhar via