Udostępnij za pośrednictwem

steps.task definition

  • Artykuł

Krok task uruchamia zadanie.

Wszystkie zadania obsługują następujący zestaw typowych właściwości.

steps:
- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

steps:
- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.

Definicje odwołujące się do tej definicji: kroki

Właściwości

task ciąg. Wymagane jako pierwsza właściwość.
nazwa zadania do uruchomienia.

inputs słownik ciągów.
dane wejściowe zadania.

condition ciąg.
Oceń to wyrażenie warunku, aby określić, czy należy uruchomić to zadanie.

continueOnError wartość logiczna.
kontynuować działanie nawet w przypadku awarii?

displayName ciąg.
czytelną dla człowieka nazwę zadania.

target docelowy.
środowisko, w którym ma zostać uruchomione to zadanie.

enabled wartość logiczna.
uruchomić to zadanie, gdy zadanie zostanie uruchomione?

env słownik ciągów.
Zmienne do mapowania na środowisko procesu.

name ciąg.
identyfikator kroku. Dopuszczalne wartości: [-_A-Za-z0-9]*.

timeoutInMinutes ciąg.
Czas oczekiwania na ukończenie tego zadania, zanim serwer go zabije. Aby na przykład skonfigurować limit czasu 10 minut, użyj timeoutInMinutes: 10.

Uwaga

Potoki można skonfigurować z limitem czasu na poziomie zadania. Jeśli interwał limitu czasu na poziomie zadania upłynie przed ukończeniem kroku, zadanie uruchomione (w tym krok) zostanie zakończone, nawet jeśli krok jest skonfigurowany z dłuższym interwałem timeoutInMinutes. Aby uzyskać więcej informacji, zobacz Limity czasu.

retryCountOnTaskFailure ciąg.
liczba ponownych prób w przypadku niepowodzenia zadania. W usługach Azure DevOps Server 2022, 2022.1 i 2022.2 ponawianie prób jest obsługiwane tylko w przypadku zadań agenta. Aby uzyskać więcej informacji, zobacz aktualizacja usługi Azure DevOps 16 listopada 2021 r. — automatyczne ponawianie prób dla zadania i aktualizacja usługi Azure DevOps 14 czerwca 2025 r. — ponowne próby dla zadań serwera.

Uwagi

Tasks to bloki konstrukcyjne potoku. Istnieje wykaz zadań dostępnych do wyboru.

Jeśli nie określisz trybu polecenia, możesz skrócić strukturę target na:

- task:
  target: string  # container name or the word 'host'

Typowe właściwości zadania

Wszystkie zadania obsługują zestaw wspólnych właściwości oprócz name i inputs. Listę typowych właściwości zadań można znaleźć w poprzedniej sekcji Właściwości. Aby uzyskać więcej informacji na temat konfigurowania tych właściwości, zobacz Opcje kontroli zadań i zmienne środowiskowe zadania .

Dowiedz się więcej na temat warunków , limitów czasu i celów kroków.

Przykłady

steps:
- task: VSBuild@1
  displayName: Build
  timeoutInMinutes: 120
  inputs:
    solution: '**\*.sln'

Zobacz też