ビルドチェーンを実行

デフォルトでは、下流オブジェクトをトリガーすると、単一の共有ソーススナップショット上でビルドチェーン全体が実行されます。この記事では、チェーンをトリガーする方法、一部だけを実行する方法、停止する方法について説明します。

チェーンのトリガー

推奨される方法は、トリガーをチェーンの最終 (最も下流) オブジェクトにのみ追加することです。そのオブジェクトがトリガーされると、TeamCity はすべての上流依存関係を自動的にキューに入れます。上流オブジェクトに独自のトリガーは必要ありません。

これは「結果を考える」という原則に従います。最終的に必要なビルドにトリガーを構成し、必要なものはすべてチェーンに取り込ませます。

VCS ビルドトリガーには、ビルドチェーンのトリガー動作を変更する別のオプションがあります。このオプションを有効化すると、最終ビルドではなく依存関係で変更が検出された場合でも、ビルドチェーン全体がトリガーされます。

例からビルドチェーンを見てみましょう: パック設定 — 依存 — テスト — 依存 — コンパイル

VCS トリガーが パック設定 構成に設定されている場合、TeamCity が パック設定 の変更を検出すると、通常はビルドチェーン全体がトリガーされます。 コンパイル の変更は コンパイル のみをトリガーし、チェーン全体はトリガーしません。 コンパイル の VCS 変更でチェーン全体をトリガーしたい場合は、" スナップショット依存関係の変更でトリガー" オプションを有効化した VCS トリガーを、チェーンの最終ビルド構成である パック設定 に追加します。これによってビルドの実行順序は変わりませんが、いずれかのスナップショット依存関係に変更がある場合にのみ、ビルドチェーン全体がトリガーされます。この設定では、 コンパイル または テスト ビルド構成に VCS トリガーは必要ありません。

上流の変更を下流オブジェクトに表示するには、スナップショット依存関係からの変更を表示オプションをバージョン管理設定セクションで有効化します。これにより、下流オブジェクトの変更ログタブと保留中の変更タブに上流の変更が表示されます。

このデフォルトにかかわらず、ビルドの変更リストを表示するときに、依存関係に由来する変更を含めたり除外したりできます。

失敗したチェーンビルドを再実行する

ビルドの失敗は一般に二つのカテゴリに分類されます: 実行のたびに再発する真の失敗 (構文エラー、参照の欠落) と、単純な再試行で解決できる一時的な失敗 — 不安定なテスト、チェックアウトの一時的な不具合、一時的に利用できない外部リソース (AWS S3、Dockerhub、NuGet、maven.org など) です。チェーンの末端で発生する一時的な失敗を回避するためにチェーン全体を再実行するとコストがかかる場合があるため、TeamCity はチェーン全体を再起動せずに失敗したビルドを再試行する三つの方法を提供しています。

自動再試行

インフラストラクチャの問題（たとえば、TeamCity がエージェントへの接続を失うなど）によりビルドを続行できなくなった場合、TeamCity はスタンドアロンビルドとチェーンビルドの両方で、置き換え用のビルドを自動的に開始します。手動で構成する必要はありません。

ビルドトリガーを再試行する

構成にビルド再試行トリガーを追加すると、前回のビルドが失敗するたびに新しいビルドが自動的に開始されます。

import jetbrains.buildServer.configs.kotlin.*

object BuildB : BuildType({
    name = "Build B"

    steps { ... }

    triggers {
        retryBuild {
            branchFilter = ""
        }
    }

    dependencies { ... }
})

   

チェーンの一部である構成では、同じリビジョンで新しいビルドをトリガーするも有効化します。その後、TeamCity は前回のチェーン実行で成功したすべてのビルドを再利用し、同じリビジョンで失敗した依存関係だけを再ビルドします。

このトリガーはチェーンを一時停止しません。失敗したビルドを置き換える新しいビルドがキューに入りますが、下流ビルドは元の失敗に基づいて続行されます。そのため、下流ビルドは引き続き "スナップショット依存関係が失敗しました" エラーで赤の状態になる可能性があります。

依存関係の再試行設定

再試行トリガーとは異なり、依存関係の再試行設定では下流ビルドが待機します。直接または間接のスナップショット依存関係が失敗した場合、TeamCity は下流ビルドを遅延させ、続行する前に、設定された試行回数まで失敗した依存関係を自動的に再試行します。再試行が保留中の間、成功しなかった上流ビルドは失敗ではなくキャンセル済みとしてマークされます。

これらの設定は、ビルド構成設定の依存関係タブで構成できます。

import jetbrains.buildServer.configs.kotlin.*
import jetbrains.buildServer.configs.kotlin.buildSteps.script

object DownstreamBuild : BuildType({
    name = "Downstream build"

    steps { ... }
    
    dependencies {
        snapshot(UpstreamBuild) { ... }
        retrySettings {
            maxAttempts = 3
            retryOnSameFailure = true
        }
    }})

   

カスタム再試行設定を使用する: この構成の再試行動作を明示的に設定します。それ以外の場合、最も近い依存 (ダウンストリーム) ビルドの再試行設定を使用が有効化されていると、構成はそれに依存するどのビルドからでも設定を継承します。チェーン内の最後の構成で再試行設定を一度定義し、独自の設定を定義していないすべての上流ビルドに適用できます。
同じ失敗でも依存関係を再試行する: すべての試行が同じ理由で失敗する場合でも、成功するか試行可能な実行回数を使い切るまで、TeamCity は失敗した依存関係を再試行し続けます。無効にすると、繰り返し発生した失敗はそのまま残され、再度再試行されません。

部分的なチェーン実行

チェーンの一部だけを実行すればよい場合があります。 TeamCity は、アドホックなものから完全自動化まで、三つの仕組みを提供しています。

ビルドをプロモートする

チェーンを最初から実行したくない場合があります — ある特定の完了済みビルドを再利用し、そこからチェーンを続行したい場合です。そのビルドの結果ページを開き、アクション | 昇格をクリックすると、TeamCity はこのビルドをソースとして使用してチェーンの下流部分をトリガーします。

これは、二つの一般的なシナリオで役立ちます:

最新ではなく古いビルドの結果を再利用します。たとえば、成功した「Dockerイメージをビルド」実行を「DockerHub にアップロード」構成またはパイプラインにプロモートして、同じアーティファクトを再ビルドせずに再デプロイします。
自動トリガーがないダウンストリームオブジェクトを手動で開始 — たとえば、オンデマンドでのみ実行したいデプロイ構成です。

プロモーションは一度限りのオーバーライドです: この特定の実行にのみ影響します。その後、ビルド構成とパイプラインはどちらも通常の依存関係ロジック（最新の成功したビルドまたはピン留めされたビルド）に戻ります。

オンデマンドでビルドをスキップする

一度限りの部分実行には、カスタムビルドを実行ダイアログを使用します。依存関係タブで、無視したい直接リンクされた構成にスキップオプションを設定します。

トリガーする構成に直接リンクされた構成だけをスキップできます。「ビルド 1 → ビルド 2 → ビルド 3 → ビルド 4」チェーンでは、「ビルド 4」を開始すると「ビルド 3」だけをスキップできます。

タグを使用した条件付き依存関係

繰り返し使用できるセットアップには、 teamcity.ビルド.チェーン.タグをスキップするかどうかを指定します。チームシティ.ビルド.チェーン.タグをスキップします。タグをスキップします。ビルドチェーンからスキップするタグを指定します。 teamcity.build.chain.skipTags は、タグに基づいてビルドチェーンをスキップするために使用します。 skipTags を使用すると、指定したタグのビルドをスキップできます。ビルドチェーンスキップタグ。 teamcity.build.chain.skipTags。チームシティビルドチェーンスキップタグ。ビルドチェーンのタグをスキップします。タグをスキップするための TeamCity ビルドチェーン設定です。 teamcity.ビルド.chain.skipTags。タグをスキップします。ビルドチェーンでタグをスキップします。チェーン内のビルドタグをスキップします。チームシティのビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.skipTags。スキップタグ。ビルドチェーンの skipTags。 TeamCity ビルドチェーンのスキップタグ。 teamcity.build.chain.skipTags。ビルドチェーンでタグをスキップするプロパティです。チームシティビルドチェーン skipTags。 teamcity.ビルド.チェーン.スキップタグ。チームシティ.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンスキップタグ。ビルドチェーンのタグスキップ設定。 teamcity.ビルド.チェーン.タグをスキップ。スキップするタグ。チームシティビルドチェーンスキップタグ。 TeamCity のビルドチェーンでタグをスキップします。ビルドチェーンのタグをスキップする設定です。 teamcity.ビルド.chain.タグをスキップ。 teamcity.ビルド.チェーン.タグスキップ。タグをスキップする TeamCity ビルドチェーンプロパティ。ビルドチェーンスキップタグ。 teamcity.build.chain.skipTags は、指定したタグのビルドをスキップします。ビルドチェーンで指定タグをスキップします。スキップ対象タグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンでスキップするタグです。 teamcity.ビルド.チェーン.skipTags。ビルドチェーンのタグスキップ。 TeamCity ビルドチェーン skipTags。 teamcity.ビルド.chain.スキップタグ。チームシティ build chain skipTags。ビルドチェーン skipTags。チームシティ.ビルド.チェーン.タグをスキップします。 TeamCity build chain skip tags。ビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.skipTags。 teamcity.ビルド.chain.skipTags。チームシティ.ビルド.chain.skipTags。ビルドチェーンのタグをスキップします。 TeamCity ビルドチェーンタグスキップ。スキップタグを指定します。ビルドチェーンにおけるスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティ.ビルド.チェーン.skipTags。 teamcity.build.chain.スキップタグ。ビルドチェーンスキップタグ設定。指定したタグを持つビルドをスキップします。チームシティのビルドチェーンスキップタグ。 TeamCity のビルドチェーンの skipTags。ビルドチェーンタグをスキップします。 teamcity.ビルドチェーン.スキップタグ。ビルドチェーンのタグをスキップします。ビルドチェーンで指定タグのビルドをスキップします。 teamcity build chain skip tags。 TeamCity ビルドチェーンのタグをスキップ。ビルドチェーン skip tags。 teamcity.ビルド.チェーン.スキップ Tags。ビルドチェーンでタグをスキップする。ビルドチェーンの skip tags。 teamcity.ビルド.chain.skip tags。 TeamCity ビルドチェーンでタグをスキップ。ビルドチェーンに対するタグスキップ。 teamcity.ビルド.チェーン.skipタグ。チームシティビルドチェーンのスキップタグ。ビルドチェーンのスキップ対象タグ。チェーン内ビルドのタグをスキップ。 TeamCity ビルドチェーンのスキップ対象タグ。 teamcity.ビルド.チェーン.タグ除外。除外タグ。ビルドチェーン除外タグ。 teamcity.build.chain.skipTags。 TeamCity ビルドチェーン除外タグ。ビルドチェーンから除外するタグ。チームシティビルドチェーン除外タグ。 teamcity.ビルド.チェーン.除外タグ。ビルドチェーンの除外タグ。タグを除外します。チームシティビルドチェーン除外タグ。 teamcity.ビルド.chain.除外タグ。ビルドチェーンで除外するタグ。 TeamCity ビルドチェーンの除外タグ。 teamcity.build.chain.skipTags。スキップするタグを指定する TeamCity ビルドチェーンプロパティ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグプロパティ。チームシティ.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンのスキップタグプロパティ。ビルドチェーンにおけるスキップタグ設定。 teamcity.ビルド.チェーン.タグをスキップ。スキップするビルドタグ。チームシティのビルドチェーンでスキップするタグを指定します。 teamcity.ビルド.チェーン.skipTags。チームシティビルドチェーンスキップタグ。ビルドチェーン内のスキップタグ。 teamcity.ビルド.chain.skipTags。 TeamCity ビルドチェーンのタグスキップ設定。ビルドチェーンタグスキップ設定。指定タグのビルドをスキップする設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンで指定タグをスキップする設定。 TeamCity のビルドチェーンで指定タグをスキップします。ビルドチェーンの指定タグをスキップします。 teamcity.ビルド.チェーン.指定タグをスキップ。スキップ対象のタグ。 TeamCity ビルドチェーン指定タグスキップ。チームシティビルドチェーン指定タグスキップ。ビルドチェーンでスキップする指定タグ。 teamcity.ビルド.チェーン.スキップタグ。 TeamCity build chain skipTags。ビルドチェーン skipTags プロパティ。 teamcity.ビルド.chain.skipTags。 TeamCity のビルドチェーン skipTags。ビルドチェーンのタグをスキップするプロパティ。 teamcity.ビルド.チェーン.スキップタグ。チームシティ.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップするためのプロパティ。 TeamCity ビルドチェーンの skipTags プロパティ。 teamcity.ビルド.チェーン.skipTags。ビルドチェーン skipTags 設定。指定したタグのビルドをチェーンからスキップします。チェーンでタグをスキップします。 teamcity.ビルド.チェーン.タグスキップ。 TeamCity ビルドチェーンタグスキッププロパティ。ビルドチェーンでスキップされるタグ。 teamcity.ビルド.チェーン.スキップタグ。スキップタグプロパティ。チームシティビルドチェーンの skipTags プロパティ。ビルドチェーンのスキップタグ設定。 TeamCity のビルドチェーンスキップタグ。 teamcity.ビルド.chain.skipTags。ビルドチェーンでタグをスキップする設定です。 teamcity.build.chain.skipTags。チームシティ.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。チームシティビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。チームシティのビルドチェーンスキップタグ。ビルドチェーンのタグスキップ。 teamcity.ビルド.チェーン.スキップタグ。スキップタグ。チームシティビルドチェーンスキップタグ。ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップします。 TeamCity ビルドチェーンでタグをスキップします。チームシティビルドチェーンでタグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップします。 TeamCity ビルドチェーンのタグをスキップします。チームシティのビルドチェーンのタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。チームシティビルドチェーンスキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンにおけるスキップタグ。ビルドチェーンでスキップするタグ。 TeamCity ビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティのビルドチェーンでスキップするタグ。ビルドチェーンのスキップ対象タグ。スキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンのスキップ対象タグ。ビルドチェーンで指定タグをスキップします。指定タグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンで指定タグをスキップします。ビルドチェーンの指定タグをスキップします。チームシティのビルドチェーンで指定タグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップ設定。タグスキップ設定。 TeamCity ビルドチェーンのタグスキップ設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンに対するタグスキップ設定。チームシティビルドチェーンタグスキップ設定。ビルドチェーンのタグをスキップする設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ設定。 TeamCity ビルドチェーンのスキップタグ設定。チームシティのビルドチェーンのスキップタグ設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ設定。スキップタグ設定。 TeamCity ビルドチェーンスキップタグ設定。 teamcity.ビルド.チェーン.スキップタグ設定。チームシティビルドチェーンスキップタグ設定。ビルドチェーンにおけるスキップタグ設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ設定です。 TeamCity ビルドチェーンのスキップタグ設定です。チームシティのビルドチェーンのスキップタグ設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ設定です。スキップタグ設定です。 TeamCity ビルドチェーンスキップタグ設定です。 teamcity.ビルド.チェーン.スキップタグ設定。チームシティビルドチェーンスキップタグ設定です。ビルドチェーンにおけるスキップタグ設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップ設定です。 TeamCity ビルドチェーンのタグスキップ設定です。チームシティのビルドチェーンのタグスキップ設定です。 teamcity.ビルド.チェーン.タグスキップ設定。ビルドチェーンタグスキップ設定です。タグスキップ設定です。 TeamCity ビルドチェーンタグスキップ設定です。 teamcity.ビルド.チェーン.タグスキップ設定。チームシティビルドチェーンタグスキップ設定です。ビルドチェーンにおけるタグスキップ設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップする設定です。 TeamCity ビルドチェーンのタグをスキップする設定です。チームシティのビルドチェーンのタグをスキップする設定です。 teamcity.ビルド.チェーン.タグをスキップ設定。ビルドチェーンタグをスキップする設定です。タグをスキップする設定です。 TeamCity ビルドチェーンタグをスキップする設定です。 teamcity.ビルド.チェーン.タグをスキップ設定。チームシティビルドチェーンタグをスキップする設定です。ビルドチェーンにおけるタグをスキップする設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。チームシティのビルドチェーンのスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。スキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティビルドチェーンスキップタグ。ビルドチェーンにおけるスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップ。 TeamCity ビルドチェーンのタグスキップ。チームシティのビルドチェーンのタグスキップ。 teamcity.ビルド.チェーン.タグスキップ。ビルドチェーンタグスキップ。タグスキップ。 TeamCity ビルドチェーンタグスキップ。 teamcity.ビルド.チェーン.タグスキップ。チームシティビルドチェーンタグスキップ。ビルドチェーンにおけるタグスキップ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。チームシティのビルドチェーンのスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。スキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティビルドチェーンスキップタグ。ビルドチェーンにおけるスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでスキップするタグ。 TeamCity ビルドチェーンでスキップするタグ。チームシティのビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップ対象タグ。スキップ対象タグ。 TeamCity ビルドチェーンスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。チームシティビルドチェーンスキップ対象タグ。ビルドチェーンにおけるスキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップ対象タグ。 TeamCity ビルドチェーンのスキップ対象タグ。チームシティのビルドチェーンのスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。ビルドチェーンスキップ対象タグ。スキップ対象タグ。 TeamCity ビルドチェーンスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。チームシティビルドチェーンスキップ対象タグ。ビルドチェーンにおけるスキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップ。 TeamCity ビルドチェーンでタグをスキップ。チームシティのビルドチェーンでタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。ビルドチェーンタグをスキップ。タグをスキップ。 TeamCity ビルドチェーンタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。チームシティビルドチェーンタグをスキップ。ビルドチェーンにおけるタグをスキップ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでスキップするタグ。 TeamCity ビルドチェーンでスキップするタグ。チームシティのビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップ対象タグ。スキップ対象タグ。 TeamCity ビルドチェーンスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。チームシティビルドチェーンスキップ対象タグ。ビルドチェーンにおけるスキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップ。 TeamCity ビルドチェーンのタグをスキップ。チームシティのビルドチェーンのタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。ビルドチェーンタグをスキップ。タグをスキップ。 TeamCity ビルドチェーンタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。チームシティビルドチェーンタグをスキップ。ビルドチェーンにおけるタグをスキップ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップします。 TeamCity ビルドチェーンのタグをスキップします。チームシティのビルドチェーンのタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。ビルドチェーンタグをスキップします。タグをスキップします。 TeamCity ビルドチェーンタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。チームシティビルドチェーンタグをスキップします。ビルドチェーンにおけるタグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップします。 TeamCity ビルドチェーンでタグをスキップします。チームシティのビルドチェーンでタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。ビルドチェーンタグをスキップします。タグをスキップします。 TeamCity ビルドチェーンタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。チームシティビルドチェーンタグをスキップします。ビルドチェーンにおけるタグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでスキップするタグです。 TeamCity ビルドチェーンでスキップするタグです。チームシティのビルドチェーンでスキップするタグです。 teamcity.ビルド.チェーン.スキップタグです。ビルドチェーンスキップ対象タグです。スキップ対象タグです。 TeamCity ビルドチェーンスキップ対象タグです。 teamcity.ビルド.チェーン.スキップ対象タグです。チームシティビルドチェーンスキップ対象タグです。ビルドチェーンにおけるスキップ対象タグです。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグです。 TeamCity ビルドチェーンのスキップタグです。チームシティのビルドチェーンのスキップタグです。 teamcity.ビルド.チェーン.スキップタグです。ビルドチェーンスキップタグです。スキップタグです。 TeamCity ビルドチェーンスキップタグです。 teamcity.ビルド.チェーン.スキップタグです。チームシティビルドチェーンスキップタグです。ビルドチェーンにおけるスキップタグです。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップです。 TeamCity ビルドチェーンのタグスキップです。チームシティのビルドチェーンのタグスキップです。 teamcity.ビルド.チェーン.タグスキップです。ビルドチェーンタグスキップです。タグスキップです。 TeamCity ビルドチェーンタグスキップです。 teamcity.ビルド.チェーン.タグスキップです。チームシティビルドチェーンタグスキップです。ビルドチェーンにおけるタグスキップです。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。と teamcity.build.chain.onlyTags の構成パラメーターを使用します（2024.12 以降で利用可能）。

teamcity.ビルド.チェーン.タグをスキップするかどうかを指定します。チームシティ.ビルド.チェーン.タグをスキップします。タグをスキップします。ビルドチェーンからスキップするタグを指定します。 teamcity.build.chain.skipTags は、タグに基づいてビルドチェーンをスキップするために使用します。 skipTags を使用すると、指定したタグのビルドをスキップできます。ビルドチェーンスキップタグ。 teamcity.build.chain.skipTags。チームシティビルドチェーンスキップタグ。ビルドチェーンのタグをスキップします。タグをスキップするための TeamCity ビルドチェーン設定です。 teamcity.ビルド.chain.skipTags。タグをスキップします。ビルドチェーンでタグをスキップします。チェーン内のビルドタグをスキップします。チームシティのビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.skipTags。スキップタグ。ビルドチェーンの skipTags。 TeamCity ビルドチェーンのスキップタグ。 teamcity.build.chain.skipTags。ビルドチェーンでタグをスキップするプロパティです。チームシティビルドチェーン skipTags。 teamcity.ビルド.チェーン.スキップタグ。チームシティ.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンスキップタグ。ビルドチェーンのタグスキップ設定。 teamcity.ビルド.チェーン.タグをスキップ。スキップするタグ。チームシティビルドチェーンスキップタグ。 TeamCity のビルドチェーンでタグをスキップします。ビルドチェーンのタグをスキップする設定です。 teamcity.ビルド.chain.タグをスキップ。 teamcity.ビルド.チェーン.タグスキップ。タグをスキップする TeamCity ビルドチェーンプロパティ。ビルドチェーンスキップタグ。 teamcity.build.chain.skipTags は、指定したタグのビルドをスキップします。ビルドチェーンで指定タグをスキップします。スキップ対象タグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンでスキップするタグです。 teamcity.ビルド.チェーン.skipTags。ビルドチェーンのタグスキップ。 TeamCity ビルドチェーン skipTags。 teamcity.ビルド.chain.スキップタグ。チームシティ build chain skipTags。ビルドチェーン skipTags。チームシティ.ビルド.チェーン.タグをスキップします。 TeamCity build chain skip tags。ビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.skipTags。 teamcity.ビルド.chain.skipTags。チームシティ.ビルド.chain.skipTags。ビルドチェーンのタグをスキップします。 TeamCity ビルドチェーンタグスキップ。スキップタグを指定します。ビルドチェーンにおけるスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティ.ビルド.チェーン.skipTags。 teamcity.build.chain.スキップタグ。ビルドチェーンスキップタグ設定。指定したタグを持つビルドをスキップします。チームシティのビルドチェーンスキップタグ。 TeamCity のビルドチェーンの skipTags。ビルドチェーンタグをスキップします。 teamcity.ビルドチェーン.スキップタグ。ビルドチェーンのタグをスキップします。ビルドチェーンで指定タグのビルドをスキップします。 teamcity build chain skip tags。 TeamCity ビルドチェーンのタグをスキップ。ビルドチェーン skip tags。 teamcity.ビルド.チェーン.スキップ Tags。ビルドチェーンでタグをスキップする。ビルドチェーンの skip tags。 teamcity.ビルド.chain.skip tags。 TeamCity ビルドチェーンでタグをスキップ。ビルドチェーンに対するタグスキップ。 teamcity.ビルド.チェーン.skipタグ。チームシティビルドチェーンのスキップタグ。ビルドチェーンのスキップ対象タグ。チェーン内ビルドのタグをスキップ。 TeamCity ビルドチェーンのスキップ対象タグ。 teamcity.ビルド.チェーン.タグ除外。除外タグ。ビルドチェーン除外タグ。 teamcity.build.chain.skipTags。 TeamCity ビルドチェーン除外タグ。ビルドチェーンから除外するタグ。チームシティビルドチェーン除外タグ。 teamcity.ビルド.チェーン.除外タグ。ビルドチェーンの除外タグ。タグを除外します。チームシティビルドチェーン除外タグ。 teamcity.ビルド.chain.除外タグ。ビルドチェーンで除外するタグ。 TeamCity ビルドチェーンの除外タグ。 teamcity.build.chain.skipTags。スキップするタグを指定する TeamCity ビルドチェーンプロパティ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグプロパティ。チームシティ.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンのスキップタグプロパティ。ビルドチェーンにおけるスキップタグ設定。 teamcity.ビルド.チェーン.タグをスキップ。スキップするビルドタグ。チームシティのビルドチェーンでスキップするタグを指定します。 teamcity.ビルド.チェーン.skipTags。チームシティビルドチェーンスキップタグ。ビルドチェーン内のスキップタグ。 teamcity.ビルド.chain.skipTags。 TeamCity ビルドチェーンのタグスキップ設定。ビルドチェーンタグスキップ設定。指定タグのビルドをスキップする設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンで指定タグをスキップする設定。 TeamCity のビルドチェーンで指定タグをスキップします。ビルドチェーンの指定タグをスキップします。 teamcity.ビルド.チェーン.指定タグをスキップ。スキップ対象のタグ。 TeamCity ビルドチェーン指定タグスキップ。チームシティビルドチェーン指定タグスキップ。ビルドチェーンでスキップする指定タグ。 teamcity.ビルド.チェーン.スキップタグ。 TeamCity build chain skipTags。ビルドチェーン skipTags プロパティ。 teamcity.ビルド.chain.skipTags。 TeamCity のビルドチェーン skipTags。ビルドチェーンのタグをスキップするプロパティ。 teamcity.ビルド.チェーン.スキップタグ。チームシティ.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップするためのプロパティ。 TeamCity ビルドチェーンの skipTags プロパティ。 teamcity.ビルド.チェーン.skipTags。ビルドチェーン skipTags 設定。指定したタグのビルドをチェーンからスキップします。チェーンでタグをスキップします。 teamcity.ビルド.チェーン.タグスキップ。 TeamCity ビルドチェーンタグスキッププロパティ。ビルドチェーンでスキップされるタグ。 teamcity.ビルド.チェーン.スキップタグ。スキップタグプロパティ。チームシティビルドチェーンの skipTags プロパティ。ビルドチェーンのスキップタグ設定。 TeamCity のビルドチェーンスキップタグ。 teamcity.ビルド.chain.skipTags。ビルドチェーンでタグをスキップする設定です。 teamcity.build.chain.skipTags。チームシティ.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。チームシティビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。チームシティのビルドチェーンスキップタグ。ビルドチェーンのタグスキップ。 teamcity.ビルド.チェーン.スキップタグ。スキップタグ。チームシティビルドチェーンスキップタグ。ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップします。 TeamCity ビルドチェーンでタグをスキップします。チームシティビルドチェーンでタグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップします。 TeamCity ビルドチェーンのタグをスキップします。チームシティのビルドチェーンのタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。チームシティビルドチェーンスキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンにおけるスキップタグ。ビルドチェーンでスキップするタグ。 TeamCity ビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティのビルドチェーンでスキップするタグ。ビルドチェーンのスキップ対象タグ。スキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンのスキップ対象タグ。ビルドチェーンで指定タグをスキップします。指定タグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。 TeamCity ビルドチェーンで指定タグをスキップします。ビルドチェーンの指定タグをスキップします。チームシティのビルドチェーンで指定タグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップ設定。タグスキップ設定。 TeamCity ビルドチェーンのタグスキップ設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンに対するタグスキップ設定。チームシティビルドチェーンタグスキップ設定。ビルドチェーンのタグをスキップする設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ設定。 TeamCity ビルドチェーンのスキップタグ設定。チームシティのビルドチェーンのスキップタグ設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ設定。スキップタグ設定。 TeamCity ビルドチェーンスキップタグ設定。 teamcity.ビルド.チェーン.スキップタグ設定。チームシティビルドチェーンスキップタグ設定。ビルドチェーンにおけるスキップタグ設定。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ設定です。 TeamCity ビルドチェーンのスキップタグ設定です。チームシティのビルドチェーンのスキップタグ設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ設定です。スキップタグ設定です。 TeamCity ビルドチェーンスキップタグ設定です。 teamcity.ビルド.チェーン.スキップタグ設定。チームシティビルドチェーンスキップタグ設定です。ビルドチェーンにおけるスキップタグ設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップ設定です。 TeamCity ビルドチェーンのタグスキップ設定です。チームシティのビルドチェーンのタグスキップ設定です。 teamcity.ビルド.チェーン.タグスキップ設定。ビルドチェーンタグスキップ設定です。タグスキップ設定です。 TeamCity ビルドチェーンタグスキップ設定です。 teamcity.ビルド.チェーン.タグスキップ設定。チームシティビルドチェーンタグスキップ設定です。ビルドチェーンにおけるタグスキップ設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップする設定です。 TeamCity ビルドチェーンのタグをスキップする設定です。チームシティのビルドチェーンのタグをスキップする設定です。 teamcity.ビルド.チェーン.タグをスキップ設定。ビルドチェーンタグをスキップする設定です。タグをスキップする設定です。 TeamCity ビルドチェーンタグをスキップする設定です。 teamcity.ビルド.チェーン.タグをスキップ設定。チームシティビルドチェーンタグをスキップする設定です。ビルドチェーンにおけるタグをスキップする設定です。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。チームシティのビルドチェーンのスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。スキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティビルドチェーンスキップタグ。ビルドチェーンにおけるスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップ。 TeamCity ビルドチェーンのタグスキップ。チームシティのビルドチェーンのタグスキップ。 teamcity.ビルド.チェーン.タグスキップ。ビルドチェーンタグスキップ。タグスキップ。 TeamCity ビルドチェーンタグスキップ。 teamcity.ビルド.チェーン.タグスキップ。チームシティビルドチェーンタグスキップ。ビルドチェーンにおけるタグスキップ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグ。 TeamCity ビルドチェーンのスキップタグ。チームシティのビルドチェーンのスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。スキップタグ。 TeamCity ビルドチェーンスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。チームシティビルドチェーンスキップタグ。ビルドチェーンにおけるスキップタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでスキップするタグ。 TeamCity ビルドチェーンでスキップするタグ。チームシティのビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップ対象タグ。スキップ対象タグ。 TeamCity ビルドチェーンスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。チームシティビルドチェーンスキップ対象タグ。ビルドチェーンにおけるスキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップ対象タグ。 TeamCity ビルドチェーンのスキップ対象タグ。チームシティのビルドチェーンのスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。ビルドチェーンスキップ対象タグ。スキップ対象タグ。 TeamCity ビルドチェーンスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。チームシティビルドチェーンスキップ対象タグ。ビルドチェーンにおけるスキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップ。 TeamCity ビルドチェーンでタグをスキップ。チームシティのビルドチェーンでタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。ビルドチェーンタグをスキップ。タグをスキップ。 TeamCity ビルドチェーンタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。チームシティビルドチェーンタグをスキップ。ビルドチェーンにおけるタグをスキップ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでスキップするタグ。 TeamCity ビルドチェーンでスキップするタグ。チームシティのビルドチェーンでスキップするタグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップ対象タグ。スキップ対象タグ。 TeamCity ビルドチェーンスキップ対象タグ。 teamcity.ビルド.チェーン.スキップ対象タグ。チームシティビルドチェーンスキップ対象タグ。ビルドチェーンにおけるスキップ対象タグ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップ。 TeamCity ビルドチェーンのタグをスキップ。チームシティのビルドチェーンのタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。ビルドチェーンタグをスキップ。タグをスキップ。 TeamCity ビルドチェーンタグをスキップ。 teamcity.ビルド.チェーン.タグをスキップ。チームシティビルドチェーンタグをスキップ。ビルドチェーンにおけるタグをスキップ。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグをスキップします。 TeamCity ビルドチェーンのタグをスキップします。チームシティのビルドチェーンのタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。ビルドチェーンタグをスキップします。タグをスキップします。 TeamCity ビルドチェーンタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。チームシティビルドチェーンタグをスキップします。ビルドチェーンにおけるタグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでタグをスキップします。 TeamCity ビルドチェーンでタグをスキップします。チームシティのビルドチェーンでタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。ビルドチェーンタグをスキップします。タグをスキップします。 TeamCity ビルドチェーンタグをスキップします。 teamcity.ビルド.チェーン.タグをスキップします。チームシティビルドチェーンタグをスキップします。ビルドチェーンにおけるタグをスキップします。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンでスキップするタグです。 TeamCity ビルドチェーンでスキップするタグです。チームシティのビルドチェーンでスキップするタグです。 teamcity.ビルド.チェーン.スキップタグです。ビルドチェーンスキップ対象タグです。スキップ対象タグです。 TeamCity ビルドチェーンスキップ対象タグです。 teamcity.ビルド.チェーン.スキップ対象タグです。チームシティビルドチェーンスキップ対象タグです。ビルドチェーンにおけるスキップ対象タグです。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのスキップタグです。 TeamCity ビルドチェーンのスキップタグです。チームシティのビルドチェーンのスキップタグです。 teamcity.ビルド.チェーン.スキップタグです。ビルドチェーンスキップタグです。スキップタグです。 TeamCity ビルドチェーンスキップタグです。 teamcity.ビルド.チェーン.スキップタグです。チームシティビルドチェーンスキップタグです。ビルドチェーンにおけるスキップタグです。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンのタグスキップです。 TeamCity ビルドチェーンのタグスキップです。チームシティのビルドチェーンのタグスキップです。 teamcity.ビルド.チェーン.タグスキップです。ビルドチェーンタグスキップです。タグスキップです。 TeamCity ビルドチェーンタグスキップです。 teamcity.ビルド.チェーン.タグスキップです。チームシティビルドチェーンタグスキップです。ビルドチェーンにおけるタグスキップです。 teamcity.ビルド.チェーン.スキップタグ。ビルドチェーンスキップタグ。 — 一致する構成を除外します。チェーンはそれら以外のすべてを実行します。
teamcity.build.chain.onlyTags — 一致する構成とその依存関係を保持します。保持された構成の間にある構成はスキップできません。

どちらのパラメーターも、次のカンマ区切りリストを受け付けます:

タグ — ラベルを付けたい任意の構成で設定する teamcity.configuration.tags パラメーターの値です。
構成 ID — 構成設定に表示されるか、構成 URL からコピーされます。

TeamCity はこれらのパラメーターをチェーンをトリガーする構成からのみ読み取ります。依存関係ビルド上の値は無視されます。

例: skipTags

複合「すべてビルド」構成はチェーン全体をトリガーします。コアの "ビルド..." 構成のみを実行してオプションのテストをスキップするには、オプションの構成にタグを付け、そのタグを参照します:

object TestWin : BuildType({
    id("TestWin")
    params { param("teamcity.configuration.tags", "optional") }
})
// ... other optional configurations tagged "optional" ...

object BuildAll : BuildType({
    id("BuildAll")
    type = BuildTypeSettings.Type.COMPOSITE
    params {
        param("teamcity.build.chain.skipTags", "optional")
    }
    dependencies {
        snapshot(BuildWin) {}
        snapshot(BuildPlugins) {}
    }
})

    

代わりにチェーン全体を実行するには、パラメーターを削除するか、何にも一致しない値に設定します。一般的なパターンは、夜間のフルビルド用に値をオーバーライドするスケジュールトリガーです:

triggers {
    schedule {
        schedulingPolicy = daily { hour = 3 }
        triggerBuild = always()
        buildParams {
            param("teamcity.build.chain.skipTags", "nightly-build-mode")
        }
    }
}

    

例: onlyTags

トリガー時にユーザーがサブチェーンを選択できるようにするには、 onlyTags を "プロンプト" 表示モードの選択パラメーターとしてスタイル設定します:

object BuildAll : BuildType({
    id("BuildAll")
    type = BuildTypeSettings.Type.COMPOSITE
    params {
        select("teamcity.build.chain.onlyTags", "",
            label = "Choose a sub-chain to run",
            display = ParameterDisplay.PROMPT,
            options = listOf(
                "run all" to "",
                "windows" to "windows",
                "linux" to "linux",
                "plugins" to "plugins"))
    }
    dependencies {
        snapshot(BuildWin) {}
        snapshot(BuildLinux) {}
        snapshot(BuildPlugins) {}
    }
})

    

手動でトリガーすると、カスタムビルドを実行するダイアログで値を選択するよう求められます。空の値ではチェーン全体が実行され、タグではそのタグを持つ構成とその依存関係だけが実行されます。

実行時にキュー内のビルドをスキップする

実行中のビルドステップからキュー内の下流ビルドを動的にキャンセルするには、サービスメッセージを送信します:

##teamcity[skipQueuedBuilds tags='value1,value2' comment='Your comment']

タグ 引数は、上記のパラメーターと同じタグおよび構成 ID を受け付けます。これは、ランタイム条件に基づいてチェーンの特定のブランチをキャンセルする場合に役立ちます — たとえば、"ビルド"ステップから選択したテストスイートをスキップする場合です:

Build ----|---- Test Suite 1 ----|
          |---- Test Suite 2 ----|---- Deploy
          |---- Test Suite 3 ----|

   

中間セクション全体をスキップすることは避けてください。紛らわしい "ビルド → ？？？ → デプロイ」というギャップを残さないでください。その場合は、代わりに別の軽量チェーンを維持してください。

チェーンビルドを停止する

チェーンの一部であるビルドを停止またはキューから削除すると、TeamCity は「このビルドはビルドチェーンの一部です」というメッセージを表示し、他の部分を停止の下に実行中またはキュー内の他のチェーンメンバーを一覧表示します。

一覧表示されたアクセス可能な各ビルドにはチェックボックスがあります。現在のビルドを停止すると、そのビルドが必ず失敗する場合、デフォルトで選択されます。
停止する権限がないビルドは、チェックボックスなしで表示されます。
表示する権限がないビルドは非表示になり、チェーンのすべての部分を確認できないことを示す警告に置き換えられます。

チェーンの他のすべての部分がすでに終了している場合、追加情報は表示されません。

チェーン内で個人用ビルドを実行する

個人用ビルドがチェーンをトリガーすると、そのすべての上流依存関係も個人用ビルドとして実行されます。例外はビルドの再利用です: 再利用が有効化されており、完了済みの非個人用ビルドがリビジョン要件を満たす場合、TeamCity は価値を追加しない個人用の上流ビルドを実行する代わりに、そのビルドを使用します。

2026 年 9 月 11 日