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 zadaniu powłoki bash lub zadaniu 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ść tego wartości logicznej jest ustawiona na true, zadanie tworzy lub reactivates środowiska Conda zamiast używać base środowiska. Ustawienie wartości true na wartość 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 - Specyfikacje pakietu
string. Wartość domyślna: python=3.

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

updateConda - Aktualizacja do najnowszej wersji aplikacji Conda
boolean. Wartość domyślna: true.

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

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

Rozdzielana spacjami lista dodatkowych argumentów, które mają być przekazywane do conda install polecenia.

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

Rozdzielana spacjami lista dodatkowych opcji, które mają być przekazywane do conda create polecenia.

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 zadania

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

Zmienne wyjściowe

Brak.

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 zadaniu powłoki bash lub zadaniu skryptu wsadowego jako alternatywy.

To zadanie spowoduje utworzenie środowiska Conda i aktywowanie go na potrzeby 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 jego pakiety, ustaw opcję "Wyczyść środowisko".

Uruchomienie przy użyciu opcji "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 PATH firmę Microsoft domyślnie nie będą mieli conda. Aby można było używać 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 za pomocą narzędzia pytest lub przekazać pakiet do chmury Anaconda przy użyciu klienta anaconda.

Porada

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 zainstalowanym programem Anaconda lub Miniconda.
• Jeśli używasz własnego agenta, musisz dodać conda plik wykonywalny do PATH katalogu głównego instalacji conda lub ustawić CONDA zmienną środowiskową.

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

Tego zadania można użyć z pełną instalacją programu Anaconda lub instalacją Miniconda. Jeśli używasz własnego agenta conda , musisz dodać plik wykonywalny do PATHelementu . Alternatywnie można ustawić zmienną CONDA środowiskową na katalog główny instalacji Conda — czyli katalog określony jako "prefiks" podczas instalowania aplikacji Conda.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadania	Pakiet