TeamCity On-Premises 2026.2 Help

要件条件

このページでは、エージェント要件または ビルドステップ実行要件で使用される条件について説明します。

条件

説明と例

存在する

指定されたプロパティが存在する場合、 を返します。

例:

exists("DotNetCLI_Path")

存在しません

指定されたプロパティが存在しない場合は、 を返します。

例:

doesNotExist("env.TEAMCITY_GIT_PATH")

等しい

指定されたプロパティが存在し、指定された値と等しい場合、 を返します。

フィールドを空のままにして、指定されたプロパティが存在するが空であるかどうかを確認できます。

例:

equals("docker.server.osType", "Linux")

等しくない

指定されたプロパティの値が指定された値と異なる場合、またはこのプロパティが存在しない場合は、 を返します。

フィールドを空のままにして、指定されたプロパティが存在し、空ではない (値がある) かどうかを確認できます。

例:

doesNotEqual("system.teamcity.buildType.id", "Tests")

以下

対象の数値プロパティの値が対応する条件を満たす場合、 を返します。

例:

moreThan("build.number", "256")

lessThan("teamcity.agent.hardware.cpuCount", "10")

以上です

次の値より小さい

以上

バージョンは以上です

ソフトウェアのバージョンを指定された値と比較します。 ドット () 区切り文字、先行ゼロ、 ベータEAP などの一般的な接尾辞など、複数の値の形式をサポートします。 バージョン番号にアルファベットが含まれている場合は、それらも比較されます (例: 1.1e < 1.1g)。

例:

moreThanVer("maven", "3.0")

バージョンは以下です

バージョンは未満です

バージョン以上

contains

指定されたプロパティの値に指定された値が含まれている場合、 を返します。

例:

contains("teamcity.serverUrl", "localhost")

含まない

指定されたプロパティの値に指定された値が含まれていない場合、またはこのプロパティが存在しない場合は、 を返します。

例:

doesNotContain("system.agent.name", "_local")

次で開始

指定されたプロパティの値が指定された値で始まる (終わる) 場合、 を返します。

例:

startsWith("teamcity.agent.jvm.os.name", "Mac")

endsWith("teamcity.agent.work.dir", "/work")

次で終了

一致

指定されたプロパティが指定された 正規表現(英語)パターンに一致する (一致しない) 場合、 を返します。

例: matches("CUSTOM_PARAMETER", ".*(,|^)foo(,|$).*") を使用して、 foofoo,barbar,foobar,foo,xxx のすべての出現に一致します。

一致していません

条件の組み合わせ

複数の要件が定義されている場合、それらはブール AND によって暗黙的に結合されます。 例: 次の一連の条件では、 env.JDK_17_0 パラメーターと env.JDK_21_0 パラメーターの両方が存在する必要があります。

requirements { exists("env.JDK_17_0") exists("env.JDK_21_0") }

要件をブール OR で結合するためのメカニズムはありません。

2026 年 9 月 11 日