ビルドステップ実行条件

ビルドステップを構成するときは、一般的な実行ポリシーを選択でき、TeamCity 2020.1 以降ではパラメーターベースの実行条件を追加できます。

実行条件により、ビルドがより柔軟になり、次のような多くの一般的な使用例に対応します。

デフォルトのブランチでのみステップを実行する
リリース ブランチでのみステップを実行する
個人ビルドのステップをスキップする

ビルドステップの条件を追加メニューで使用可能な共通オプションをすばやく選択できます。

または、その他の条件オプションを選択して、パラメーターベースの実行条件を追加します。これは、TeamCity サーバーまたはエージェントから提供される任意のビルドパラメーターを入力として受け取る論理条件です。

例: testbranch ブランチでのみビルドステップを実行するには、次のように teamcity.build.branch パラメーターの値をテストできます。

Kotlin DSL では、次のように teamcity.agent.jvm.os.name パラメーターをチェックして、現在のビルドステップを Windows エージェント上でのみ実行できます。

package _Self.buildTypes
import jetbrains.buildServer.configs.kotlin.*


object MyBuildConfig : BuildType({
    // ...
    steps {
        script {
            name = "Step 1"
            conditions {
                contains("teamcity.agent.jvm.os.name", "Windows")
            }
            // ...
        }
    }
})

 

以下のサンプルは、ステップの終了ステータスを報告するパラメーターを利用してカスタム条件を作成する方法を示しています (ステップ #3 は、ステップ #2 が失敗し、およびステップ #1 が成功した場合にのみ実行されます。)。

package _Self.buildTypes

import jetbrains.buildServer.configs.kotlin.*

object MyBuildConf : BuildType({
    steps {
        python {
            id = "Step1"
            // ...
        }
        python {
            id = "Step2"
            // ...
        }
        python {
            name = "Step3"
            conditions {
                equals("teamcity.build.step.status.Step1", "success")
                equals("teamcity.build.step.status.Step2", "failure")
            }
            // ...
        }
    }
})

 

複数の実行条件を宣言した場合、現在のビルド実行ですべての条件が満たされた場合にのみビルドステップが実行されます。

ビルドチェーンに属するビルドでパラメーターベースの実行条件を使用する場合は、ステップ条件で使用されるパラメーターの値がビルド中に変わる可能性があることに注意してください。これにより、ビルドチェーン全体で予期しないソースコードの再利用が発生する可能性があります。これを防ぐには、そのような条件を持つビルドに依存するビルド構成のスナップショット依存関係で「適切なものがあれば、新しいビルドを実行しないでください」オプションを無効にすることを検討してください。このオプションが有効化されている場合、TeamCity は影響を受けるビルド構成に対応するヘルスレポートを表示します。

このデモでは、ビルドが特定の環境で実行される場合にのみ特定のステップを実行する必要がある場合のユースケースについて説明します。これは、ビルドステップ条件で簡単に実現できます。

このブログ投稿(英語)で、このチュートリアルの要約を読むこともできます。

2026 年 9 月 11 日