TeamCity オンプレミス 2026.1 ヘルプ

要件条件

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

条件

説明と例

存在する

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

例:

exists("DotNetCLI_Path")

存在しません

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

例:

doesNotExist("env.TEAMCITY_GIT_PATH")

等しい

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

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

例:

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

等しくない

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

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

例:

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

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

例:

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

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

以上です

次の値より小さい

以上

バージョンは以上です

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

例:

moreThanVer("maven", "3.0")

バージョンは以下です

バージョンは未満です

バージョン以上

contains

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

例:

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

含まない

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

例:

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

次で開始

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

例:

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

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

次で終了

一致

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

例: 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 で結合するためのメカニズムはありません。

2025 年 4 月 07 日

関連ページ:

エージェント要件の設定

エージェントの要件は、ビルド構成を実行できるエージェントを指定する条件です。現在存在するすべての要件を表示して新しい要件を作成し、特定の構成を実行できるエージェントを確認するには、ビルド設定 | エージェント要件にアクセスしてください。エージェント要件ビデオガイド:要件構文:エージェント要件は式です。ここは、定義済みまたはカスタム (ユーザー定義) のビルドパラメーターです。例: エージェントにインストールされているオペレーティングシステムを報告するパラメーター。要件では、エージェントがこの特...

ビルドステップの実行条件

ビルドステップを構成するときに、一般的な実行ポリシーを選択し、TeamCity 2020.1 以降ではパラメーターベースの実行条件を追加できます。実行条件により、ビルドがより柔軟になり、次のような多くの一般的な使用例に対応します。デフォルトのブランチでのみステップを実行する、ブランチでのみステップを実行する、個人ビルドのステップをスキップする、ビルドステップの条件を追加メニューで使用可能な共通オプションをすばやく選択できます。または、その他の状態オプションを選択して、パラメーターベースの実行条件...

ビルドアーティファクトにアクセスするためのパターン

このセクションは、以前の TeamCity バージョンとの下位互換性と特定の機能のために保存されています。以下の情報も確認してください。ビルド内のアーティファクトにアクセスする必要がある場合は、TeamCity の組み込みアーティファクト依存関係機能の使用を検討してください。Ivy 依存関係マネージャーを使用して TeamCity からアーティファクトをダウンロードすることもできます。外部の TeamCity ビルドからのアーティファクトのダウンロードには、REST API の使用を検討する...