CondaEnvironment@1 - Conda-omgeving v1-taak

Gebruik deze taak om een Conda-omgeving te maken en te activeren.

Belangrijk

Deze taak is afgeschaft en wordt op 31 januari 2024 buiten gebruik gesteld. Gebruik conda-opdrachten rechtstreeks in de bash-taak of batchscripttaak als alternatief.

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.

Invoerwaarden

createCustomEnvironment - Een aangepaste omgeving maken
boolean. Standaardwaarde: false.

Als de waarde voor deze booleaanse waarde is ingesteld op true, wordt met de taak een Conda-omgeving gemaakt of opnieuw geactiveerd in plaats van de base omgeving te gebruiken. Het instellen van de waarde true op wordt aanbevolen voor zelf-hostende agents.

environmentName - Omgevingsnaam
string. Vereist wanneer createCustomEnvironment == true.

De naam van de Conda-omgeving die moet worden gemaakt en geactiveerd, of opnieuw activeren als deze al bestaat.

packageSpecs - Pakketspecificaties
string. Standaardwaarde: python=3.

De door spaties gescheiden lijst met pakketten die in de omgeving moeten worden geïnstalleerd.

updateConda - Bijwerken naar de meest recente Conda
boolean. Standaardwaarde: true.

Updates Conda naar de nieuwste versie. Dit is van toepassing op de Conda-installatie in PATH of op het pad dat is opgegeven door de omgevingsvariabele CONDA .

installOptions - Andere opties voor conda install
string. Optioneel. Gebruik wanneer createCustomEnvironment == false.

De door spaties gescheiden lijst met extra argumenten die moeten worden doorgegeven aan de conda install opdracht.

createOptions - Andere opties voor conda create
string. Optioneel. Gebruik wanneer createCustomEnvironment == true.

De door spaties gescheiden lijst met extra opties die moeten worden doorgegeven aan de conda create opdracht.

cleanEnvironment - De omgeving opschonen
boolean. Optioneel. Gebruik wanneer createCustomEnvironment == true. Standaardwaarde: false.

Hiermee verwijdert u de omgeving en maakt u deze opnieuw als deze al bestaat. Als deze booleaanse waarde niet is geselecteerd, wordt met de taak een bestaande omgeving opnieuw geactiveerd.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Conda-omgeving te maken en te activeren.

Belangrijk

Deze taak is afgeschaft. Gebruik conda-opdrachten rechtstreeks in de bash-taak of batchscripttaak als alternatief.

Deze taak maakt een Conda-omgeving en activeert deze voor volgende buildtaken.

Als de taak een bestaande omgeving met dezelfde naam vindt, wordt de taak gewoon opnieuw geactiveerd. Dit is mogelijk op zelf-hostende agents. Als u de omgeving opnieuw wilt maken en een van de pakketten opnieuw wilt installeren, stelt u de optie De omgeving opschonen in.

Als u de optie 'Bijwerken naar de meest recente Conda' uitvoert, probeert u Conda bij te werken voordat u de omgeving maakt of activeert. Als u een zelf-hostende agent uitvoert en een Conda-installatie hebt geconfigureerd om met de taak te werken, kan dit ertoe leiden dat uw Conda-installatie wordt bijgewerkt.

Notitie

Door Microsoft gehoste agents hebben conda standaard niet in hun PATH . U moet deze taak uitvoeren om Conda te kunnen gebruiken.

Na het uitvoeren van deze taak bevat PATH de binaire map voor de geactiveerde omgeving, gevolgd door de binaire mappen voor de Conda-installatie zelf. U kunt scripts uitvoeren als volgende buildtaken die Python, Conda of de opdrachtregelprogramma's uitvoeren vanuit andere pakketten die u installeert. U kunt bijvoorbeeld tests uitvoeren met pytest of een pakket uploaden naar Anaconda Cloud met de Anaconda-client.

Tip

Na het uitvoeren van deze taak wordt de omgeving 'geactiveerd' en worden pakketten die u installeert door aan te roepen conda install in deze omgeving geïnstalleerd.

Vereisten

• Een door Microsoft gehoste agent of een zelf-hostende agent waarop Anaconda of Miniconda is geïnstalleerd.
• Als u een zelf-hostende agent gebruikt, moet u het conda uitvoerbare bestand toevoegen aan PATH of de CONDA omgevingsvariabele instellen op de hoofdmap van de Conda-installatie.

Hoe kan ik een zelf-hostende agent configureren om deze taak te gebruiken?

U kunt deze taak gebruiken met een volledige Anaconda-installatie of een Miniconda-installatie. Als u een zelf-hostende agent gebruikt, moet u het conda uitvoerbare bestand toevoegen aan PATH. U kunt ook de CONDA omgevingsvariabele instellen op de hoofdmap van de Conda-installatie, dat wil gezegd, de map die u opgeeft als het 'voorvoegsel' bij het installeren van Conda.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Pakket