ツイートはてブ LINE Pocket

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

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

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

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

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

または、その他の状態オプションを選択して、パラメーターベースの実行条件を追加します。これは、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")
            }
            // ...
        }
    }
})

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

If you use parameter-based execution conditions in a build which belongs to a build chain, note that the parameter, used in a step condition, might change own value during the build. This might cause an unexpected source reuse in the whole build chain. To prevent this, consider disabling the " 適切なものがあれば、新しいビルドを実行しないでください " option in the snapshot dependency of the build configuration that depends on the build with such condition. If this option is enabled, TeamCity will show the corresponding health report for the affected build configuration.

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

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

2025 年 10 月 27 日

関連ページ：

ビルドステップの設定

ビルドステップは、CI/CD ワークフローの最小単位です。ビルドステップは、全体として実行される一連のアクションを定義します。ビルドステップは、ビルド構成とパイプラインジョブに属します。構成とパイプラインのビルドステップ：TeamCity は、.NET、Maven、NAnt、Xcode などの特定のビルドツール用に設計された幅広いビルドステップを提供します。現在、ビルド構成ではすべてのステップが利用可能です。バージョン 2025.07 で導入された

パーソナルビルドの実行

個人ビルドは、通常、バージョン管理にまだコミットされていない変更を使用する共通ビルドシーケンスからのビルドです。個人ビルドは通常、サポートされている IDE の 1 つからリモート実行プロシージャを介して開始されます。カスタムビルドを実行するダイアログから個人ビルドを開始し、変更を加えたパッチをサーバーに直接アップロードすることもできます。個人ビルドには対応するアイコンが付いており、ビルドを開始したユーザーのみに表示されます。他の TeamCity ユーザーの個人ビルドを表示するには、ユーザープロ...

ビルドパラメーターの設定

パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は 3 種類のパラメーターをサポートしています。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...

要件条件

このページでは、エージェント要件またはビルドステップ実行要件で使用される条件について説明します。存在する指定されたプロパティが存在する場合、を返します。例: 存在しません指定されたプロパティが存在しない場合は、を返します。例: 等しい指定されたプロパティが存在し、指定された値と等しい場合、を返します。値フィールドを空のままにして、指定されたプロパティが存在するが空であるかどうかを確認できます。例: 等しくない指定されたプロパティの値が指定された値と異なる場合、またはこのプロパティが存在しない場合は、を...

ビルドチェーン

ビルドチェーンは、スナップショット依存関係によって相互接続された一連のビルドです。ビルドチェーンは「パイプライン」と呼ばれることもあります。リビジョン同期が有効になっているスナップショット依存関係にリンクされたビルドチェーンの各部分は、ソースの同じスナップショットを使用します。一般的なユースケース：ビルドチェーンを指定する最も一般的な使用例は、プロジェクトの同じテストスイートを異なるプラットフォームで実行することです。例: リリースビルドの前に、さまざまなプラットフォームと環境でテストが正しく実...

カスタムビルドの実行

通常、ビルド構成ではビルドトリガーを使用して、必要なスケジュールに従って、または TeamCity がソースコード内の新しい変更を検出したときに新しいビルドを開始します。これらの自動的にトリガーされるビルドに加えて、TeamCity ではビルドを手動で実行し、必要に応じて設定をカスタマイズすることもできます。つまり、新しいプロパティの追加または既存のプロパティの変更、特定の変更の選択、ビルドのスケジュール、ビルドを実行するエージェントの選択などを行うことができます。TeamCity には、カスタ...