事前定義されたビルドパラメーターのリスト

定義済みサーバービルドパラメーター

これらのパラメーターは、特定のビルド (ビルド番号など) の範囲内でサーバー側で生成されます。

サーバーのビルドパラメーターは通常、システムプロパティおよび対応する環境変数として利用できます。

system.teamcity.version   |   env.TEAMCITY_VERSION

TeamCity サーバーのバージョンです。 このプロパティを使用して、ビルドが TeamCity 内で実行されているかどうかを判定できます。

system.teamcity.projectName   |   env.TEAMCITY_PROJECT_NAME

現在のビルドが属するプロジェクトのお名前です。

system.teamcity.buildConfName   |   env.TEAMCITY_BUILDCONF_NAME

現在のビルドが属するビルド構成のお名前です。

system.teamcity.buildType.id

TeamCity が現在のビルドが属するビルド構成を参照するために使用する 一意の IDです。

system.teamcity.configuration.properties.file

すべてのビルドパラメーターをアルファベット順に含むファイルの完全なお名前 (パスを含む) です。 このファイルはビルドプロセスの開始時に書き込まれ、 Java Properties File フォーマットを使用します (たとえば、特殊文字はバックスラッシュでエスケープされます)。 関連項目: build.properties.file

system.build.is.personal   |   env.BUILD_IS_PERSONAL

真 を 個人用ビルドに対して返します。 通常のビルドでは未定義です (存在しません)。

system.build.number   |   env.BUILD_NUMBER

TeamCity によってビルドに割り当てられたビルド番号です。 このパラメーターは特別な ビルド番号フォーマットを使用します。

env.ビルド_URL

現在のビルドへのリンクです。

system.teamcity.build.id

TeamCity がビルドを参照するために使用する内部の一意の ID です。

teamcity.ビルド.担当ノード.id

マルチノードセットアップでは、このパラメーターは関連付けられているノードを返します。 ログ REST API リクエストを /アプリ/rest/ビルドs/id:build_id/log エンドポイントに送信するときに、 X-TeamCity-ノード-Id-Cookie Cookie に割り当てることができます。

system.teamcity.auth.userId

他のビルド構成の アーティファクトをダウンロードするために使用できる、生成されたユーザー名です。 ビルド中にのみ有効です。 詳細については、このセクションを参照してください: ビルドレベル認証。

system.teamcity.auth.password

他のビルド構成の アーティファクトをダウンロードするために使用できる、生成されたパスワードです。 ビルド中にのみ有効です。 詳細については、このセクションを参照してください: ビルドレベル認証。

system.build.vcs.number.<VCS_root_ID>   |   env.BUILD_VCS_NUMBER_<VCS_root_ID>

指定されたルートのビルドに含まれる最新の VCS リビジョンです。 VCS ルート ID の詳細については、次の記事を参照してください: VCS ルートの構成。

ビルド構成に単一の VCS ルートのみがある場合は、ルート ID 識別子なしで build.vcs.number パラメーターを使用できます。

この値は VCS 固有のものです。 たとえば、SVN のリビジョン番号や CVS のタイムスタンプです。

定義済みエージェントビルドパラメーター

これらの システムプロパティはビルドごとに一意です (変更のリストを含むファイルへのパスなど)。 その値は、ビルドの開始直前にエージェント側で計算され、ビルドに渡されます。

system.teamcity.build.checkoutDir

ビルドに使用される チェックアウトディレクトリです。

system.teamcity.build.workingDir

ビルドが開始される 作業ディレクトリです。 TeamCity ビルドランナーがプロセスを開始することになっているパスです。 これはランナー固有のプロパティであるため、ステップごとに異なる値になります。

system.teamcity.build.tempDir

TeamCity によって生成されるビルド一時ディレクトリのフルパスです。 ディレクトリはビルド後にクリーンアップされます。

system.teamcity.build.changedFiles.file

ビルドに含まれる変更ファイルに関する情報を含むファイルへのフルパスです。 このプロパティを使用して、テスト用のカスタムランナーで リスクテストの並べ替えをサポートできます。

このファイルは、 履歴ビルドの場合、およびこの特定のビルドに変更がなかった場合は使用できません。

system.teamcity.build.properties.file   |   env.TEAMCITY_BUILD_PROPERTIES_FILE

すべてのビルドシステムプロパティを system. 接尾辞なしで含むファイルの完全なお名前 (パスを含む) です。 このファイルはビルドプロセスの開始時に書き込まれ、 Java Properties File フォーマットを使用します (たとえば、特殊文字はバックスラッシュでエスケープされます)。

定義済みエージェント環境パラメーター

これらのエージェント固有のパラメーターは、各ビルドエージェントで定義され、環境によって異なります。 標準パラメーター (エージェントで実行されている JVM によって提供される teamcity.agent.jvm.os.name または teamcity.agent.jvm.os.arch など) とは別に、エージェントにはインストールされているソフトウェアに基づいたパラメーターを設定できます。 TeamCity は、.NET Framework、Mono、Visual Studio などのソフトウェアを自動的に検出し、対応する システムプロパティと 環境変数を追加します。

エージェントマシンに追加のソフトウェアがインストールされている場合、システム管理者は <エージェントホーム>/conf/buildAgent.properties ファイルを変更して、対応するパラメーターの値をオーバーライドできます。

エージェント環境パラメーターは、ビルド構成オプションの設定、 エージェント要件の定義、および ビルドスクリプト内で使用できます。

特定のビルドエージェントの既存のすべてのパラメーターとその現在の値を確認するには、エージェントの詳細ページを開いて、 パラメーター タブに切り替えます。 詳細については、リンク パラメーター値を追跡する を参照してください。

teamcity.agent.name

ビルドエージェント.プロパティ エージェント構成ファイルで指定されたエージェントのお名前です。 エージェントのお名前を使用して エージェント要件を指定し、ターゲット構成で使用できるエージェント数を制限できます。

teamcity.エージェント.作業.ディレクトリ

エージェント作業ディレクトリへのパスです。

teamcity.agent.work.dir.空き容量 MB

エージェント作業ディレクトリで使用可能な空き容量です。

teamcity.agent.home.dir

エージェントホームディレクトリへのパス

teamcity.agent.tools.dir

エージェント上の ツールディレクトリへのパスです。

teamcity.agent.jvm.os.version

オペレーティングシステムのバージョンです。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.user.country

ユーザーの国です。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.user.home

ユーザーのホームディレクトリです。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.user.timezone

ユーザーのタイムゾーンです。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.user.name

ユーザーのアカウントのお名前です。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.user.language

ユーザーのプライマリ OS 言語です。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.user.variant

ユーザーロケールのバリエーションを示すために使用される任意の値です。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.file.encoding

デフォルトの文字セットのお名前です。デフォルトは UTF-8 です。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.file.separator

ファイル区切り文字です。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.path.separator

パス区切り文字です。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.specification

Java ランタイム環境仕様のバージョンです。 java.specification.version JVM プロパティの値を返します。

teamcity.agent.jvm.version

Java 仮想マシン実装のバージョンです。 対応する JVM プロパティの値を報告します。

teamcity.agent.jvm.java.home

Java インストールディレクトリです。 詳細については、次のセクションを参照してください: Java 関連の環境変数。

teamcity.agent.os.arch.bits

エージェントの OS ビット数です。

TeamCity エージェントの一時性

"最初のビルド後" の終了条件が有効化されているクラウドエージェントに対して true を返します。 複数のビルドを実行できるエージェントでは報告されません。

DotNetCLI

.NET CLI バージョン。

DotNetCLI_Path

.NET CLI 実行可能ファイルへのパス。

DotNetFramework<バージョン>[_x86|_x64]

対応するバージョン(複数可)の .NET Framework ランタイムがインストールされている場合にのみ定義されます。

DotNetFramework<バージョン>[_x86|_x64]_パス

このパラメーターの値は、対応するフレームワークランタイムのバージョン(複数可)のパス(複数可)に設定されます。

このパラメーターは、各メジャーリリースでインストール済みの最新バージョンに対してのみ定義されることに注意してください。 たとえば、バージョン 3.5、4.5、4.8 がインストールされている場合、このパラメーターは 3.5 と 4.8 に対してのみ定義されます。 より新しいバージョンの .NET Framework 4 が存在するため、バージョン/パラメーター 4.5 は省略されます。 そのようなバージョンを明示的に定義するには、代わりに DotNetFrameworkTargetingPack<バージョン>_Path パラメーターの使用を検討してください。

DotNetFrameworkSDK<バージョン>[_x86|_x64]

対応するバージョン(複数可)の .NET Framework SDK がインストールされている場合に定義されます。

DotNetFrameworkSDK<バージョン>[_x86|_x64]_パス

対応するフレームワーク SDK バージョンへのパス。

DotNetFrameworkTargetingPack<バージョン>_Path

対応する参照アセンブリ (別名 Targeting Pack) の場所へのパス。

DotNetCoreSDKx.x_パス

.NET SDK バージョン。

DotNetWorkloads_<バージョン>

エージェントマシンにインストールされているすべての .NET ワークロード を一覧表示します。

<バージョン> サフィックスは、インストール済み .NET SDK のバージョンです。 たとえば、バージョン 7.0.300 がインストールされている場合、エージェントは `DotNetWorkloads_7.0.300` パラメーターを報告します。

これらの完全な SDK バージョンに加えて、エージェントは短縮された メジャー.マイナー サフィックスを持つワークロードパラメーターを報告します。 たとえば、エージェントマシンに 7.0.100、7.0.200、7.0.300 の .NET SDK がインストールされている場合、最上位の 7.0.300 バージョンを参照する DotNetWorkloads_7.0 パラメーターが報告されます。

パラメーター値は、 <dotnet_dir>/metadata/workloads/<sdk_version>/InstalledWorkloads ディレクトリ内のフォルダーに基づく、カンマ区切りのワークロード名の文字列です。 たとえば、"android,maui-ios,wasm-tools" です。

WindowsSDK<バージョン>

対応するバージョンの Windows SDK がインストールされている場合にのみ定義されます。

WindowsSDK<バージョン>_パス

対応するバージョンの Windows SDK のパス。

VS<バージョン>

対応するバージョン(複数可)の Visual Studio がインストールされている場合に定義されます

VS<バージョン>_パス

Visual Studio インストールフォルダー (devenv.exe を含むディレクトリ) へのパス。

teamcity.dotnet.nunitlauncher<バージョン>

スタンドアロンの NUnit テストランチャー NUnitLauncher.exe を含むディレクトリへのパス。 バージョン番号は、テストが実行される .NET Framework のバージョンを指します。 バージョンは .NET Framework のバージョンと等しくなります。

teamcity.dotnet.nunitlauncher.msbuild.task

MSBuild、Visual Studio (sln) 用の NUnit タスクを提供する MSBuild タスク dll を含むディレクトリへのパス。

teamcity.dotnet.msbuild.extensions2.0

MSBuild 2.0 リスナーとタスクアセンブリを含むディレクトリへのパス。

teamcity.dotnet.msbuild.extensions4.0

MSBuild 4.0 リスナーとタスクアセンブリを含むディレクトリへのパス。

teamcity.agent.ownPort

TeamCity サーバーがエージェントに接続するために使用する エージェントポートです。

teamcity.agent.protocol

エージェントとサーバー間のデータ転送に使用される プロトコルです。

teamcity.agent.cpuBenchmark

エージェントの CPU ベンチマーク結果です。

teamcity.agent.hardware.cpuCount

エージェントマシンの CPU のコア/スレッド数です。

teamcity.agent.hostname

ビルドエージェントホストのお名前です。

定義済み構成パラメーター

構成パラメーターは他のパラメーターから参照できますが（パラメーター ページで定義されている場合のみ）、ビルドには渡されません。

これらのサーバーパラメーターの完全なリストを表示するには、任意のビルドの パラメータータブを開くか、内部の teamcity/properties/build.start.properties.gz アーティファクトをダウンロードします。