定義済み変数の使用

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

Note

Microsoft Team Foundation Server (TFS) 2018 以前のバージョンでは、ビルドとリリースの "パイプライン" は "定義"、"実行" は "ビルド"、"サービス接続" は "サービス エンドポイント"、"ステージ" は "環境"、"ジョブ" は "フェーズ" と呼ばれます。

変数を使用すると、パイプラインのさまざまな部分にデータのキー ビットを取得する便利な方法が提供されます。 これは、使用できる定義済みの変数の一覧です。 他にも定義済みの変数がいくつかありますが、主に内部使用用です。

これらの変数は、システムによって自動的に設定され、読み取り専用です。 (例外は Build.Clean と System.Debug です)。

YAML パイプラインでは、定義済みの変数を環境変数として参照できます。 たとえば、変数は変数Build.ArtifactStagingDirectoryBUILD_ARTIFACTSTAGINGDIRECTORYになります。

クラシック パイプラインの場合、デプロイ タスクで リリース変数 を使用して共通の情報 (例: 環境名、リソース グループなど) を共有できます。

変数の操作について詳しくは、こちらをご覧ください。

Build.Clean

これは、ビルド エージェントがソースをクリーンアップする方法を変更する非推奨の変数です。 ソースをクリーンアップする方法については、「 エージェントのローカル リポジトリをクリーンアップする」を参照してください。

System.AccessToken

System.AccessToken は、実行中のビルドで使用されるセキュリティ トークンを格納する特別な変数です。

YAML では、変数を使用してパイプラインに明示的にマップ System.AccessToken する必要があります。 これは、ステップ レベルまたはタスク レベルで実行できます。

steps:
  - bash: echo This script could use $SYSTEM_ACCESSTOKEN
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)
  - powershell: | 
      Write-Host "This is a script that could use $env:SYSTEM_ACCESSTOKEN"
      Write-Host "$env:SYSTEM_ACCESSTOKEN = $(System.AccessToken)"
    env:
      SYSTEM_ACCESSTOKEN: $(System.AccessToken)

ビルド ジョブ承認スコープを使用するための既定のSystem.AccessTokenスコープを構成できます。

System.Debug

パイプラインの問題をデバッグするための詳細なログについては、それを定義 System.Debug して設定します true

  1. パイプラインを編集します。

  2. [変数] を選択します。

  3. 名前 System.Debug と値を含む新しい変数を追加します true

    システム デバッグを true に設定する

  4. 新しい変数を保存します。

エージェント変数 (DevOps Services)

Note

エージェント変数は、スクリプトの環境変数として、およびビルド タスクのパラメーターとして使用できます。 これらを使用してビルド番号をカスタマイズしたり、バージョン 管理ラベルまたはタグを適用したりすることはできません。

変数説明
Agent.BuildDirectory

特定のビルド パイプラインのすべてのフォルダーが作成されるエージェントのローカル パス。 この変数の値 Pipeline.Workspaceは .

例: /home/vsts/work/1

Agent.ContainerMapping

YAML のコンテナー リソース名から実行時の Docker ID へのマッピング。

例:

{
  "one_container": {
    "id": "bdbb357d73a0bd3550a1a5b778b62a4c88ed2051c7802a0659f1ff6e76910190"
  },
  "another_container": {
    "id": "82652975109ec494876a8ccbb875459c945982952e0a72ad74c91216707162bb"
  }
}

Agent.HomeDirectory エージェントがインストールされているディレクトリ。 これにはエージェント ソフトウェアが含まれます。 (例: c:\agent)。
Agent.Id エージェントの ID。
Agent.JobName 実行中のジョブの名前。 これは通常、"ジョブ" または "__default" になりますが、マルチ構成シナリオでは構成になります。
Agent.JobStatus ビルドの状態。
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (部分的に成功)

環境変数は次のように AGENT_JOBSTATUS参照する必要があります。 以前のバージョン agent.jobstatus は、下位互換性のために使用できます。

Agent.MachineName エージェントがインストールされているコンピューターの名前。
Agent.Name

プールに登録されているエージェントの名前。

セルフホステッド エージェントを使用している場合、この名前はユーザーによって指定されます。 エージェントを参照してください。

Agent.OS エージェント ホストのオペレーティング システム。 有効な値は次のとおりです。
  • Windows_NT
  • Darwin
  • Linux
コンテナーで実行している場合、エージェントのホストとコンテナーが異なるオペレーティング システムを実行している可能性があります。
Agent.OSArchitecture エージェント ホストのオペレーティング システム プロセッサ アーキテクチャ。 有効な値は次のとおりです。
  • X86
  • X64
  • ARM
Agent.TempDirectory

各パイプライン ジョブの後にクリーンアップされる一時フォルダー。 このディレクトリは、発行前にテスト結果などの一時的な項目を保持するために 、.NET Core CLI タスクなどのタスク で使用されます。

例: /home/vsts/work/_temp Ubuntu の場合

Agent.ToolsDirectory Node Tool InstallerPython バージョンを使用して複数のバージョンのツールを切り替えるなどのタスクで使用されるディレクトリ。 これらのタスクは、後続のビルド手順で使用できるように、このディレクトリ PATH からツールを追加します。

セルフホステッド エージェントでこのディレクトリを管理する方法について説明します。
Agent.WorkFolder このエージェントの作業ディレクトリ。 (例: c:\agent_work)。

注: このディレクトリは、パイプライン タスクによって書き込み可能であるとは限りません (たとえば、コンテナーにマップされている場合)

ビルド変数 (DevOps Services)


変数説明テンプレートで使用できますか?
Build.ArtifactStagingDirectory

成果物がコピー先にプッシュされる前にコピーされるエージェントのローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行 することです。

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

「Azure Pipelines の成果物」を参照してください。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.BuildId 完了したビルドのレコードの ID。 いいえ
Build.BuildNumber 完了したビルドの名前。実行番号とも呼ばれます。 この値 に含まれるものを 指定できます。

この変数の一般的な用途は、 リポジトリ タブで指定したラベル形式の一部にすることです。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。



この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.BuildUri ビルドの URI。 (例: vstfs:///Build/Build/1430)。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.BinariesDirectory コンパイル済みバイナリの出力フォルダーとして使用できるエージェントのローカル パス。

既定では、このディレクトリをクリーンアップするように新しいビルド パイプラインは設定されません。 ビルドを定義して、[ リポジトリ] タブでクリーンアップできます。

(例: c:\agent_work\1\b)。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.ContainerId 成果物のコンテナーの ID。 パイプラインで成果物をアップロードすると、その特定の成果物に固有のコンテナーに追加されます。 いいえ
Build.DefinitionName ビルド パイプラインの名前。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

はい
Build.DefinitionVersion ビルド パイプラインのバージョン。 はい
Build.QueuedBy ID 変数はどのように設定されますか?」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

はい
Build.QueuedById ID 変数はどのように設定されますか?」を参照してください。 はい
Build.Reason ビルドの実行の原因となったイベント。
  • Manual: ユーザーがビルドを手動でキューに入れた。
  • IndividualCI: Git プッシュまたは TFVC チェックインによってトリガーされる継続的インテグレーション (CI)。
  • BatchedCI: Git プッシュまたは TFVC チェックインによってトリガーされ、Batch の変更が選択された継続的インテグレーション (CI)。
  • Schedule: スケジュールされた トリガー。
  • ValidateShelveset: ユーザーが特定の TFVC シェルブセットのビルドを手動でキューに入れた。
  • CheckInShelveset: ゲート チェックイン トリガー。
  • PullRequest: ビルドは、ビルドを必要とする Git ブランチ ポリシーによってトリガーされました。
  • ResourceTrigger: ビルドが リソース トリガーによってトリガーされたか別のビルドによってトリガーされました
ビルド パイプライン トリガー」「ブランチ ポリシーを使用してコード品質を向上させる」を参照してください。
はい
Build.Repository.Clean ソース リポジトリの設定[クリーン] に選択した値。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.LocalPath

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

重要な注意: 1 つの Git リポジトリのみをチェックアウトする場合、このパスはコードへの正確なパスになります。 複数のリポジトリをチェックアウトする場合、動作は次のようになります (Build.SourcesDirectory 変数の値とは異なる場合があります)。

  • セルフ (プライマリ) リポジトリのチェックアウト ステップにカスタム チェックアウト パスが定義されていない場合、またはチェックアウト パスがセルフ リポジトリのマルチチェックアウトの既定のパス $(Pipeline.Workspace)/s/<RepoName> である場合、この変数の値は $(Pipeline.Workspace)/s既定値に戻ります。
  • セルフ (プライマリ) リポジトリのチェックアウト 手順にカスタム チェックアウト パスが定義されている場合 (また、マルチチェックアウトの既定のパスではない場合)、この変数にはセルフ リポジトリへの正確なパスが含まれます。
この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.ID リポジトリの一意識別子。

リポジトリの名前が変更されても、これは変更されません。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.Name トリガーする リポジトリの名前。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.Provider トリガーする リポジトリの種類。 この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 いいえ
Build.Repository.Tfvc.Workspace リポジトリがTeam Foundation バージョン管理場合に定義されます。 ビルド エージェントによって使用される TFVC ワークスペース の名前。


たとえば、Agent.BuildDirectory が Agent.Id の c:\agent_work\12 場合、ワークスペース名は 8次のようになります。 ws_12_8

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.Uri トリガーするリポジトリの URL。 次に例を示します。 この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 いいえ
Build.RequestedFor ID 変数の設定方法」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

はい
Build.RequestedForEmail ID 変数の設定方法」を参照してください。 はい
Build.RequestedForId ID 変数の設定方法」を参照してください。 はい
Build.SourceBranch ビルドがキューに登録されたトリガー リポジトリのブランチ。 次に例をいくつか示します。
  • Git リポジトリ ブランチ: refs/heads/main
  • Git リポジトリのプル要求: refs/pull/1/merge
  • TFVC リポジトリ ブランチ: $/teamproject/main
  • TFVC リポジトリゲートチェックイン: Gated_2016-06-06_05.20.51.4369;username@live.com
  • TFVC リポジトリシェルブセットのビルド: myshelveset;username@live.com
  • パイプラインがタグによってトリガーされる場合: refs/tags/your-tag-name
この変数をビルド番号形式で使用すると、スラッシュ文字 (/) はアンダースコア文字 _に置き換えられます。

注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、または手動でシェルブ・セットを作成している場合、この変数をビルド番号形式で使用することはできません。
はい
Build.SourceBranchName ビルドがキューに登録されたトリガー リポジトリ内のブランチの名前。
  • Git リポジトリ ブランチ、プル要求、またはタグ: ref 内の最後のパス セグメント。たとえば、この値では refs/heads/mainmain. この値は refs/heads/feature/toolstools. この値は refs/tags/your-tag-nameyour-tag-name.
  • TFVC リポジトリ ブランチ: ワークスペースのルート サーバー パス内の最後のパス セグメント。 たとえば、この値では $/teamproject/mainmain.
  • TFVC リポジトリゲートチェックインまたはシェルブセットビルドは、シェルブセットの名前です。 たとえば、Gated_2016-06-06_05.20.51.4369;username@live.com または myshelveset;username@live.com です。
注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、または手動でシェルブ・セットを作成している場合、この変数をビルド番号形式で使用することはできません。
はい
Build.SourcesDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインでは、変更されたファイルのみが更新されます。

重要な注意: 1 つの Git リポジトリのみをチェックアウトする場合、このパスはコードへの正確なパスになります。 複数のリポジトリをチェックアウトすると、セルフ (プライマリ) リポジトリが $(Pipeline.Workspace)/sマルチチェックアウトの既定 $(Pipeline.Workspace)/s/<RepoName> のパスとは異なるカスタム パスにチェックアウトされた場合でも、既定値に戻ります (この点では、変数は Build.Repository.LocalPath 変数の動作とは異なります)。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.SourceVersion このビルドに含まれるトリガー リポジトリの最新バージョンコントロールの変更。 この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 はい
Build.SourceVersionMessage トリガーするリポジトリのコミットまたは変更セットのコメント。 最初の行または 200 文字のどちらか短い方にメッセージを切り捨てます。

コミット Build.SourceVersionMessageBuild.SourceVersion のメッセージに対応します。 PR ビルドのコミットは Build.SourceVersion マージ コミットです (ソース ブランチのコミットではありません)。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 また、この変数はステップ レベルでのみ使用でき、ジョブ レベルとステージ レベルでは使用できません (つまり、ジョブが開始してコードをチェックアウトするまでメッセージは抽出されません)。

注: この変数は TFS 2015.4 で使用できます。

いいえ
Build.StagingDirectory

成果物がコピー先にプッシュされる前にコピーされるエージェント上のローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行することです

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

Azure Pipelines の成果物に関するページを参照してください。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.Repository.Git.SubmoduleCheckout リポジトリ タブチェックアウト サブモジュールに対して選択した値。複数のリポジトリがチェックアウトされている場合、この値はトリガーリポジトリの設定を追跡します。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.SourceTfvcShelveset リポジトリがTeam Foundation バージョン管理されている場合に定義されます。


ゲートビルドまたはシェルブセットビルドを実行している場合、これは構築するシェルブセットの名前に設定されます。

注: この変数は、ビルド番号形式でのビルド使用に無効な値を生成します。
いいえ
Build.TriggeredBy.BuildId ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルドの BuildID に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

使用して resourcesYAML パイプラインをトリガーする場合は、代わりに リソース変数 を使用する必要があります。
いいえ
Build.TriggeredBy.DefinitionId ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーされるビルドの DefinitionID に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

使用して resourcesYAML パイプラインをトリガーする場合は、代わりに リソース変数 を使用する必要があります。
いいえ
Build.TriggeredBy.DefinitionName ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーされるビルド パイプラインの名前に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

使用して resourcesYAML パイプラインをトリガーする場合は、代わりに リソース変数 を使用する必要があります。
いいえ
Build.TriggeredBy.BuildNumber ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーされるビルドの数に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

使用して resourcesYAML パイプラインをトリガーする場合は、代わりに リソース変数 を使用する必要があります。
いいえ
Build.TriggeredBy.ProjectID ビルドが別の ビルドによってトリガーされた場合、この変数は、トリガーするビルドを含むプロジェクトの ID に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

使用して resourcesYAML パイプラインをトリガーする場合は、代わりに リソース変数 を使用する必要があります。
いいえ
Common.TestResultsDirectory テスト結果が作成されるエージェントのローカル パス。 例: c:\agent_work\1\TestResults

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ

パイプライン変数 (DevOps Services)

変数説明
Pipeline.Workspace 特定のパイプラインのワークスペース ディレクトリ。 この変数の値 Agent.BuildDirectoryは .

たとえば、「 /home/vsts/work/1 」のように入力します。

デプロイ ジョブ変数 (DevOps Services)

これらの変数のスコープは特定の デプロイ ジョブ であり、ジョブの実行時にのみ解決されます。

変数説明
Environment.Name 展開手順を実行し、デプロイ履歴を記録する展開ジョブの対象となる環境の名前。 たとえば、「 smarthotel-dev 」のように入力します。
Environment.Id デプロイ ジョブの対象となる環境の ID。 たとえば、「 10 」のように入力します。
Environment.ResourceName デプロイ ジョブの対象となる環境内の特定のリソースの名前。デプロイ手順を実行し、デプロイ履歴を記録します。 たとえば、 bookings 環境にリソース smarthotel-devとして追加された Kubernetes 名前空間です。
Environment.ResourceId デプロイ 手順を実行するデプロイ ジョブの対象となる環境内の特定のリソースの ID。 たとえば、「 4 」のように入力します。
Strategy.Name デプロイ戦略の名前: canary、 または runOncerolling.
Strategy.CycleName デプロイ内の現在のサイクル名。 オプションは PreIteration、、 Iteration、、または PostIterationです。

システム変数 (DevOps Services)

変数説明テンプレートで使用できますか?
System.AccessToken OAuth トークンを使用して REST API にアクセスします

YAML スクリプトから System.AccessToken を使用します

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
はい
System.CollectionId TFS コレクションまたは Azure DevOps 組織の GUID。 はい
System.CollectionUri TFS コレクションまたは Azure DevOps 組織の URI。 (例: https://dev.azure.com/fabrikamfiber/)。 はい
System.DefaultWorkingDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

はい
System.DefinitionId ビルド パイプラインの ID。 はい
System.HostType buildパイプラインがビルドの場合に設定します。 リリースの場合、値は deployment デプロイ グループ ジョブ、 gates ゲートの評価中、およびその release 他の (エージェントおよびエージェントレス) ジョブ用です。 はい
System.JobAttempt このジョブが初めて試行されるときに 1 に設定され、ジョブが再試行されるたびにインクリメントされます。 いいえ
System.JobDisplayName ジョブに与えられた人間が判読できる名前。 いいえ
System.JobId 1 つのジョブの 1 回の試行に対する一意の識別子。 値は現在のパイプラインに固有です。 いいえ
System.JobName 通常、依存関係の表現と出力変数へのアクセスに使用されるジョブの名前。 いいえ
System.PhaseAttempt このフェーズが初めて試行されるときに 1 に設定され、ジョブが再試行されるたびにインクリメントされます。

メモ: "フェーズ" は、ジョブの設計時を表すほぼ冗長な概念です (ジョブはフェーズのランタイム バージョンでした)。 ほとんどの場合、Azure Pipelines から "フェーズ" の概念を削除しました。 マトリックス ジョブとマルチ構成ジョブは、"フェーズ" がまだ "job" とは異なる唯一の場所です。 1 つのフェーズで、入力のみが異なる複数のジョブをインスタンス化できます。
いいえ
System.PhaseDisplayName フェーズに与えられる人間が判読できる名前。 いいえ
System.PhaseName ジョブの文字列ベースの識別子。通常、依存関係を表し、出力変数にアクセスするために使用されます。 いいえ
System.PlanId 1 つのパイプライン実行の文字列ベースの識別子。 いいえ
System.PullRequest.IsFork プル要求がリポジトリのフォークからの場合、この変数は True. それ以外の場合は、次に False設定されます。 はい
System.PullRequest.PullRequestId このビルドの原因となったプル要求の ID。 (例: 17)。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。 いいえ
System.PullRequest.PullRequestNumber このビルドの原因となったプル要求の数。 この変数は、異なる pull request ID と pull request 番号を持つ GitHub からのプル要求に対して設定されます。 この変数は、PR がブランチ ポリシーの影響を受ける場合にのみ、YAML パイプラインで使用できます。 いいえ
System.PullRequest.SourceBranch pull request でレビューされているブランチ。 例: refs/heads/users/raisa/new-feature Azure Repos。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。 この変数は、PR がブランチ ポリシーの影響を受ける場合にのみ、YAML パイプラインで使用できます。 いいえ
System.PullRequest.SourceRepositoryURI pull request を含むリポジトリの URL。 (例: https://dev.azure.com/ouraccount/_git/OurProject)。 いいえ
System.PullRequest.TargetBranch プル要求のターゲットであるブランチ。 たとえば、refs/heads/mainリポジトリがAzure Reposにある場合と、mainリポジトリが GitHub にある場合です。 この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます。 この変数は、PR がブランチ ポリシーの影響を受ける場合にのみ、YAML パイプラインで使用できます。 いいえ
System.StageAttempt このステージが初めて試行されるときに 1 に設定され、ジョブが再試行されるたびにインクリメントされます。 いいえ
System.StageDisplayName ステージに与えられる人間が判読できる名前。 いいえ
System.StageName ステージの文字列ベースの識別子。通常、依存関係の表現と出力変数へのアクセスに使用されます。 いいえ
System.TeamFoundationCollectionUri TFS コレクションまたは Azure DevOps 組織の URI。 (例: https://dev.azure.com/fabrikamfiber/)。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
はい
System.TeamProject このビルドを含むプロジェクトの名前。 はい
System.TeamProjectId このビルドが属するプロジェクトの ID。 はい
System.TimelineId 1 つのパイプライン実行の実行の詳細とログの文字列ベースの識別子。 いいえ
TF_BUILD Trueスクリプトがビルド タスクによって実行される場合に設定します。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ

変数をチェックします (DevOps Services)

変数説明
Checks.StageAttempt このステージが初めて試行されるときに 1 に設定され、ステージが再試行されるたびにインクリメントされます。

この変数は、 承認または環境のチェック 内でのみ使用できます。 たとえば、REST API の呼び出しチェック内で使用$(Checks.StageAttempt)できます。

Add the stage attempt as a parameter.

エージェント変数 (DevOps Server 2020)

Note

エージェント変数は、スクリプトの環境変数として、およびビルド タスクのパラメーターとして使用できます。 これらを使用してビルド番号をカスタマイズしたり、バージョン 管理ラベルまたはタグを適用したりすることはできません。

変数説明
Agent.BuildDirectory

特定のビルド パイプラインのすべてのフォルダーが作成されるエージェントのローカル パス。 この変数の値 Pipeline.Workspaceは .

例: /home/vsts/work/1

Agent.HomeDirectory エージェントがインストールされているディレクトリ。 これにはエージェント ソフトウェアが含まれます。 (例: c:\agent)。
Agent.Id エージェントの ID。
Agent.JobName 実行中のジョブの名前。 これは通常、"ジョブ" または "__default" になりますが、マルチ構成シナリオでは構成になります。
Agent.JobStatus ビルドの状態。
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (部分的に成功)

環境変数は次のように AGENT_JOBSTATUS参照する必要があります。 以前のバージョン agent.jobstatus は、下位互換性のために使用できます。

Agent.MachineName エージェントがインストールされているコンピューターの名前。
Agent.Name

プールに登録されているエージェントの名前。

セルフホステッド エージェントを使用している場合、この名前はユーザーによって指定されます。 エージェントを参照してください。

Agent.OS エージェント ホストのオペレーティング システム。 有効な値は次のとおりです。
  • Windows_NT
  • Darwin
  • Linux
コンテナーで実行している場合、エージェントのホストとコンテナーが異なるオペレーティング システムを実行している可能性があります。
Agent.OSArchitecture エージェント ホストのオペレーティング システム プロセッサ アーキテクチャ。 有効な値は次のとおりです。
  • X86
  • X64
  • ARM
Agent.TempDirectory

各パイプライン ジョブの後にクリーンアップされる一時フォルダー。 このディレクトリは、 .NET Core CLI タスク などのタスクで使用され、公開前にテスト結果などの一時的な項目を保持します。

例: /home/vsts/work/_temp Ubuntu の場合

Agent.ToolsDirectory Node Tool InstallerPython バージョンを使用して複数のバージョンのツールを切り替えるなどのタスクで使用されるディレクトリ。 これらのタスクは、後続のビルド 手順で使用できるように、このディレクトリ PATH からツールを追加します。

セルフホステッド エージェントでこのディレクトリを管理する方法について説明します。
Agent.WorkFolder このエージェントの作業ディレクトリ。 (例: c:\agent_work)。

注: このディレクトリは、パイプライン タスクによって書き込み可能であるとは限りません (たとえば、コンテナーにマップされている場合)

ビルド変数 (DevOps Server 2020)


変数説明テンプレートで使用できますか?
Build.ArtifactStagingDirectory

成果物がコピー先にプッシュされる前にコピーされるエージェント上のローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行することです

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

Azure Pipelines の成果物に関するページを参照してください。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.BuildId 完了したビルドのレコードの ID。 いいえ
Build.BuildNumber 完了したビルドの名前 。実行番号とも呼ばれます。 この値 に含まれる内容を 指定できます。

この変数の一般的な用途は、 リポジトリ タブで指定したラベル形式の一部にすることです。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。



この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.BuildUri ビルドの URI。 (例: vstfs:///Build/Build/1430)。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.BinariesDirectory コンパイル済みバイナリの出力フォルダーとして使用できるエージェントのローカル パス。

既定では、このディレクトリをクリーンアップするように新しいビルド パイプラインは設定されません。 ビルドを定義して、[ リポジトリ] タブでクリーンアップできます。

(例: c:\agent_work\1\b)。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.ContainerId 成果物のコンテナーの ID。 パイプラインで成果物をアップロードすると、その特定の成果物に固有のコンテナーに追加されます。 いいえ
Build.DefinitionName ビルド パイプラインの名前。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

はい
Build.DefinitionVersion ビルド パイプラインのバージョン。 はい
Build.QueuedBy ID 変数の設定方法」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

はい
Build.QueuedById ID 変数の設定方法」を参照してください。 はい
Build.Reason ビルドの実行の原因となったイベント。
  • Manual: ユーザーがビルドを手動でキューに入れた。
  • IndividualCI: Git プッシュまたは TFVC チェックインによってトリガーされる継続的インテグレーション (CI)。
  • BatchedCI: Git プッシュまたは TFVC チェックインによってトリガーされる 継続的インテグレーション (CI) と、 Batch の変更 が選択されました。
  • Schedule: スケジュールされた トリガー。
  • ValidateShelveset: ユーザーは、特定の TFVC シェルブセットのビルドを手動でキューに入れます。
  • CheckInShelveset: ゲートチェックイン トリガー。
  • PullRequest: ビルドは、ビルドを必要とする Git ブランチ ポリシーによってトリガーされました。
  • ResourceTrigger: ビルドは リソース トリガーによってトリガーされたか別のビルドによってトリガーされました
「ビルド パイプライン トリガー」ブランチ ポリシーを使用したコード品質の向上に関する説明を参照してください。
はい
Build.Repository.Clean ソース リポジトリの設定[クリーン] に選択した値。

この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.LocalPath

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインでは、変更されたファイルのみが更新されます。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

重要な注意: 1 つの Git リポジトリのみをチェックアウトする場合、このパスはコードへの正確なパスになります。 複数のリポジトリをチェックアウトすると、動作は次のようになります (Build.SourcesDirectory 変数の値と異なる場合があります)。

  • セルフ (プライマリ) リポジトリのチェックアウト ステップにカスタム チェックアウト パスが定義されていない場合、またはチェックアウト パスがセルフ リポジトリのマルチチェックアウトの既定のパス $(Pipeline.Workspace)/s/<RepoName> である場合、この変数の値は $(Pipeline.Workspace)/s既定値に戻ります。これは、
  • セルフ (プライマリ) リポジトリのチェックアウト ステップにカスタム チェックアウト パスが定義されていて (マルチチェックアウトの既定のパスではない) 場合、この変数にはセルフ リポジトリへの正確なパスが含まれます。
この変数はエージェント スコープであり、スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.ID リポジトリの一意識別子。

リポジトリの名前が変更されても、これは変更されません。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.Name トリガーする リポジトリの名前。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.Provider トリガーする リポジトリの種類。 この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 いいえ
Build.Repository.Tfvc.Workspace リポジトリがTeam Foundation バージョン管理場合に定義されます。 ビルド エージェントによって使用される TFVC ワークスペース の名前。


たとえば、Agent.BuildDirectory が Agent.Id の c:\agent_work\12 場合、ワークスペース名は 8次のようになります。 ws_12_8

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.Repository.Uri トリガーするリポジトリの URL。 次に例を示します。 この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 いいえ
Build.RequestedFor ID 変数はどのように設定されますか?」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

はい
Build.RequestedForEmail ID 変数はどのように設定されますか?」を参照してください。 はい
Build.RequestedForId ID 変数はどのように設定されますか?」を参照してください。 はい
Build.SourceBranch ビルドがキューに登録されたトリガー リポジトリのブランチ。 次に例をいくつか示します。
  • Git リポジトリ ブランチ: refs/heads/main
  • Git リポジトリの pull request: refs/pull/1/merge
  • TFVC リポジトリ ブランチ: $/teamproject/main
  • TFVC リポジトリゲートチェックイン: Gated_2016-06-06_05.20.51.4369;username@live.com
  • TFVC リポジトリ シェルブセットのビルド: myshelveset;username@live.com
  • パイプラインがタグによってトリガーされる場合: refs/tags/your-tag-name
この変数をビルド番号形式で使用すると、スラッシュ文字 (/) はアンダースコア文字 _に置き換えられます。

注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、またはシェルブセットを手動でビルドする場合、この変数をビルド番号形式で使用することはできません。
はい
Build.SourceBranchName ビルドがキューに登録されたトリガー リポジトリ内のブランチの名前。
  • Git リポジトリのブランチ、pull request、またはタグ: ref 内の最後のパス セグメント。たとえば、この値は refs/heads/mainmain. refs/heads/feature/toolsこの値は tools. refs/tags/your-tag-nameこの値は your-tag-name.
  • TFVC リポジトリ ブランチ: ワークスペースのルート サーバー パス内の最後のパス セグメント。 たとえば、この値は $/teamproject/mainmain.
  • TFVC リポジトリ ゲート チェックインまたはシェルブセット ビルドは、シェルブセットの名前です。 たとえば、Gated_2016-06-06_05.20.51.4369;username@live.com または myshelveset;username@live.com です。
注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、またはシェルブセットを手動でビルドする場合、この変数をビルド番号形式で使用することはできません。
はい
Build.SourcesDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。

重要な注意: 1 つの Git リポジトリのみをチェックアウトする場合、このパスはコードへの正確なパスになります。 複数のリポジトリをチェックアウトすると、既定値に戻ります。つまり $(Pipeline.Workspace)/s、セルフ (プライマリ) リポジトリがマルチチェックアウトの既定のパスとは異なるカスタム パス $(Pipeline.Workspace)/s/<RepoName> にチェックアウトされている場合でも (この点では、変数は Build.Repository.LocalPath 変数の動作とは異なります)。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.SourceVersion このビルドに含まれるトリガー リポジトリの最新バージョン制御の変更。 この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 はい
Build.SourceVersionMessage トリガーするリポジトリのコミットまたは変更セットのコメント。 最初の行または 200 文字のどちらか短い方にメッセージを切り捨てます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。 また、この変数はステップ レベルでのみ使用でき、ジョブ レベルとステージ レベルでは使用できません (つまり、ジョブが開始されてコードをチェックアウトするまでメッセージは抽出されません)。

注: この変数は TFS 2015.4 で使用できます。

いいえ
Build.StagingDirectory

成果物がコピー先にプッシュされる前にコピーされるエージェントのローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行 することです。

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

「Azure Pipelines の成果物」を参照してください。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

いいえ
Build.Repository.Git.SubmoduleCheckout [リポジトリ] タブ[チェックアウト] サブモジュールで選択した値。複数のリポジトリがチェックアウトされている場合、この値はトリガーするリポジトリの設定を追跡します。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.SourceTfvcShelveset リポジトリがTeam Foundation バージョン管理場合に定義されます。


ゲート ビルドまたはシェルブセット ビルドを実行している場合、これはビルドするシェルブセットの名前に設定されます。

注: この変数は、ビルド番号形式でのビルド使用に無効な値を生成します。
いいえ
Build.TriggeredBy.BuildId ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルドの BuildID に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.TriggeredBy.DefinitionId ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルドの DefinitionID に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.TriggeredBy.DefinitionName ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルド パイプラインの名前に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.TriggeredBy.BuildNumber ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルドの数に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Build.TriggeredBy.ProjectID ビルドが別の ビルドによってトリガーされた場合、この変数は、トリガーするビルドを含むプロジェクトの ID に設定されます。 クラシック パイプラインでは、この変数はビルド完了トリガーによってトリガーされます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ
Common.TestResultsDirectory テスト結果が作成されるエージェントのローカル パス。 例: c:\agent_work\1\TestResults

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ

パイプライン変数 (DevOps Server 2020)

変数説明
Pipeline.Workspace 特定のパイプラインのワークスペース ディレクトリ。 この変数の値 Agent.BuildDirectoryは .

たとえば、「 /home/vsts/work/1 」のように入力します。

デプロイ ジョブ変数 (DevOps Server 2020)

これらの変数のスコープは特定の デプロイ ジョブ であり、ジョブの実行時にのみ解決されます。

変数説明
Environment.Name 展開手順を実行し、デプロイ履歴を記録する展開ジョブの対象となる環境の名前。 たとえば、「 smarthotel-dev 」のように入力します。
Environment.Id デプロイ ジョブの対象となる環境の ID。 たとえば、「 10 」のように入力します。
Environment.ResourceName デプロイ ジョブの対象となる環境内の特定のリソースの名前。デプロイ手順を実行し、デプロイ履歴を記録します。 たとえば、 bookings 環境にリソース smarthotel-devとして追加された Kubernetes 名前空間です。
Environment.ResourceId デプロイ 手順を実行するデプロイ ジョブの対象となる環境内の特定のリソースの ID。 たとえば、「 4 」のように入力します。

システム変数 (DevOps Server 2020)

変数説明テンプレートで使用できますか?
System.AccessToken OAuth トークンを使用して REST API にアクセスします

YAML スクリプトから System.AccessToken を使用します

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
はい
System.CollectionId TFS コレクションまたは Azure DevOps 組織の GUID はい
System.CollectionUri Team Foundation Server コレクション URI の文字列。 はい
System.DefaultWorkingDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

いいえ
System.DefinitionId ビルド パイプラインの ID。 はい
System.HostType buildパイプラインがビルドの場合に設定します。 リリースの場合、値は deployment デプロイ グループ ジョブ、 gates ゲートの評価中、およびその release 他の (エージェントおよびエージェントレス) ジョブ用です。 はい
System.JobAttempt このジョブが初めて試行されるときに 1 に設定され、ジョブが再試行されるたびにインクリメントされます。 いいえ
System.JobDisplayName ジョブに与えられた人間が判読できる名前。 いいえ
System.JobId 1 つのジョブの 1 回の試行に対する一意の識別子。 値は現在のパイプラインに固有です。 いいえ
System.JobName 通常、依存関係の表現と出力変数へのアクセスに使用されるジョブの名前。 いいえ
System.PhaseAttempt このフェーズが初めて試行されるときに 1 に設定され、ジョブが再試行されるたびにインクリメントされます。

メモ: "フェーズ" は、ジョブの設計時を表すほぼ冗長な概念です (一方、ジョブはフェーズのランタイム バージョンでした)。 ほとんどの場合、Azure Pipelines から "フェーズ" の概念を削除しました。 マトリックス ジョブとマルチ構成ジョブは、"フェーズ" がまだ "job" とは異なる唯一の場所です。 1 つのフェーズで、入力のみが異なる複数のジョブをインスタンス化できます。
いいえ
System.PhaseDisplayName フェーズに与えられる人間が判読できる名前。 いいえ
System.PhaseName ジョブの文字列ベースの識別子。通常、依存関係を表し、出力変数にアクセスするために使用されます。 いいえ
System.StageAttempt このステージが初めて試行されるときに 1 に設定され、ジョブが再試行されるたびにインクリメントされます。 いいえ
System.StageDisplayName ステージに与えられる人間が判読できる名前。 いいえ
System.StageName ステージの文字列ベースの識別子。通常、依存関係の表現と出力変数へのアクセスに使用されます。 はい
System.PullRequest.IsFork プル要求がリポジトリのフォークからの場合、この変数は True. それ以外の場合は、次に False設定されます。 はい
System.PullRequest.PullRequestId このビルドの原因となったプル要求の ID。 (例: 17)。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。 いいえ
System.PullRequest.PullRequestNumber このビルドの原因となったプル要求の数。 この変数は、異なる pull request ID と pull request 番号を持つ GitHub からのプル要求に対して設定されます。 この変数は、PR がブランチ ポリシーの影響を受ける場合にのみ、YAML パイプラインで使用できます。 いいえ
System.PullRequest.SourceBranch pull request でレビューされているブランチ。 (例: refs/heads/users/raisa/new-feature)。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。 この変数は、PR がブランチ ポリシーの影響を受ける場合にのみ、YAML パイプラインで使用できます。 いいえ
System.PullRequest.SourceRepositoryURI pull request を含むリポジトリの URL。 (例: https://dev.azure.com/ouraccount/_git/OurProject)。 いいえ
System.PullRequest.TargetBranch プル要求のターゲットであるブランチ。 たとえば、refs/heads/mainリポジトリがAzure Reposにある場合と、mainリポジトリが GitHub にある場合です。 この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます。 この変数は、PR がブランチ ポリシーの影響を受ける場合にのみ、YAML パイプラインで使用できます。 いいえ
System.TeamFoundationCollectionUri チーム基盤コレクションの URI。 例: https://dev.azure.com/fabrikamfiber/

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
はい
System.TeamProject このビルドを含むプロジェクトの名前。 はい
System.TeamProjectId このビルドが属するプロジェクトの ID。 はい
TF_BUILD Trueスクリプトがビルド タスクによって実行される場合に設定します。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
いいえ

エージェント変数 (2019 DevOps Server)

Note

エージェント変数は、スクリプトの環境変数として、およびビルド タスクのパラメーターとして使用できます。 これらを使用してビルド番号をカスタマイズしたり、バージョン 管理ラベルまたはタグを適用したりすることはできません。

変数説明
Agent.BuildDirectory

特定のビルド パイプラインのすべてのフォルダーが作成されるエージェントのローカル パス。

例: c:\agent_work\1

Agent.HomeDirectory エージェントがインストールされているディレクトリ。 これにはエージェント ソフトウェアが含まれます。 (例: c:\agent)。
Agent.Id エージェントの ID。
Agent.JobName 実行中のジョブの名前。 これは通常、"ジョブ" または "__default" になりますが、マルチ構成シナリオでは構成になります。
Agent.JobStatus ビルドの状態。
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (部分的に成功)

環境変数は次のように AGENT_JOBSTATUS参照する必要があります。 以前のバージョン agent.jobstatus は、下位互換性のために使用できます。

Agent.MachineName エージェントがインストールされているコンピューターの名前。
Agent.Name

プールに登録されているエージェントの名前。

セルフホステッド エージェントを使用している場合、この名前はユーザーによって指定されます。 エージェントを参照してください。

Agent.OS エージェント ホストのオペレーティング システム。 有効な値は次のとおりです。
  • Windows_NT
  • Darwin
  • Linux
コンテナーで実行している場合は、エージェントホストとコンテナーが異なるオペレーティング システムを実行している可能性があります。
Agent.OSArchitecture エージェント ホストのオペレーティング システム プロセッサ アーキテクチャ。 有効な値は次のとおりです。
  • X86
  • X64
  • ARM
Agent.TempDirectory 各パイプライン ジョブの後にクリーンアップされる一時フォルダー。 このディレクトリは、 .NET Core CLI タスク などのタスクで使用され、公開前にテスト結果などの一時的な項目を保持します。
Agent.ToolsDirectory Node Tool InstallerPython バージョンを使用して複数のバージョンのツールを切り替えるなどのタスクで使用されるディレクトリ。 これらのタスクは、後続のビルド 手順で使用できるように、このディレクトリ PATH からツールを追加します。

セルフホステッド エージェントでこのディレクトリを管理する方法について説明します。
Agent.WorkFolder このエージェントの作業ディレクトリ。 (例: c:\agent_work)。

このディレクトリは、パイプライン タスク (コンテナーにマップされている場合など) によって書き込み可能であるとは限りません。

ビルド変数 (DevOps Server 2019)


変数説明
Build.ArtifactStagingDirectory

成果物がコピー先にプッシュされる前にコピーされるエージェント上のローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行することです

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

Azure Pipelines の成果物に関するページを参照してください。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

Build.BuildId 完了したビルドのレコードの ID。
Build.BuildNumber 完成したビルドの名前。 パイプライン オプションで、この値を生成するビルド番号の形式を指定できます。

この変数の一般的な用途は、 リポジトリ タブで指定したラベル形式の一部にすることです。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。



この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

Build.BuildUri ビルドの URI。 (例: vstfs:///Build/Build/1430)。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
Build.BinariesDirectory コンパイル済みバイナリの出力フォルダーとして使用できるエージェントのローカル パス。

既定では、このディレクトリをクリーンアップするように新しいビルド パイプラインは設定されません。 ビルドを定義して、[ リポジトリ] タブでクリーンアップできます。

(例: c:\agent_work\1\b)。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
Build.DefinitionName ビルド パイプラインの名前。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

Build.DefinitionVersion ビルド パイプラインのバージョン。
Build.QueuedBy ID 変数の設定方法」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

Build.QueuedById ID 変数の設定方法」を参照してください。
Build.Reason ビルドの実行の原因となったイベント。
  • Manual: ユーザーがビルドを手動でキューに入れた。
  • IndividualCI: Git プッシュまたは TFVC チェックインによってトリガーされる継続的インテグレーション (CI)。
  • BatchedCI: Git プッシュまたは TFVC チェックインによってトリガーされる 継続的インテグレーション (CI) と、 Batch の変更 が選択されました。
  • Schedule: スケジュールされた トリガー。
  • ValidateShelveset: ユーザーは、特定の TFVC シェルブセットのビルドを手動でキューに入れます。
  • CheckInShelveset: ゲートチェックイン トリガー。
  • PullRequest: ビルドは、ビルドを必要とする Git ブランチ ポリシーによってトリガーされました。
  • BuildCompletion: ビルドは 別のビルドによってトリガーされました
「ビルド パイプライン トリガー」ブランチ ポリシーを使用したコード品質の向上に関する説明を参照してください。
Build.Repository.Clean ソース リポジトリの設定[クリーン] に選択した値。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
Build.Repository.LocalPath

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインでは、変更されたファイルのみが更新されます。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

この変数は、Build.SourcesDirectory と同義です。

Build.Repository.Name リポジトリの名前。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。
Build.Repository.Provider 選択したリポジトリの種類。 この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.Repository.Tfvc.Workspace リポジトリがTeam Foundation バージョン管理場合に定義されます。 ビルド エージェントによって使用される TFVC ワークスペース の名前。


たとえば、Agent.BuildDirectory が Agent.Id の c:\agent_work\12 場合、ワークスペース名は 8次のようになります。 ws_12_8

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.Repository.Uri リポジトリの URL。 次に例を示します。 この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.RequestedFor ID 変数はどのように設定されますか?」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

Build.RequestedForEmail ID 変数はどのように設定されますか?」を参照してください。
Build.RequestedForId ID 変数はどのように設定されますか?」を参照してください。
Build.SourceBranch ビルドがキューに登録されたブランチ。 次に例をいくつか示します。
  • Git リポジトリ ブランチ: refs/heads/main
  • Git リポジトリの pull request: refs/pull/1/merge
  • TFVC リポジトリ ブランチ: $/teamproject/main
  • TFVC リポジトリゲートチェックイン: Gated_2016-06-06_05.20.51.4369;username@live.com
  • TFVC リポジトリ シェルブセットのビルド: myshelveset;username@live.com
この変数をビルド番号形式で使用すると、スラッシュ文字 (/) はアンダースコア文字 _に置き換えられます。

注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、またはシェルブセットを手動でビルドする場合、この変数をビルド番号形式で使用することはできません。
Build.SourceBranchName ビルドがキューに登録されたブランチの名前。
  • Git リポジトリのブランチ、pull request、またはタグ: ref 内の最後のパス セグメント。たとえば、この値は refs/heads/mainmain. refs/heads/feature/toolsこの値は tools. refs/tags/your-tag-nameこの値は your-tag-name.
  • TFVC リポジトリ ブランチ: ワークスペースのルート サーバー パス内の最後のパス セグメント。 たとえば、この値は $/teamproject/mainmain.
  • TFVC リポジトリ ゲート チェックインまたはシェルブセット ビルドは、シェルブセットの名前です。 たとえば、Gated_2016-06-06_05.20.51.4369;username@live.com または myshelveset;username@live.com です。
注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、またはシェルブセットを手動でビルドする場合、この変数をビルド番号形式で使用することはできません。
Build.SourcesDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

この変数は Build.Repository.LocalPath と同義です。

Build.SourceVersion このビルドに含まれる最新バージョン管理の変更。 この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.SourceVersionMessage コミットまたは変更セットのコメント。 最初の行または 200 文字のどちらか短い方にメッセージを切り捨てます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

注: この変数は TFS 2015.4 で使用できます。

Build.StagingDirectory

成果物がコピー先にプッシュされる前にコピーされるエージェントのローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行 することです。

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

「Azure Pipelines の成果物」を参照してください。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

Build.Repository.Git.SubmoduleCheckout [リポジトリ] タブ[チェックアウト] サブモジュールで選択した値。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.SourceTfvcShelveset リポジトリがTeam Foundation バージョン管理場合に定義されます。


ゲート ビルドまたはシェルブセット ビルドを実行している場合、これはビルドするシェルブセットの名前に設定されます。

注: この変数は、ビルド番号形式でのビルド使用に無効な値を生成します。
Build.TriggeredBy.BuildId ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルドの BuildID に設定されます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.TriggeredBy.DefinitionId ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルドの DefinitionID に設定されます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.TriggeredBy.DefinitionName ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルド パイプラインの名前に設定されます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.TriggeredBy.BuildNumber ビルドが別の ビルドによってトリガーされた場合、この変数はトリガーするビルドの数に設定されます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.TriggeredBy.ProjectID ビルドが別の ビルドによってトリガーされた場合、この変数は、トリガーするビルドを含むプロジェクトの ID に設定されます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Common.TestResultsDirectory テスト結果が作成されるエージェントのローカル パス。 例: c:\agent_work\1\TestResults

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

システム変数 (DevOps Server 2019)

変数説明
System.AccessToken OAuth トークンを使用して REST API にアクセスします

YAML スクリプトから System.AccessToken を使用します

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
System.CollectionId TFS コレクションまたは Azure DevOps 組織の GUID
System.DefaultWorkingDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

System.DefinitionId ビルド パイプラインの ID。
System.HostType buildパイプラインがビルドの場合に設定します。 リリースの場合、値は deployment デプロイ グループ ジョブと release エージェント ジョブ用です。
System.PullRequest.IsFork プル要求がリポジトリのフォークからの場合、この変数は True. それ以外の場合は、次に False設定されます。
System.PullRequest.PullRequestId このビルドの原因となったプル要求の ID。 (例: 17)。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。
System.PullRequest.PullRequestNumber このビルドの原因となったプル要求の数。 この変数は、異なる pull request ID と pull request 番号を持つ GitHub からのプル要求に対して設定されます。
System.PullRequest.SourceBranch pull request でレビューされているブランチ。 (例: refs/heads/users/raisa/new-feature)。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。
System.PullRequest.SourceRepositoryURI pull request を含むリポジトリの URL。 (例: https://dev.azure.com/ouraccount/_git/OurProject)。 (この変数は、ブランチ ポリシーの影響を受ける Azure Repos Git PR が原因でビルドが実行された場合にのみ初期化されます。GitHub PR 用に初期化されていません。)
System.PullRequest.TargetBranch プル要求のターゲットであるブランチ。 (例: refs/heads/main)。 この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます。
System.TeamFoundationCollectionUri チーム基盤コレクションの URI。 (例: https://dev.azure.com/fabrikamfiber/)。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
System.TeamProject このビルドを含むプロジェクトの名前。
System.TeamProjectId このビルドが属するプロジェクトの ID。
TF_BUILD Trueスクリプトがビルド タスクによって実行される場合に設定します。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

エージェント変数 (TFS 2018)

Note

エージェント変数は、スクリプトの環境変数として、およびビルド タスクのパラメーターとして使用できます。 これらを使用してビルド番号をカスタマイズしたり、バージョン 管理ラベルまたはタグを適用したりすることはできません。

変数説明
Agent.BuildDirectory

特定のビルド パイプラインのすべてのフォルダーが作成されるエージェントのローカル パス。

例: c:\agent_work\1

Agent.HomeDirectory エージェントがインストールされているディレクトリ。 これにはエージェント ソフトウェアが含まれます。 (例: c:\agent)。
Agent.Id エージェントの ID。
Agent.JobStatus ビルドの状態。
  • Canceled
  • Failed
  • Succeeded
  • SucceededWithIssues (部分的に成功)

環境変数は次のように AGENT_JOBSTATUS参照する必要があります。 以前のバージョン agent.jobstatus は、下位互換性のために使用できます。

Agent.MachineName エージェントがインストールされているコンピューターの名前。
Agent.Name

プールに登録されているエージェントの名前。

この名前はユーザーが指定します。 エージェントを参照してください。

Agent.TempDirectory 各パイプライン ジョブの後にクリーンアップされる一時フォルダー。 このディレクトリは、発行前にテスト結果などの一時的な項目を保持するために 、.NET Core CLI タスクなどのタスク で使用されます。
Agent.ToolsDirectory Node Tool InstallerPython バージョンを使用して複数のバージョンのツールを切り替えるなどのタスクで使用されるディレクトリ。 これらのタスクは、後続のビルド手順で使用できるように、このディレクトリ PATH からツールを追加します。

セルフホステッド エージェントでこのディレクトリを管理する方法について説明します。
Agent.WorkFolder このエージェントの作業ディレクトリ。 (例: c:\agent_work)。

ビルド変数 (TFS 2018)


変数説明
Build.ArtifactStagingDirectory 成果物がコピー先にプッシュされる前にコピーされるエージェントのローカル パス。

成果物がコピー先にプッシュされる前にコピーされるエージェントのローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行 することです。

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

「Azure Pipelines の成果物」を参照してください。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

Build.BuildId 完了したビルドのレコードの ID。
Build.BuildNumber 完了したビルドの名前。 パイプライン オプションで、この値を生成するビルド番号の形式を指定できます。

この変数の一般的な用途は、 リポジトリ タブで指定したラベル形式の一部にすることです。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。



この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、バージョン管理タグとして使用することはできません。

Build.BuildUri ビルドの URI。 (例: vstfs:///Build/Build/1430)。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.BinariesDirectory コンパイル済みバイナリの出力フォルダーとして使用できるエージェントのローカル パス。

既定では、このディレクトリをクリーンアップするように新しいビルド パイプラインは設定されません。 ビルドを定義して、[ リポジトリ] タブでクリーンアップできます。

(例: c:\agent_work\1\b)。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.DefinitionName ビルド パイプラインの名前。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

Build.DefinitionVersion ビルド パイプラインのバージョン。
Build.QueuedBy ID 変数はどのように設定されますか?」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

Build.QueuedById ID 変数はどのように設定されますか?」を参照してください。
Build.Reason ビルドの実行の原因となったイベント。
  • Manual: ユーザーが UI または API 呼び出しからビルドを手動でキューに入れた。
  • IndividualCI: Git プッシュまたは TFVC チェックインによってトリガーされる継続的インテグレーション (CI)。
  • BatchedCI: Git プッシュまたは TFVC チェックインによってトリガーされ、Batch の変更が選択された継続的インテグレーション (CI)。
  • Schedule: スケジュールされた トリガー。
  • ValidateShelveset: ユーザーが特定の TFVC シェルブセットのビルドを手動でキューに入れた。
  • CheckInShelveset: ゲート チェックイン トリガー。
  • PullRequest: ビルドは、ビルドを必要とする Git ブランチ ポリシーによってトリガーされました。
ビルド パイプライン トリガー」「ブランチ ポリシーを使用してコード品質を向上させる」を参照してください。
Build.Repository.Clean ソース リポジトリの設定[クリーン] に選択した値。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.Repository.LocalPath

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

この変数は Build.SourcesDirectory と同義です。

Build.Repository.Name リポジトリの名前。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.Repository.Provider 選択したリポジトリの種類。 この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.Repository.Tfvc.Workspace リポジトリがTeam Foundation バージョン管理場合に定義されます。 ビルド エージェントによって使用される TFVC ワークスペース の名前。

たとえば、Agent.BuildDirectory が Agent.Id の c:\agent_work\12 場合、ワークスペース名は 8次のようになります。 ws_12_8

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.Repository.Uri リポジトリの URL。 次に例を示します。
  • Git: https://fabrikamfiber/tfs/DefaultCollection/Scripts/_git/Scripts
  • Tfvc: https://fabrikamfiber/tfs/DefaultCollection/
この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.RequestedFor ID 変数はどのように設定されますか?」を参照してください。

注: この値には、空白文字またはその他の無効なラベル文字を含めることができます。 このような場合、 ラベルの形式 は失敗します。

Build.RequestedForEmail ID 変数はどのように設定されますか?」を参照してください。
Build.RequestedForId ID 変数はどのように設定されますか?」を参照してください。
Build.SourceBranch ビルドがキューに登録されたブランチ。 次に例をいくつか示します。
  • Git リポジトリ ブランチ: refs/heads/main
  • Git リポジトリの pull request: refs/pull/1/merge
  • TFVC リポジトリ ブランチ: $/teamproject/main
  • TFVC リポジトリゲートチェックイン: Gated_2016-06-06_05.20.51.4369;username@live.com
  • TFVC リポジトリ シェルブセットのビルド: myshelveset;username@live.com
この変数をビルド番号形式で使用すると、スラッシュ文字 (/) はアンダースコア文字 _に置き換えられます。

注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、またはシェルブセットを手動でビルドする場合、この変数をビルド番号形式で使用することはできません。
Build.SourceBranchName ビルドがキューに登録されたブランチの名前。
  • Git リポジトリのブランチ、pull request、またはタグ: ref 内の最後のパス セグメント。たとえば、この値は refs/heads/mainmain. refs/heads/feature/toolsこの値は tools.
  • TFVC リポジトリ ブランチ: ワークスペースのルート サーバー パス内の最後のパス セグメント。 たとえば、この値は $/teamproject/mainmain. refs/tags/your-tag-nameこの値は your-tag-name.
  • TFVC リポジトリ ゲート チェックインまたはシェルブセット ビルドは、シェルブセットの名前です。 たとえば、Gated_2016-06-06_05.20.51.4369;username@live.com または myshelveset;username@live.com です。
注: TFVC では、ゲート・チェックイン・ビルドを実行している場合、またはシェルブセットを手動でビルドする場合、この変数をビルド番号形式で使用することはできません。
Build.SourcesDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

この変数は Build.Repository.LocalPath と同義です。

Build.SourceVersion このビルドに含まれる最新バージョン管理の変更。 この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.SourceVersionMessage コミットまたは変更セットのコメント。 最初の行または 200 文字のどちらか短い方にメッセージを切り捨てます。

この変数はエージェント スコープであり、スクリプトの環境変数およびビルド タスクのパラメーターとして使用できますが、ビルド番号の一部またはバージョン管理タグとして使用することはできません。

注: この変数は TFS 2015.4 で使用できます。

Build.StagingDirectory

成果物がコピー先にプッシュされる前にコピーされるエージェントのローカル パス。 例: c:\agent_work\1\a

このフォルダーを使用する一般的な方法は、ファイルの コピー タスクとビルド成果物の発行タスクを使用して ビルド成果物を発行 することです。

注: Build.ArtifactStagingDirectory と Build.StagingDirectory は交換可能です。 このディレクトリは新しいビルドの前に消去されるため、自分でクリーンアップする必要はありません。

「Azure Pipelines の成果物」を参照してください。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

Build.Repository.Git.SubmoduleCheckout [リポジトリ] タブ[チェックアウト] サブモジュールで選択した値。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
Build.SourceTfvcShelveset リポジトリがTeam Foundation バージョン管理場合に定義されます。

ゲート ビルドまたはシェルブセット ビルドを実行している場合、これはビルドするシェルブセットの名前に設定されます。

注: この変数は、ビルド番号形式でのビルド使用に無効な値を生成します。
Common.TestResultsDirectory テスト結果が作成されるエージェントのローカル パス。 例: c:\agent_work\1\TestResults

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

システム変数 (TFS 2018)

変数説明
System.AccessToken OAuth トークンを使用して REST API にアクセスします

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
System.CollectionId TFS コレクションまたは Azure DevOps 組織の GUID
System.DefaultWorkingDirectory

ソース コード ファイルがダウンロードされるエージェントのローカル パス。 例: c:\agent_work\1\s

既定では、新しいビルド パイプラインは変更されたファイルのみを更新します。 [ リポジトリ] タブでファイルのダウンロード方法を変更できます。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

System.DefinitionId ビルド パイプラインの ID。
System.HostType buildパイプラインがビルドの場合、またはreleaseパイプラインがリリースの場合に設定します。
System.PullRequest.IsFork プル要求がリポジトリのフォークからの場合、この変数は True. それ以外の場合は、次に False設定されます。 TFS 2018.2 で使用できます。
System.PullRequest.PullRequestId このビルドの原因となったプル要求の ID。 (例: 17)。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。
System.PullRequest.SourceBranch pull request でレビューされているブランチ。 (例: refs/heads/users/raisa/new-feature)。 (この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます)。
System.PullRequest.SourceRepositoryURI pull request を含むリポジトリの URL。 (例: http://our-server:8080/tfs/DefaultCollection/_git/OurProject)。 (この変数は、ブランチ ポリシーの影響を受ける Azure Repos Git PR が原因でビルドが実行された場合にのみ初期化されます)。
System.PullRequest.TargetBranch プル要求のターゲットであるブランチ。 (例: refs/heads/main)。 この変数は、 ブランチ ポリシーの影響を受ける Git PR が原因でビルドが実行された場合にのみ初期化されます。
System.TeamFoundationCollectionUri チーム基盤コレクションの URI。 (例: http://our-server:8080/tfs/DefaultCollection/)。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。
System.TeamProject このビルドを含むプロジェクトの名前。
System.TeamProjectId このビルドが属するプロジェクトの ID。
TF_BUILD Trueスクリプトがビルド タスクによって実行される場合に設定します。

この変数はエージェント スコープです。 スクリプトの環境変数として、ビルド タスクのパラメーターとして使用できますが、ビルド番号の一部として、またはバージョン管理タグとして使用することはできません。

ID 変数はどのように設定されますか?

値はビルドの原因によって異なり、Azure Reposリポジトリに固有です。

ビルドがトリガーされた場合... 次に、Build.QueuedBy と Build.QueuedById の値が基になります... 次に、Build.RequestedFor と Build.RequestedForId の値が基になります...
継続的インテグレーション (CI) トリガーによる Git または TFVC システム ID。次に例を示します。 [DefaultCollection]\Project Collection Service Accounts 変更をプッシュまたはチェックインしたユーザー。
Git または ブランチ ポリシー ビルド システム ID。次に例を示します。 [DefaultCollection]\Project Collection Service Accounts 変更をチェックインしたユーザー。
ゲート チェックイン トリガーによる TFVC の場合 変更をチェックインしたユーザー。 変更をチェックインしたユーザー。
スケジュールされたトリガーによる Git または TFVC の場合 システム ID。次に例を示します。 [DefaultCollection]\Project Collection Service Accounts システム ID。次に例を示します。 [DefaultCollection]\Project Collection Service Accounts
[キューのビルド] ボタンをクリックしたため 自分 自分