CondaEnvironment@1 — zadanie środowiska Conda w wersji 1

To zadanie służy do tworzenia i aktywowania środowiska Conda.

Ważne

To zadanie jest przestarzałe i zostanie wycofane 31 stycznia 2024 r. Użyj poleceń conda bezpośrednio w zadania powłoki bash lub zadania skryptu wsadowego jako alternatywy.

Składnia

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

Dane wejściowe

createCustomEnvironment - Tworzenie środowiska niestandardowego
boolean. Wartość domyślna: false.

Jeśli wartość dla tej wartości logicznej jest ustawiona na true, zadanie tworzy lub reactivates środowiska Conda zamiast używać środowiska base. Ustawienie wartości na true jest zalecane dla własnych agentów.

environmentName - Nazwa środowiska
string. Wymagane, gdy createCustomEnvironment == true.

Nazwa środowiska Conda do utworzenia i aktywowania lub ponownego aktywowania, jeśli już istnieje.

packageSpecs - specyfikacja pakietu
string. Wartość domyślna: python=3.

Rozdzielana spacjami lista pakietów do zainstalowania w środowisku.

updateConda - aktualizacji do najnowszej Conda
boolean. Wartość domyślna: true.

Aktualizuje conda do najnowszej wersji. Dotyczy to instalacji Conda znalezionej w PATH lub ścieżki określonej przez zmienną środowiskową CONDA.

installOptions - Inne opcje conda install
string. Opcjonalny. Użyj polecenia , gdy createCustomEnvironment == false.

Rozdzielana spacjami lista dodatkowych argumentów do przekazania do polecenia conda install.

createOptions - Inne opcje conda create
string. Opcjonalny. Użyj polecenia , gdy createCustomEnvironment == true.

Rozdzielana spacjami lista dodatkowych opcji do przekazania do polecenia conda create.

cleanEnvironment - Czyszczenie środowiska
boolean. Opcjonalny. Użyj polecenia , gdy createCustomEnvironment == true. Wartość domyślna: false.

Usuwa środowisko i tworzy je ponownie, jeśli już istnieje. Jeśli ta wartość logiczna nie zostanie wybrana, zadanie ponownie uaktywni istniejące środowisko.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

To zadanie służy do tworzenia i aktywowania środowiska Conda.

Ważne

To zadanie zostało przestarzałe. Użyj poleceń conda bezpośrednio w zadania powłoki bash lub zadania skryptu wsadowego jako alternatywy.

To zadanie spowoduje utworzenie środowiska Conda i aktywowanie go do kolejnych zadań kompilacji.

Jeśli zadanie znajdzie istniejące środowisko o tej samej nazwie, zadanie po prostu ponownie go uaktywni. Jest to możliwe w przypadku własnych agentów. Aby ponownie utworzyć środowisko i ponownie zainstalować dowolne z jego pakietów, ustaw opcję "Wyczyść środowisko".

Uruchomienie polecenia z opcją "Aktualizuj do najnowszej wersji conda" spróbuje zaktualizować conda przed utworzeniem lub aktywowaniem środowiska. Jeśli korzystasz z własnego agenta i skonfigurowano instalację conda do pracy z zadaniem, może to spowodować zaktualizowanie instalacji Conda.

Uwaga

Agenci hostowani przez firmę Microsoft nie będą domyślnie mieli conda w PATH. Aby użyć narzędzia Conda, należy uruchomić to zadanie.

Po uruchomieniu tego zadania PATH będzie zawierać katalog binarny dla aktywowanego środowiska, a następnie katalogi binarne dla samej instalacji Conda. Skrypty można uruchamiać jako kolejne zadania kompilacji, które uruchamiają język Python, Conda lub narzędzia wiersza polecenia z innych instalowanych pakietów. Na przykład można uruchamiać testy przy użyciu pytest lub przekazać pakiet do usługi Anaconda Cloud przy użyciu klienta Anaconda.

Wskazówka

Po uruchomieniu tego zadania środowisko zostanie "aktywowane", a pakiety instalowane przez wywołanie conda install zostaną zainstalowane w tym środowisku.

Wymagania wstępne

• Agent hostowany przez firmę Microsoft lub własny agent z zainstalowaną platformą Anaconda lub Miniconda.
• Jeśli używasz własnego agenta, musisz dodać plik wykonywalny conda do PATH lub ustawić zmienną środowiskową CONDA na katalog główny instalacji Conda.

Jak skonfigurować własnego agenta do korzystania z tego zadania?

Tego zadania można użyć z pełną instalacją narzędzia Anaconda lub instalacją Miniconda. W przypadku korzystania z własnego agenta należy dodać plik wykonywalny conda, aby PATH. Alternatywnie można ustawić zmienną środowiskową CONDA na katalog główny instalacji Conda — czyli katalog określony jako "prefiks" podczas instalowania aplikacji Conda.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadań	Pakiet