ビルドの主なアクション
この記事では、TeamCity のビルドに適用できるアクションについて説明します。
ビルド実行
TeamCity では、ビルドを実行できます。
自動的に、さまざまなビルドトリガーを使用します。
手動で、オンデマンド。
ビルドを手動で実行するには、画面の右上隅にある実行をクリックします。このアクションは、編集モードと表示モードモードの両方で使用できます。特定のビルド構成で実行ボタンが表示されない場合は、そのビルド構成でビルドを開始するための権限が不足していることを意味します。
実行ボタンの横にあるコンテキストメニューでは、ビルドの設定メニューが開き、カスタムビルドの実行を開始できます。カスタム実行では、現在の構成で通常のビルドを実行する場合とは異なる設定やソースコードを使用できます。これは、共通のビルド設定に影響を与えたり、コードを共通リポジトリにコミットしたりせずに、異なるビルドパラメーターを試したり、ローカルコードを事前テストしたりする場合に便利です。この機能の詳細については、ここを参照してください。
ビルドをキャンセルする
実行中のビルドをキャンセルするには、進行状況バーの横にある停止アイコンをクリックします。TeamCity は、キャンセルのオプションの理由を入力するように求めます。このビルドをキューに自動的に再追加するかどうかを選択することもできます。
単一のビルドを一時停止してから続行する方法はないことに注意してください（ただし、ビルド構成全体を一時停止することはできます）。キャンセルした場合は、最初のステップからビルドを再開する必要があります。
ビルドアクションメニュー
次のアクションは、シングルビルドアクションメニューから呼び出すことができます。ビルド構成ホームからこのメニューを開くには、リストのビルドの反対側にある 
をクリックします。ビルドの概要から開くには、左上隅にあるアクションをクリックします。
ビルドを再実行する
このアクションは、現在のビルドのみを再起動し、チェーン内の他のビルドがある場合はそれを省略します。特定のインフラストラクチャの問題によりビルドが失敗した場合に役立つ可能性があります。
ビルドを削除
このアクションにより、ビルドがリストから削除されます。
ビルドのピン留め
ビルドを固定して、スケジュールされた clean-up 中にビルドが削除されないようにすることができます。
現在のビルドがチェーンの一部であり、他のビルドとのスナップショット依存関係がある場合は、このアクションをチェーン内の先行するすべてのビルドに適用することを選択できます。
固定されたビルドは、いつでも手動で固定を解除できます。
ビルドするタグを追加する
ビルドタグは、次のことに役立つラベルです。
ビルドの履歴を整理します。
特定のタグでマークされたビルドにすばやく移動します。
特定のタグを持つビルドを検索します。
特定のタグを使用して、ビルドにアーティファクトの依存関係を作成します。
タグを編集ダイアログで、スペース、コンマ、セミコロンで区切られた 1 つ以上のタグを入力します。例: v2022 release は、v2022 と release の 2 つのタグを作成します。
ビルドリストを表示しているときに特定のタグをクリックすると、他のビルドが除外されるため、このタグが付いているビルドにのみ焦点を当てることができます。
アクションメニュー以外に、カスタムビルドを実行するダイアログとビルドのピン留めダイアログでビルドにタグを付けることができます。
サービスメッセージと TeamCity REST API を使用して、ビルドタグを追加および変更することもできます。
お気に入りにビルドを追加
ビルドをお気に入りに追加すると、すぐにアクセスできます。お気に入りのビルドは、通知のフィルターオプションとして設定することもできます。
お気に入りに追加されると、ビルドには星アイコン 
が表示されます。これをクリックすると、「お気に入り」ステータスが削除されます。
TeamCity は、手動でトリガーされた個人用ビルドをお気に入りとして自動的にマークできます。これを実現するには、ユーザープロファイル設定でそれぞれの設定を有効にします。
お気に入りを表示するには、画面の右上隅にあるアバターをクリックして、好きな作品を選択します。
2 つのビルドを比較する
ビルドのアクションメニュー ( ビルド結果内) の比較対象を選択アクションは、新しい TeamCity UI でのみ使用できます。画面の右上隅にある魔法の杖アイコンをクリックすると、クラシック UI モードから切り替えることができます。
このアクションにより、現在のビルドの設定と結果を、このビルド構成の他のビルドと並べて比較できます。統計と、それらのパラメーター、リビジョン、統計、テストの違いが表示されます。
このモードは、現在のビルド構成が複数のユーザーによって管理および監視されている場合に特に役立ちます。例: ビルドにプロジェクトコードに変更がなく、明らかな理由もなく失敗した場合は、このビルドを最後に成功したビルドと比較し、それらの違いを分析して、失敗の最も可能性の高い原因を見つけることができます。
ビルドステータスを手動で失敗または成功に変更する
プロジェクト管理者は、成功したビルドのステータスを手動で失敗に変更したり、その逆を行うことができます。これには、次の一般的な使用例があります。
成功から失敗へ :
ビルドには、最終的なビルドステータスに影響を与えない問題がありますが、ビルド履歴に問題の存在を反映させたいと考えています。
ビルドには既知の問題があり、QA チームがこのビルドを無視する必要があります。
以前、ビルドを成功として誤ってマークしました。
失敗から成功へ :
ビルド失敗条件を使用する場合は、最後に成功したビルドアンカーを変更する必要があります。メトリクスの値が誤っていたために最後のビルドが失敗し、この新しい値が有効な場合は、このビルドを成功アンカーでマークできます。
アーティファクトの依存関係で適切なアーティファクトを使用して、誤って失敗したビルドを使用できるようにする必要があります。
実行中のパーソナルビルドの場合、現在の失敗を無関係としてマークして、事前にテストされたコミットを通過させることができます。
「成功としてマーク」アクションは、開始に失敗したビルドでは使用できません。
ラベルビルドソース
TeamCity は、VCS リポジトリ内の特定のビルドのソースにラベルを付ける（タグを付ける）ことができます。適用されたラベルのリストとその適用ステータスは、ビルド結果の変更タブに表示されます。
自動ラベル付けを構成するか、アクションメニューから各ビルドに手動でラベルを付けることができます。手動ラベル付けでは、ビルドに実際の VCS 設定を使用します。
ビルドソースをマージする
TeamCity は、あるソースブランチのコードを別のソースにマージできます。たとえば、承認されたコードレビューの後です。
アクションメニューから、自動マージを設定するか、ビルドごとに手動で実行することができます。ポップアップダイアログで、マージの宛先ブランチを選択し、マージコミットメッセージを入力するように求められます。
ビルド構成アクションメニュー
ビルド構成ホームページには、さまざまなアクションのセットを備えた独自のアクションメニューがあります。それはすることを可能にします:
保留中の変更を確認します。
クリーンチェックアウトを実施します。
複数のビルドにアクションを適用する
複数のビルドを一度に管理できます（たとえば、ピン留め、タグの追加、2 つのビルドの比較、ビルドの削除、お気に入りへのビルドの追加、コメントの追加など）。このためには、ビルド構成ホームの概要タブで必要なビルドを選択し（ビルドにカーソルを合わせるとチェックボックスが表示されます）、ポップアップコンテキストメニューのコマンドを使用します。ビルドの範囲を選択する必要がある場合は、Shift を押して、選択する範囲の端にあるビルドチェックボックスをクリックします。
関連ページ：
ビルドトリガーの設定
ビルド構成が作成されると、実行ボタンをクリックしてビルドを手動でトリガーしたり、トリガーを使用して自動的に開始したりできます。ビルドトリガーは、特定のイベントで新しいビルドを開始するルールです。ビルドはビルドキューに入れられ、実行可能なエージェントが存在する場合に開始されます。ビルド構成の作成 / 編集中に、ビルド設定ページのトリガーセクションを使用してトリガーを構成できます。新しいトリガーを追加をクリックしてトリガー設定を指定します。各トリガーの構成の詳細については、対応するセクションを参照し...
プロジェクト管理者ガイド
このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...
TeamCity データのクリーンアップ
TeamCity のクリーンアップ機能により、古いビルドデータや不要なビルドデータを自動的に削除できます。サーバーのクリーンアップ構成は管理 | サーバー管理 | クリーンアップ設定で使用可能です。クリーンアップスケジュールの設定が可能で、一般的なクリーンアップ情報が表示されます。特定のプロジェクトに関連するクリーンアップルールはプロジェクト設定で設定されます | クリーンアップルール。これらのルールは、どのデータをクリーンアップし、どのデータを保持するかを定義します。これらは、プロジェクトまた...
アーティファクトの依存関係
このページでは、あるビルドから別のビルドにファイルを渡すことができる TeamCity アーティファクトの依存関係の構成について詳しく説明します。例: 一般的なデプロイビルド構成は、他の (本番) 構成によって生成されたファイルを公開します。アーティファクトは以下から渡すことができます: 同じビルドチェーン内のターゲット構成の前に実行される構成。ターゲット構成と同じビルドチェーンの一部ではない個別の構成。同じ構成の以前のビルド。Web UI を使用したアーティファクトの依存関係の設定：ビルド構成...
カスタムビルドの実行
通常、ビルド構成ではビルドトリガーを使用して、必要なスケジュールに従って、または TeamCity がソースコード内の新しい変更を検出したときに新しいビルドを開始します。これらの自動的にトリガーされるビルドに加えて、TeamCity ではビルドを手動で実行し、必要に応じて設定をカスタマイズすることもできます。つまり、新しいプロパティの追加または既存のプロパティの変更、特定の変更の選択、ビルドのスケジュール、ビルドを実行するエージェントの選択などを行うことができます。TeamCity には、カスタ...
サービスメッセージ
サービスメッセージは、ビルドに関するコマンド / 情報をビルドスクリプトから TeamCity サーバーに渡す特別に構成されたテキストです。TeamCity、それらはビルドの標準出力ストリームに書き込まれる必要があり、ビルドステップから出力またはエコーされますによって処理されます。例:echo ##teamcity[<messageName> 'value']echo