工作類型與使用方式

在 YAML 中，您可以使用 在工作名稱中指定主要版本 @ 。 例如，若要釘選到工作的第 2 PublishTestResults 版：

steps:
- task: PublishTestResults@2

TFS 中無法使用YAML管線。

控制項選項可在區段上 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 中設定任何條件，則此條件為預設值。

• 即使先前的相依性失敗，除非取消執行。 succeededOrFailed()在此條件的 YAML 中使用。

• 即使先前的相依性失敗，即使取消執行也一樣。 always()在此條件的 YAML 中使用。

• 只有在先前的相依性失敗時。 failed()在此條件的 YAML 中使用。

• 由表達式所組成的自定義條件

步驟目標

工作會在執行內容中執行，也就是代理程式主機或容器。 個別步驟可能會藉由指定 target來覆寫其內容。 可用的選項是將代理程式主機加上管線中定義之任何容器的字 host 組。 例如：

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

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

在這裡，會在 SampleTask 主機上執行，並在 AnotherTask 容器中執行。

工作失敗時的重試次數

使用 retryCountOnTaskFailure 來指定工作失敗時重試次數。 預設值為零次重試。 如需工作屬性的詳細資訊，請參閱 YAML 架構中的 steps.task。

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

TFS 中無法使用YAML管線。

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

下列範例會script執行步驟，這是命令行工作的快捷方式，後面接著對等的工作語法。 此範例會將值指派給 AZURE_DEVOPS_EXT_PAT 環境變數，用來向 Azure DevOps CLI 進行驗證。

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

下列範例會script執行步驟，這是Bash@3的快捷方式，後面接著對等的工作語法。 此範例會將值指派給環境變數， 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版本的位置。

TFS 中無法使用YAML管線。