実行番号とビルド番号

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

この記事では、Azure Pipelines のビルド番号と実行番号の作成方法と、それらをパイプラインでカスタマイズする方法について説明します。

実行番号は、パイプラインまたはビルドの特定の実行を識別するために使用されます。 ビルド番号は、実行番号と同義です。

YAML パイプラインでビルド名を指定しない場合、またはクラシック パイプラインで [名前] フィールドを空白のままにした場合、実行はその名前として一意の整数を取得します。 チームにとって意味があり使いやすい名前を実行に付けることが推奨されます。 ビルド名には、トークン、変数、アンダースコア文字の組み合わせることができます。

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

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

実行数

Azure Pipelines の実行番号の既定値は $(Date:yyyyMMdd).$(Rev:r)です。 $(Rev:r) は、[ビルド番号] フィールドのみで機能する特殊な変数形式です。 ビルド番号が他に何も変更されていない場合、ビルドが完了すると、Rev 整数値は 1 ずつ増加します。

ビルド番号の他の部分が変更されると、$(Rev:r) は 1 にリセットされます。 たとえば、ビルド番号の形式を $(Build.DefinitionName)_$(Date:yyyyMMdd).$(Rev:r) として構成する場合、ビルド番号は、日付が変更されるとリセットされます。

前のビルド番号が MyBuild_20230621.1 だった場合、その日の次のビルド番号は、MyBuild_20230621.2 になります。 翌日の最初のビルド番号は、MyBuild_20230622.1 です。

バージョン変更を示すためにビルド番号を変更する場合、$(Rev:r) も 1 にリセットされます。 たとえば、ビルド形式が、1.0.$(Rev:r) で、最後のビルド番号が 1.0.3 の場合に、ビルド番号を 1.1.$(Rev:r) に変更すると、次のビルド番号は 1.1.1 になります。

例

ビルド実行には、次のデータを検討します。

• プロジェクト名: Fabrikam
• パイプライン名: CIBuild
• [ブランチ]: main
• ビルド ID/実行 ID: 752
• 日付: 2024 年 5 月 6 日
• 時刻 : 9:07:03 PM
• 1 回の実行は、今日の早い段階で完了しました。

次のビルド番号形式を指定すると、2024 年 5 月 6日の 2番目の実行の名前は、Fabrikam_CIBuild_main_20240506.2 となります。

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

トークン

次の表に、前の例に基づいて各トークンがどのように解決されるかを示します。 これらのトークンは、実行番号の定義にのみ使用できます。 パイプライン内の他の場所では機能しません。

式

式を使用してビルド番号を設定する場合、式の評価時に値が設定されないため、一部のトークンを使用できません。 これらのトークンには、$(Build.BuildId)、$(Build.BuildURL)、$(Build.BuildNumber) が含まれます。

変数

ビルド番号には、ユーザー定義変数と定義済み変数を使用できます。 たとえば、My.Variable を定義した場合は、次の数値形式を指定できます。

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

前の例では、最初の 4 つの変数が定義済みです。 ユーザー変数を定義する方法については、「パイプラインで変数を設定する」を参照してください。

よく寄せられる質問

実行番号の大きさと使用できる文字は何ですか?

実行番号には、最大 255 文字使用できます。 文字 "、/、:、<、>、'、|、?、@、または *を使用することはできません。また、. で番号を終了することはできません。

ビルド番号の時間値はどのタイム ゾーンで表されますか?

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)

関連するコンテンツ

変数の定義