Tipi di attività e utilizzo

In YAML specificare la versione principale usando @ nel nome dell'attività. Ad esempio, per usare la versione 2 dell'attività PublishTestResults , specificare PublishTestResults@2. È possibile indicare quale versione secondaria utilizzare fornendo il numero di versione completo dell'attività dopo @, ad esempio [email protected].

Nelle pipeline classiche ogni attività ha un selettore di versione per consentire di scegliere la versione desiderata. Considerare la clonazione della pipeline e testare la pipeline clonata con nuove versioni principali delle attività. Se si seleziona una versione di anteprima, ad esempio 1.* Preview, la versione è ancora in fase di sviluppo e potrebbe avere problemi.

Se si modifica la versione e si verificano problemi con le compilazioni, è possibile ripristinare la modifica della pipeline dalla scheda Cronologia . Per le pipeline di versione, la possibilità di eseguire il ripristino a una versione precedente non è disponibile. È necessario ripristinare manualmente le modifiche alla pipeline di rilascio, quindi salvare la pipeline.

Per i passaggi della pipeline task YAML sono disponibili le proprietà seguenti. Per altre informazioni, vedere la definizione steps.task .

Condizioni

Un'attività non può determinare se continuare il processo della pipeline al termine dell'attività, può solo fornire uno stato finale, succeeded ad esempio, o failed. Le attività e i processi downstream possono quindi impostare un condition in base a tale stato per determinare se eseguire.

La proprietà conditions specifica le condizioni in cui viene eseguita questa attività. Per impostazione predefinita, un passaggio viene eseguito se nulla nel suo lavoro è ancora fallito e il passaggio immediatamente precedente è stato completato.

È possibile eseguire l'override o personalizzare queste impostazioni predefinite impostando il passaggio da eseguire anche se o solo se una dipendenza precedente ha esito negativo o ha un altro risultato. È anche possibile definire condizioni personalizzate, costituite da espressioni.

Le condizioni in base allo stato precedente delle dipendenze includono:

• Operazione completata: viene eseguita solo se tutte le dipendenze precedenti hanno esito positivo. Questo comportamento è l'impostazione predefinita se non viene impostata alcuna condizione in YAML. Per applicare questa condizione, specificare condition: succeeded().
• Operazione riuscita o non riuscita: eseguire anche se una dipendenza precedente non riesce, a meno che l'esecuzione non venga annullata. Per applicare questa condizione, specificare condition: succeededOrFailed().
• Sempre: eseguire anche se una dipendenza precedente ha esito negativo, anche se l'esecuzione viene annullata. Per applicare questa condizione, specificare condition: always().
• Non riuscito: viene eseguito solo quando una dipendenza precedente ha esito negativo. Per applicare questa condizione, specificare condition: failed().

Nell'esempio YAML seguente, PublishTestResults@2 viene eseguito anche se il passaggio precedente è fallito, grazie alla condizione succeededOrFailed.

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

Continua in caso di errore

La continueOnError proprietà indica all'attività se continuare l'esecuzione e segnalare l'esito positivo indipendentemente dagli errori. Se impostato su true, questa proprietà indica all'attività di ignorare lo stato failed e continuare l'esecuzione. I passaggi downstream e le attività complementari trattano il risultato dell'attività come success quando prendono le decisioni di esecuzione.

Attivata

Per impostazione predefinita, l'attività viene eseguita ogni volta che viene eseguito il processo. È possibile impostare enabled su false per disabilitare l'attività. Disabilitare temporaneamente l'attività è utile per rimuovere l'attività dal processo a scopo di test o per distribuzioni specifiche.

Numero di tentativi in caso di errore dell'attività

La retryCountOnTaskFailure proprietà specifica il numero di tentativi di ripetizione dell'attività in caso di errore. Il valore predefinito è zero ripetizioni.

• Il numero massimo di tentativi consentiti è 10.
• Il tempo di attesa aumenta dopo ogni tentativo non riuscito, seguendo una strategia di backoff esponenziale. Il primo tentativo si verifica dopo 1 secondo, il secondo tentativo dopo 4 secondi e il decimo tentativo dopo 100 secondi.
• Riprovare l'attività non fornisce idempotenza. Gli effetti collaterali del primo tentativo, ad esempio la creazione parziale di una risorsa esterna, potrebbero causare l'esito negativo dei tentativi.
• Nessuna informazione del numero dei tentativi viene resa disponibile per l'attività.
• Il fallimento del compito aggiunge un avviso ai registri delle attività, indicando che è fallito prima di riprovare il compito.
• Tutti i tentativi vengono visualizzati nell'interfaccia utente come parte dello stesso nodo attività.

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

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

Interruzione temporanea

Il periodo di timeout inizia quando il task inizia l'esecuzione e non include il tempo in cui il task viene accodato o è in attesa di un agente.

Nelle pipeline classiche le attività offrono diverse opzioni di controllo.

Attivata

Deselezionare la casella di controllo Abilitato per disabilitare un'attività. Disabilitare temporaneamente l'attività è utile per rimuovere l'attività dal processo a scopo di test o per distribuzioni specifiche.

Continua in caso di errore

Selezionare questa opzione se si vuole che questa attività restituisca l'esito positivo anche se ha esito negativo, consentendo l'esecuzione delle attività dipendenti nello stesso processo. La compilazione o la distribuzione complessiva non possono essere più che parzialmente riuscite. L'esecuzione delle attività successive dipende anche dall'impostazione Esegui questa attività .

Numero di tentativi se l'attività non è riuscita

Specificare il numero di tentativi se l'attività ha esito negativo. Il valore predefinito è zero.

• L'attività non riuscita viene ritentata dopo alcuni secondi. Il tempo di attesa prima di riprovare aumenta dopo ogni tentativo non riuscito.
• Riprovare l'attività non fornisce idempotenza. Gli effetti collaterali del primo tentativo, ad esempio la creazione parziale di una risorsa esterna, potrebbero causare l'esito negativo dei tentativi.
• Nessuna informazione sul numero di tentativi viene resa disponibile all'attività.
• Il fallimento del compito aggiunge un avviso ai registri delle attività, indicando che è fallito prima di riprovare il compito.
• Tutti i tentativi vengono visualizzati nell'interfaccia utente come parte dello stesso nodo attività.

Interruzione temporanea

Immettere il tempo massimo in minuti che l'attività può essere eseguita prima di essere annullata automaticamente. Il valore predefinito è 0, o tempo infinito. L'impostazione di un valore diverso da zero sostituisce quella dell'attività genitore. Il periodo di timeout inizia quando il task inizia l'esecuzione e non include il tempo in cui il task viene accodato o è in attesa di un agente.

Eseguire questa attività

Selezionare una delle condizioni seguenti per l'esecuzione di questa attività:

• Solo quando tutte le attività precedenti hanno avuto esito positivo. Questa condizione è l'impostazione predefinita.
• Anche se un'attività precedente non è riuscita, a meno che la compilazione non sia stata annullata
• Anche se un'attività precedente non è riuscita, anche se la compilazione è stata annullata
• Solo quando un'attività precedente non è riuscita
• Condizioni personalizzate e quindi immettere una condizione personalizzata che specifica un'espressione per quando l'attività deve essere eseguita.

Un'attività della pipeline YAML può specificare una env proprietà che elenca le stringhe nome/valore che rappresentano le variabili di ambiente.

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

È possibile impostare le variabili di ambiente usando script i passaggi o gli script nella riga di comando, Bash o nelle attività di PowerShell.

Nell'esempio seguente viene eseguito un script passaggio che assegna un valore alla ENV_VARIABLE_NAME variabile di ambiente e restituisce il valore .

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

Lo script precedente è funzionalmente uguale all'esecuzione di un'attività Bash@3 con un script input. Nell'esempio seguente viene utilizzata la task sintassi .

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

Nelle pipeline classiche è possibile aggiungere e modificare le variabili di ambiente nella sezione Variabili di ambiente dell'editor attività.

Creare un file azure-pipelines.yml con il contenuto seguente nella directory di base del progetto.

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'

Salvare ed eseguire la pipeline. Il processo viene eseguito due volte, uno per ogni versione di Node.js specificata nella nodeVersion variabile.

Il programma di installazione dello strumento di Node.js scarica la versione Node.js se non è già presente nell'agente. Lo script della riga di comando scrive la versione installata nella riga di comando.

1. Nel processo Agent per la pipeline classica, sotto Piano di esecuzione imposta Parallelismo su Multiconfigurazione.

2. In Moltiplicatori immettere nodeVersion.

3. Impostare Numero massimo di agenti su 2.

4. Aggiungere l'attività di installazione dello strumento diNode.js alla pipeline con le impostazioni seguenti:

   • Immettere $(nodeVersion) in Specifica della versione.
   • Selezionare la casella di controllo Verifica versione più recente.

5. Aggiungere l'attività Riga di comando alla pipeline e immettere il codice seguente in Script:

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

6. Nella scheda Variabili definire la variabile nodeVersion con il valore 14.x, 16.x e selezionare Imposta tabella in fase di coda.

   Nota

   In una pipeline di versione, selezionare Configurabile al momento del rilascio. Per altre informazioni, vedere Come è possibile modificare le variabili in fase di rilascio?

7. Selezionare Salva e metti in coda.

8. Nella schermata Esegui pipeline, seleziona Salva ed esegui.

Il processo viene eseguito due volte, uno per ogni versione di Node.js specificata nella nodeVersion variabile. L'attività programma di installazione dello strumento Node.js scarica la versione di Node.js se non è già installata nell'agente. L'attività Riga di comando registra il percorso della versione di Node.js su disco.