Typy zadań i użycie

W języku YAML należy określić wersję główną przy użyciu w @ nazwie zadania. Aby na przykład użyć wersji 2 PublishTestResults zadania, określ wartość PublishTestResults@2. Możesz określić, która wersja pomocnicza ma być używana, podając pełny numer wersji zadania po pliku @, na przykład GoTool@0.3.1.

W potokach klasycznych każde zadanie ma selektor Wersji , aby umożliwić wybranie żądanej wersji. Rozważ sklonowanie potoku i przetestowanie sklonowanego potoku przy użyciu nowych wersji głównych zadań. W przypadku wybrania wersji zapoznawczej, takiej jak 1.* Wersja zapoznawcza, wersja jest nadal opracowywana i może mieć problemy.

Jeśli zmienisz wersję i masz problemy z kompilacjami, możesz przywrócić zmianę potoku z karty Historia . W przypadku potoków wydania możliwość przywrócenia do starszej wersji nie jest dostępna. Należy ręcznie przywrócić zmiany w potoku wydania, a następnie zapisać potok.

Poniższe właściwości są dostępne dla kroków potoku task YAML. Aby uzyskać więcej informacji, zobacz definicję steps.task .

Warunki

Zadanie nie może określić, czy kontynuować zadanie potoku po zakończeniu zadania, tylko podać stan zakończenia, taki jak succeeded lub failed. Podrzędne zadania i zadania można następnie ustawić condition na podstawie tego stanu, aby określić, czy należy uruchomić.

Właściwość conditions określa warunki, w których to zadanie jest uruchamiane. Domyślnie krok jest uruchamiany, jeśli jeszcze nic nie powiodło się, a krok bezpośrednio poprzedzający jego ukończenie.

Możesz zastąpić lub dostosować te wartości domyślne, ustawiając krok do uruchomienia nawet wtedy, gdy poprzednia zależność zakończy się niepowodzeniem lub ma inny wynik. Można również zdefiniować warunki niestandardowe, które składają się z wyrażeń.

Warunki oparte na poprzednim stanie zależności obejmują:

• Powodzenie: uruchom polecenie tylko wtedy, gdy wszystkie poprzednie zależności powiedzie się. To zachowanie jest domyślne, jeśli w YAML nie ustawiono żadnego warunku. Aby zastosować ten warunek, określ wartość condition: succeeded().
• Powodzenie lub niepowodzenie: uruchom polecenie, nawet jeśli poprzednia zależność zakończy się niepowodzeniem, chyba że przebieg zostanie anulowany. Aby zastosować ten warunek, określ wartość condition: succeededOrFailed().
• Zawsze: uruchom polecenie, nawet jeśli poprzednia zależność zakończy się niepowodzeniem, nawet jeśli przebieg zostanie anulowany. Aby zastosować ten warunek, określ wartość condition: always().
• Niepowodzenie: uruchom polecenie tylko wtedy, gdy poprzednia zależność zakończy się niepowodzeniem. Aby zastosować ten warunek, określ wartość condition: failed().

W poniższym przykładzie YAML jest uruchamiany nawet wtedy, PublishTestResults@2 gdy poprzedni krok zakończył się niepowodzeniem ze względu na jego warunek succeededOrFailed .

steps:
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'
- task: PublishTestResults@2
  inputs:
    testResultsFiles: "**/TEST-*.xml"
  condition: succeededOrFailed()

Kontynuuj przy błędzie

Właściwość continueOnError informuje zadanie, czy kontynuować uruchamianie i zgłaszać powodzenie niezależnie od niepowodzeń. Jeśli ustawiono truewartość , ta właściwość informuje zadanie o zignorowaniu stanu i kontynuowaniu failed działania. Kroki podrzędne i zadania traktują wynik zadania, gdy success podejmują decyzje dotyczące uruchamiania.

Włączona

Domyślnie zadanie jest uruchamiane za każdym razem, gdy zadanie jest uruchamiane. Możesz ustawić wartość enabled , false aby wyłączyć zadanie. Tymczasowe wyłączenie zadania jest przydatne do usunięcia zadania z procesu na potrzeby testowania lub dla określonych wdrożeń.

Liczba ponownych prób w przypadku niepowodzenia zadania

Właściwość retryCountOnTaskFailure określa liczbę ponownych prób wykonania zadania w przypadku niepowodzenia. Wartość domyślna to zero ponownych prób.

• Maksymalna dozwolona liczba ponownych prób wynosi 10.
• Czas oczekiwania przed ponowieniem próby zwiększa się po każdej nieudanej próbie, zgodnie ze strategią wycofywania wykładniczego. Pierwsza ponowna próba następuje po 1 sekundzie, druga ponawianie po 4 sekundach, a dziesiąta ponowna próba po 100 sekundach.
• Ponawianie próby zadania nie zapewnia idempotentności. Skutki uboczne pierwszej próby, takie jak częściowe tworzenie zasobu zewnętrznego, mogą powodować ponawianie prób.
• Dla zadania nie są udostępniane żadne informacje o liczbie ponownych prób.
• Niepowodzenie zadania dodaje ostrzeżenie do dzienników zadań wskazujących, że nie powiodło się przed ponowieniu próby wykonania zadania.
• Wszystkie próby ponawiania prób są wyświetlane w interfejsie użytkownika w ramach tego samego węzła zadania.

resources:
  containers:
  - container: pycontainer
    image: python:3.11

steps:
- task: SampleTask@1
  target: host
- task: AnotherTask@1
  target: pycontainer

Timeout

Okres przekroczenia limitu czasu rozpoczyna się od uruchomienia zadania i nie obejmuje czasu, w którym zadanie jest w kolejce lub oczekuje na agenta.

W przypadku potoków klasycznych zadania oferują kilka opcji sterowania.

Włączona

Wyczyść pole wyboru Włączone , aby wyłączyć zadanie. Tymczasowe wyłączenie zadania jest przydatne do usunięcia zadania z procesu na potrzeby testowania lub dla określonych wdrożeń.

Kontynuuj przy błędzie

Wybierz tę opcję, jeśli chcesz, aby to zadanie zgłosiło powodzenie, nawet jeśli zakończy się niepowodzeniem, prawdopodobnie zezwalając na uruchamianie zadań zależnych w tym samym zadaniu. Ogólna kompilacja lub wdrożenie nie może być bardziej niż częściowo pomyślne. To, czy kolejne zadania są również uruchamiane, zależy od ich ustawienia Uruchom to zadanie .

Liczba ponownych prób w przypadku niepowodzenia zadania

Określ liczbę ponownych prób w przypadku niepowodzenia tego zadania. Wartością domyślną jest zero.

• Zadanie, które kończy się niepowodzeniem, ponawia próbę w sekundach. Czas oczekiwania przed ponowieniem próby wzrasta po każdej nieudanej próbie.
• Ponawianie próby zadania nie zapewnia idempotentności. Skutki uboczne pierwszej próby, takie jak częściowe tworzenie zasobu zewnętrznego, mogą powodować ponawianie prób.
• Dla zadania nie są udostępniane żadne informacje o liczbie ponownych prób.
• Niepowodzenie zadania dodaje ostrzeżenie do dzienników zadań wskazujących, że nie powiodło się przed ponowieniu próby wykonania zadania.
• Wszystkie próby ponawiania prób są wyświetlane w interfejsie użytkownika w ramach tego samego węzła zadania.

Timeout

Wprowadź maksymalny czas w minutach, przez który zadanie może zostać uruchomione przed automatycznym anulowaniem. Wartość domyślna to 0, lub nieskończony czas. Ustawienie wartości innej niż zero zastępuje ustawienie dla zadania lub pracy nadrzędnej. Okres przekroczenia limitu czasu rozpoczyna się od uruchomienia zadania i nie obejmuje czasu, w którym zadanie jest w kolejce lub oczekuje na agenta.

Uruchom to zadanie

Wybierz jeden z następujących warunków uruchamiania tego zadania:

• Tylko wtedy, gdy wszystkie poprzednie zadania zakończyły się pomyślnie. Ten warunek jest domyślny.
• Nawet jeśli poprzednie zadanie nie powiodło się, chyba że kompilacja została anulowana
• Nawet jeśli poprzednie zadanie nie powiodło się, nawet jeśli kompilacja została anulowana
• Tylko wtedy, gdy poprzednie zadanie zakończyło się niepowodzeniem
• Warunki niestandardowe, a następnie wprowadź warunek niestandardowy określający wyrażenie dla momentu uruchomienia tego zadania.

Zadanie potoku YAML może określać właściwość zawierającą env ciągi nazw/wartości reprezentujące zmienne środowiskowe.

- task: AzureCLI@2
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

Zmienne środowiskowe można ustawić przy użyciu script kroków lub skryptów w wierszu polecenia, powłoce Bash lub PowerShell.

Poniższy przykład uruchamia script krok, który przypisuje wartość do zmiennej środowiskowej ENV_VARIABLE_NAME i odzwierciedla wartość.

- script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

Powyższy skrypt jest funkcjonalnie taki sam jak uruchamianie zadania Bash@3 z danymi wejściowymi script . W poniższym przykładzie użyto task składni .

- task: Bash@3
  inputs:
    script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

W potokach klasycznych można dodawać i edytować zmienne środowiskowe w sekcji Zmienne środowiskowe edytora zadań.

Utwórz plik azure-pipelines.yml zawierający następującą zawartość w katalogu podstawowym projektu.

pool:
  vmImage: 'windows-latest'

jobs:
- job: NodeJS
  strategy:
    matrix:
      node14:
        nodeVersion: '14.x'
      node16:
        nodeVersion: '16.x'
    maxParallel: 2
  steps:
    - task: NodeTool@0
      displayName: 'Install Node.js $(nodeVersion)'
      inputs:
        versionSpec: '$(nodeVersion)'
        checkLatest: true

    - script: |
        echo Using Node version $(nodeVersion)
        node --version
      displayName: 'Verify Node Installation'

Zapisz i uruchom potok. Zadanie jest uruchamiane dwa razy, po jednym dla każdej wersji Node.js określonego w zmiennej nodeVersion .

Instalator narzędzi Node.js pobiera odpowiednią wersję Node.js, jeśli nie jest ona już zainstalowana na agencie. Skrypt wiersza polecenia zapisuje zainstalowaną wersję w wierszu polecenia.

1. W zadaniu agenta dla potoku klasycznego w obszarze Plan wykonania ustaw pozycję Równoległość na wielosieciową.

2. W obszarze Mnożniki wprowadź nodeVersion.

3. Ustaw maksymalną liczbę agentów na 2.

4. Dodaj zadanie instalatora narzędziaNode.js do potoku przy użyciu następujących ustawień:

   • Wprowadź wartość $(nodeVersion) w obszarze Specyfikacja wersji.
   • Zaznacz pole wyboru zaznacz pole wyboru Sprawdź, czy jest wyświetlana najnowsza wersja.

5. Dodaj zadanie Wiersza polecenia do potoku i wprowadź następujący kod w obszarze Skrypt:

   echo Using Node version $(nodeVersion)
node --version

6. Na karcie Zmienne zdefiniuj zmienną nodeVersion z wartością 14.x, 16.x i wybierz pozycję Ustaw tabelę w czasie kolejki.

   Uwaga

   W potoku wydania wybierz pozycję Ustawialne w czasie publikacji. Aby uzyskać więcej informacji, zobacz Jak edytować zmienne w czasie wdrożenia?

7. Wybierz pozycję Zapisz i zakolejkuj.

8. Na ekranie Uruchamianie potoku wybierz pozycję Zapisz i uruchom.

Zadanie jest uruchamiane dwa razy, po jednym dla każdej wersji Node.js określonego w zmiennej nodeVersion . Zadanie instalatora narzędziaNode.js pobiera wersję Node.js, jeśli nie jest jeszcze w agencie. Zadanie Command Line loguje lokalizację wersji Node.js na dysku.