Görev türleri ve kullanımı

YAML'de, görev adında kullanarak @ ana sürümü belirtirsiniz. Örneğin, görevin 2. sürümüne sabitlemek PublishTestResults için:

steps:
- task: PublishTestResults@2

YAML işlem hatları TFS'de kullanılamaz.

Denetim seçenekleri bölümünde anahtar task olarak kullanılabilir.

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

Denetim seçenekleri bölümünde anahtar task olarak kullanılabilir.

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

Denetim seçenekleri bölümünde anahtar task olarak kullanılabilir.

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

Zaman aşımı süresi, görev çalışmaya başladığında başlar. Görevin kuyruğa alındığı veya aracı beklediği süreyi içermez.

Bu YAML'de, PublishTestResults@2 önceki adım succeededOrFailed() koşulu nedeniyle başarısız olsa bile çalışır.

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

Koşullar

• Yalnızca aynı aracı havuzuna sahip önceki tüm doğrudan ve dolaylı bağımlılıklar başarılı olduğunda. Farklı aracı havuzlarınız varsa, bu aşamalar veya işler eşzamanlı olarak çalışır. YAML'de hiçbir koşul ayarlanmadıysa bu koşul varsayılandır.

• Önceki bir bağımlılık başarısız olsa bile, çalıştırma iptal edilmediği sürece. Bu koşul için YAML'de kullanın succeededOrFailed() .

• Önceki bir bağımlılık başarısız olsa ve çalıştırma iptal edilse bile. Bu koşul için YAML'de kullanın always() .

• Yalnızca önceki bir bağımlılık başarısız olduğunda. Bu koşul için YAML'de kullanın failed() .

• İfadelerden oluşan özel koşullar

Adım hedefi

Görevler, aracı konağı veya kapsayıcı olan bir yürütme bağlamında çalışır. Tek bir adım, bir targetbelirterek bağlamını geçersiz kabilir. Kullanılabilir seçenekler, aracı ana bilgisayarını ve işlem hattında tanımlanan tüm kapsayıcıları hedeflemek için kullanılır host . Örneğin:

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

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

Burada konak üzerinde çalıştırılır SampleTask ve AnotherTask bir kapsayıcıda çalıştırılır.

Görev başarısız olursa yeniden deneme sayısı

Görev başarısız olursa yeniden deneme sayısını belirtmek için kullanın retryCountOnTaskFailure . Varsayılan değer sıfır yeniden denemedir. Görev özellikleri hakkında daha fazla bilgi için YAML Şeması'ndaki steps.task dosyasına bakın.

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

YAML işlem hatları TFS'de kullanılamaz.

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

Aşağıdaki örnek, Komut satırı görevi için bir kısayol olan ve ardından eşdeğer görev söz dizimi olan adımı çalıştırırscript. Bu örnek, Azure DevOps CLI ile kimlik doğrulaması yapmak için kullanılan ortam değişkenine bir değer AZURE_DEVOPS_EXT_PAT atar.

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

Aşağıdaki örnek, Bash@3 için bir kısayol olan ve ardından eşdeğer görev söz dizimi olan adımı çalıştırırscript. Bu örnek, ortam değişkenine ENV_VARIABLE_NAME bir değer atar ve değeri yankılar.

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

Projenizin temel dizininde aşağıdaki içeriklerle bir azure-pipelines.yml dosyası oluşturun.

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

Yeni bir derleme işlem hattı oluşturun ve çalıştırın. Derlemenin nasıl çalıştığını gözlemleyin. Node.js Aracı Yükleyicisi, aracıda değilse Node.js sürümünü indirir. Komut Satırı betiği, diskte Node.js sürümünün konumunu günlüğe kaydeder.

YAML işlem hatları TFS'de kullanılamaz.