ブランチリモート実行トリガ
ブランチリモート実行トリガーは、ビルド構成の VCS ルートの特定のブランチで TeamCity が変更を検出するたびに、新しい個人ビルドを自動的に開始します。完了した個人ビルドはビルド履歴にリストされますが、それを開始したユーザーに対してのみリストされます。
現時点では、ブランチリモート実行トリガーは Git および Mercurial VCS のみをサポートします。
ブランチからの非個人的なビルドについては、機能ブランチを使用した作業を参照してください。ブランチ仕様が VCS ルート用に構成されている場合、ブランチリモート実行トリガーは、一致せず、仕様によって除外されていないブランチのみを処理します。
トリガー設定
トリガーは、特定のパターンに一致する名前を持つブランチを監視します。
デフォルトのパターンは次のとおりです。
Git リポジトリ用:
refs/heads/remote-run/*Mercurial リポジトリ用:
remote-run/*
これらのブランチは通常のバージョン管理ブランチであり、TeamCity はそれらを管理しません（つまり、ブランチが不要になった場合は、通常のバージョン管理方法を使用してブランチを削除する必要があります）。
デフォルトでは、TeamCity は、ブランチの最後のコミットで検出されたユーザーの個人ビルドをトリガーします。ブランチの名前で TeamCity ユーザーを指定することもできます。そのためには、パターンで TEAMCITY_USERNAME プレースホルダーを使用し、ブランチの名前で TeamCity ユーザー名を使用します。例: パターン remote-run/TEAMCITY_USERNAME/* はブランチ remote-run/joe/my_feature と一致し、TeamCity ユーザー joe の個人ビルドを開始します（そのようなユーザーが存在する場合）。
トリガーできるようにするには、ビルドブランチがメインブランチと比較して少なくとも 1 つの新しいコミットを持っている必要があります。
サンプル: コマンドラインからパーソナルビルドを実行する
Git
デフォルトのパターン（refs/heads/remote-run/*）では、git branch -r コマンドは個人のブランチをリストします。非表示にする場合は、パターンを refs/remote-run/* に変更し、変更を refs/remote-run/my_feature などのブランチにプッシュします。この場合、ブランチは上記のコマンドではリストされませんが、git ls-remote <url_of_git_repository> を使用して表示できます。
Mercurial
制限
ビルド構成にブランチリモートの実行をサポートする複数の VCS ルートがあり、それらすべてに変更をプッシュする場合、TeamCity は各 VCS ルートごとに 1 つの個人ビルドを開始します。
トリガーされたビルドのカスタマイズ
トリガーの設定のビルドのカスタマイズタブでは、このトリガーによって開始されたビルドのカスタムパラメーターを構成できます。カスタムビルドを実行するダイアログと同様に、ビルドパラメーターの値を上書きし、ビルド前にチェックアウトディレクトリをクリーンアップするかどうかを選択できます。
このタブでは、現在のビルド構成で使用されているパラメーターの値をカスタマイズできます。または、新しいパラメーターを追加することもできます。このパラメーターは、このトリガーによって開始されたビルドでのみ使用できます。現在のビルドに他のビルドとのスナップショットの依存関係がある場合、そのようなパラメーターを使用して、依存関係ビルド構成の特定のプロパティをオーバーライドすることもできます。これには reverse.dep.<dependencyBuildID>.<property> 構文を使用します。
トリガー内でビルドパラメーターを再定義してからパラメーターで元のパラメーターを削除すると、その再定義された値がトリガー自体のプレーンテキストパラメーターに変換されることに注意してください。安全な値をカスタマイズするときは、「パスワード」の種類と一緒に保存された場合にのみ隠され、プレーンテキストに変換された場合に読み取り可能になるため、これを考慮することが重要です。
TeamCity を使用すると、同様のタスクを複数の方法で解決できます。場合によっては、異なるビルド構成を作成することが望ましい場合もあります。例: 同じ構成でカスタム実行が多すぎる場合、TeamCity が各ビルドの正確な期間を予測するのが難しい場合があります。多数の異なるパラメーターを使用してビルドをトリガーする必要がある場合は、ビルド構成テンプレートを作成し、それぞれが独自のパラメーターを持つ複数の構成の青写真として使用することをお勧めします。
関連ページ：
パーソナルビルドの実行
個人ビルドは、通常、バージョン管理にまだコミットされていない変更を使用する共通ビルドシーケンスからのビルドです。個人ビルドは通常、サポートされている IDE の 1 つからリモート実行プロシージャを介して開始されます。カスタムビルドを実行するダイアログから個人ビルドを開始し、変更を加えたパッチをサーバーに直接アップロードすることもできます。個人ビルドには対応するアイコンが付いており、ビルドを開始したユーザーのみに表示されます。他の TeamCity ユーザーの個人ビルドを表示するには、ユーザープロ...
ビルド結果ページ
TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...
機能ブランチを使用した作業
分散バージョン管理システム (DVCS) の機能ブランチを使用すると、メインの開発とは独立して機能に取り組み、機能のすべての変更をブランチにコミットし、機能が完了したら変更をメインのブランチにマージできます。このアプローチは、ソフトウェア開発チームに多くの利点をもたらしますが、専用のサポートがない継続的インテグレーションサーバーでは、ビルド構成の重複が頻繁に発生したり、可視性が低下したり、最終的にはプロセスに対する制御が失われるなど、多くの問題も発生します。機能ブランチの TeamCity サポ...
カスタムビルドの実行
通常、ビルド構成ではビルドトリガーを使用して、必要なスケジュールに従って、または TeamCity がソースコード内の新しい変更を検出したときに新しいビルドを開始します。これらの自動的にトリガーされるビルドに加えて、TeamCity ではビルドを手動で実行し、必要に応じて設定をカスタマイズすることもできます。つまり、新しいプロパティの追加または既存のプロパティの変更、特定の変更の選択、ビルドのスケジュール、ビルドを実行するエージェントの選択などを行うことができます。TeamCity には、カスタ...
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は次の 3 種類のパラメーターをサポートします。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...
ビルドチェックアウトディレクトリ
ビルドチェックアウトディレクトリは、特定の VCS ルートからのビルドソースがチェックアウトされる TeamCity エージェントマシン上のディレクトリです。ビルド構成が同じ VCS ルートで構成されている場合、このディレクトリは複数のビルド構成間で共有できます。詳細については、デフォルトのチェックアウトディレクトリおよびカスタムチェックアウトディレクトリを参照してください。チェックアウトプロセス：チェックアウトプロセスは、次のように VCS チェックアウトモードの影響を受けます。エージェント側チ...