작업 유형 및 사용

YAML에서는 작업 이름을 사용하여 @ 주 버전을 지정합니다. 예를 들어 작업의 버전 2에 고정하려면 다음을 PublishTestResults 수행합니다.

steps:
- task: PublishTestResults@2

YAML 파이프라인은 TFS에서 사용할 수 없습니다.

컨트롤 옵션은 섹션에서 키 task 로 사용할 수 있습니다.

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

컨트롤 옵션은 섹션에서 키 task 로 사용할 수 있습니다.

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

컨트롤 옵션은 섹션에서 키 task 로 사용할 수 있습니다.

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

시간 제한 기간은 작업 실행을 시작할 때 시작됩니다. 태스크가 대기 중이거나 에이전트를 기다리는 시간은 포함되지 않습니다.

이 YAML PublishTestResults@2 에서는 succeededOrFailed() 조건으로 인해 이전 단계가 실패하더라도 실행됩니다.

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

조건

• 동일한 에이전트 풀을 사용하는 이전의 모든 직접 및 간접 종속성이 성공한 경우에만 성공합니다. 다른 에이전트 풀이 있는 경우 해당 단계 또는 작업이 동시에 실행됩니다. YAML에 조건이 설정되지 않은 경우 이 조건은 기본값입니다.

• 이전 종속성이 실패하더라도 실행이 취소되지 않는 한. 이 조건에 대해 YAML에서 사용합니다 succeededOrFailed() .

• 이전 종속성이 실패하고 실행이 취소된 경우에도 이 조건에 대해 YAML에서 사용합니다 always() .

• 이전 종속성이 실패하는 경우에만. 이 조건에 대해 YAML에서 사용합니다 failed() .

• 식으로 구성된 사용자 지정 조건

단계 대상

태스크는 에이전트 호스트 또는 컨테이너인 실행 컨텍스트에서 실행됩니다. 개별 단계는 .를 지정하여 컨텍스트를 재정의 target할 수 있습니다. 사용 가능한 옵션은 에이전트 호스트를 대상으로 하는 단어 host 와 파이프라인에 정의된 모든 컨테이너입니다. 예시:

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

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

여기서 호스트에서 SampleTask 실행되고 AnotherTask 컨테이너에서 실행됩니다.

작업 실패 시 재시도 횟수

작업이 실패할 경우 재시도 횟수를 지정하는 데 사용합니다 retryCountOnTaskFailure . 기본값은 재시도 0입니다. 작업 속성에 대한 자세한 내용은 YAML 스키마의 steps.task를 참조하세요.

- task: <name of task>
  retryCountOnTaskFailure: <max number of retries>
   ...

YAML 파이프라인은 TFS에서 사용할 수 없습니다.

- task: AzureCLI@2
  displayName: Azure CLI
  inputs: # Specific to each task
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

다음 예제에서는 명령줄 태스크script인 단계를 실행한 다음 해당 작업 구문을 실행 합니다. 이 예제에서는 Azure DevOps CLI를 사용하여 인증하는 데 사용되는 환경 변수에 값을 AZURE_DEVOPS_EXT_PAT 할당합니다.

# Using the script shortcut syntax
- script: az pipelines variable-group list --output table
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'List variable groups using the script step'

# Using the task syntax
- task: CmdLine@2
  inputs:
    script: az pipelines variable-group list --output table
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'List variable groups using the command line task'

- task: Bash@3
  inputs:
     targetType: # specific to each task
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

다음 예제에서는 Bash@3script인 단계를 실행한 다음 해당 작업 구문을 실행 합니다. 이 예제에서는 환경 변수에 ENV_VARIABLE_NAME 값을 할당하고 값을 에코합니다.

# Using the script shortcut syntax
- script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: "my value"
  displayName: 'echo environment variable'

# Using the task syntax
- task: Bash@2
  inputs:
    script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: "my value"
  displayName: 'echo environment variable'

다음 내용을 사용하여 프로젝트의 기본 디렉터리에 azure-pipelines.yml 파일을 만듭니다.

pool:
  vmImage: ubuntu-latest

steps:
# Node install
- task: UseNode@1
  displayName: Node install
  inputs:
    version: '16.x' # The version we're installing
# Write the installed version to the command line
- script: which node

새 빌드 파이프라인 을 만들고 실행합니다. 빌드가 실행되는 방식을 관찰합니다. Node.js 도구 설치 관리자는 에이전트에 아직 없는 경우 Node.js 버전을 다운로드합니다. 명령줄 스크립트는 디스크에서 Node.js 버전의 위치를 기록합니다.

YAML 파이프라인은 TFS에서 사용할 수 없습니다.