Körnings- och byggnummer

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Den här artikeln beskriver hur Azure Pipelines skapar tal och körningsnummer och hur du kan anpassa dem i dina pipelines.

Körningsnumret används för att identifiera en specifik körning av en pipeline eller en bygge. Versionsnumret är synonymt med körningsnumret.

Om du inte anger ett byggnamn i YAML-pipelines, eller om du lämnar fältet Namn tomt i klassiska pipelines, får din körning ett unikt heltal som namn. Du kan ge körningar mer användbara namn som är meningsfulla för ditt team. Du kan använda en kombination av token, variabler och understreckstecken i byggnamn.

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

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

Körningstal

Standardvärdet för ett körningsnummer i Azure Pipelines är $(Date:yyyyMMdd).$(Rev:r). $(Rev:r) är ett särskilt variabelformat som bara fungerar i byggnummerfältet. När en bygge har slutförts, om inget annat i versionsnumret har ändrats, Rev ökar heltalsvärdet med ett.

$(Rev:r) återställs till 1 när någon annan del av versionsnumret ändras. Om du till exempel konfigurerar versionsnummerformatet som $(Build.DefinitionName)_$(Date:yyyyMMdd).$(Rev:r)återställs versionsnumret när datumet ändras.

Om det tidigare versionsnumret var MyBuild_20230621.1är MyBuild_20230621.2nästa versionsnummer den dagen . Det första versionsnumret nästa dag är MyBuild_20230622.1.

$(Rev:r) återställs också till 1 om du ändrar versionsnumret för att ange en versionsändring. Om versionsformatet till exempel är 1.0.$(Rev:r) och ditt senaste versionsnummer var 1.0.3, om du ändrar versionsnumret till 1.1.$(Rev:r), är 1.1.1nästa versionsnummer .

Exempel

Överväg följande data för en byggkörning:

• Projektnamn: Fabrikam
• Pipelinenamn: CIBuild
• Gren: main
• Build ID/Run ID: 752
• Datum: 6 maj 2024
• Tid: 21:07:03
• En körning slutfördes tidigare idag.

Om du anger följande versionsnummerformat får den andra körningen den 6 maj 2024 namnet Fabrikam_CIBuild_main_20240506.2.

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

Token

I följande tabell visas hur varje token matchar, baserat på föregående exempel. Du kan bara använda dessa token för att definiera körningsnummer. De fungerar inte någon annanstans i en pipeline.

Uttryck

Om du använder ett uttryck för att ange versionsnumret kan du inte använda vissa token eftersom deras värden inte anges när uttrycken utvärderas. Dessa token inkluderar $(Build.BuildId), $(Build.BuildURL)och $(Build.BuildNumber).

Variabler

Du kan använda användardefinierade och fördefinierade variabler i ditt versionsnummer. Om du till exempel definierar My.Variablekan du ange följande nummerformat:

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

I föregående exempel är de första fyra variablerna fördefinierade. Information om hur du definierar användarvariabler finns i Ange variabler i pipelines.

Vanliga frågor

Hur stort kan ett körningsnummer vara och vilka tecken kan jag använda?

Körningsnummer kan vara upp till 255 tecken. Du kan inte använda tecknen ", , /:, <, >, ', , |, ?, @, eller , och *du kan inte avsluta talet med ..

Vilken tidszon uttrycks tidsvärdena för versionsnummer i?

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)

Relaterat innehåll

Definiera variabler