Numeri di runtime e compilazione

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Pipelines assegna un numero di esecuzione univoco (detto anche numero di build) a ogni esecuzione della pipeline. È possibile personalizzare questi numeri per renderli più significativi per il team, usando variabili, token e modelli di denominazione.

Il numero di esecuzione viene usato per identificare un'esecuzione specifica di una pipeline o di una compilazione. Il numero di build è equivalente al numero di esecuzione.

Se non si specifica un nome di compilazione nelle pipeline YAML o si lascia vuoto il campo Nome nelle pipeline classiche, l'esecuzione ottiene un numero intero univoco come nome. È possibile assegnare alle esecuzioni nomi più utili e significativi per il team. È possibile usare una combinazione di token, variabili e caratteri di sottolineatura nei nomi di compilazione.

name: $(TeamProject)_$(Build.DefinitionName)_$(SourceBranchName)_$(Date:yyyyMMdd).$(Rev:r)

steps:
  - script: echo '$(Build.BuildNumber)'  

Numero di esecuzione

Il valore predefinito per un numero di esecuzione in Azure Pipelines è $(Date:yyyyMMdd).$(Rev:r). $(Rev:r) è un formato di variabile speciale che funziona solo nel campo numero di compilazione. Al termine di una compilazione, se nient'altro è cambiato nel numero di build, il Rev valore intero aumenta di uno.

$(Rev:r) viene reimpostato su 1 quando viene modificata qualsiasi altra parte del numero di build. Ad esempio, se si configura il formato del numero di build come $(Build.DefinitionName)_$(Date:yyyyMMdd).$(Rev:r), il numero di build viene reimpostato quando cambia la data.

Se il numero di build precedente è MyBuild_20230621.1, il numero di build successivo di quel giorno è MyBuild_20230621.2. Il primo numero di build il giorno successivo è MyBuild_20230622.1.

$(Rev:r) si reimposta anche a 1 se si modifica il numero di build per indicare una modifica della versione. Ad esempio, se il formato di compilazione è 1.0.$(Rev:r) e l'ultimo numero di build è 1.0.3, se si modifica il numero di build in 1.1.$(Rev:r), il numero di build successivo è 1.1.1.

Esempio

Considerare i dati seguenti per un'esecuzione di compilazione:

• Nome progetto: Fabrikam
• Nome della pipeline: CIBuild
• Ramo: main
• ID di compilazione/ID esecuzione: 752
• Data: 6 maggio 2024
• Ora: 9:07:03 PM
• Un'esecuzione completata prima di oggi.

Se si specifica il formato del numero di build seguente, la seconda esecuzione il 6 maggio 2024 è denominata Fabrikam_CIBuild_main_20240506.2.

$(TeamProject)_$(Build.DefinitionName)_$(SourceBranchName)_$(Date:yyyyMMdd).$(Rev:r)

Token

Nella tabella seguente viene illustrato il modo in cui ogni token viene risolto, in base all'esempio precedente. È possibile usare questi token solo per definire i numeri di esecuzione. Non funzionano altrove in una pipeline.

Espressioni

Se si usa un'espressione per impostare il numero di build, non è possibile usare alcuni token, perché i relativi valori non vengono impostati al momento della valutazione delle espressioni. Questi token includono $(Build.BuildId), $(Build.BuildURL)e $(Build.BuildNumber).

Variabili

È possibile usare variabili definite dall'utente e predefinite nel numero di build. Ad esempio, se si definisce My.Variable, è possibile specificare il formato numerico seguente:

$(Build.DefinitionName)_$(Build.DefinitionVersion)_$(Build.RequestedFor)_$(Build.BuildId)_$(My.Variable)

Nell'esempio precedente le prime quattro variabili sono predefinite. Per informazioni su come definire le variabili utente, vedere Impostare le variabili nelle pipeline.

Domande frequenti

Quanto può essere grande un numero di esecuzione e quali caratteri è possibile usare?

I numeri di esecuzione possono contenere fino a 255 caratteri. Non è possibile usare i caratteri ", /, \, :, <, >, ', |, ?, @o *e non è possibile terminare il numero con ..

In quale fuso orario sono espressi i valori di ora del numero di build?

variables:
  - name: why
    ${{ if eq(variables['Build.Reason'], 'PullRequest') }}:
      value: pr
    ${{ elseif eq(variables['Build.Reason'], 'Manual' ) }}:
      value: manual
    ${{ elseif eq(variables['Build.Reason'], 'IndividualCI' ) }}:
      value: indivci
    ${{ else }}:
      value: other

name: $(TeamProject)_$(SourceBranchName)_$(why)_$(Date:yyyyMMdd).$(Rev:r)

pool:
  vmImage: 'ubuntu-latest'

steps:
- script: echo '$(Build.BuildNumber)'

# Set MyRunNumber
variables: 
  MyRunNumber: '1.0.0-CI+$(Build.BuildNumber)'

steps:
- script: echo $(MyRunNumber)
- script: echo $(Build.BuildNumber)

Contenuto correlato

Definire le variabili