IntelliJ プラットフォームヘルプ用の TeamCity プラグイン 2021.2 ヘルプ

用語集

このセクションでは、基本的な用語とその定義のアルファベット順のリストを提供します。これは、IntelliJ プラットフォーム用の TeamCity プラグインを正常に操作できます。

ビルドエージェント

TeamCity ビルドエージェントは、実際にビルドプロセスを実行するソフトウェアです。TeamCity サーバーとは別にインストールおよび構成されます。TeamCity サーバーは、接続されているすべてのエージェントを監視し、対応するビルド構成で定義されている互換性要件に基づいて、キューに入れられたビルドをエージェントに割り当てます。ビルドを作成するために、TeamCity は、特定のエージェントで実行されたビルド構成のビルドの履歴に基づいて、最速のエージェントを選択しようとします。詳細については、TeamCity オンラインリファレンス: ビルドエージェントを参照してください。

ビルド構成

ビルド構成は、特定のタイプのビルドのクラス、またはビルドを作成するために使用される手順を説明します。ビルド構成の例には、統合ビルド、リリースビルド、ナイトリービルドなどがあります。ビルド構成は、対応する権限を持つユーザーによって TeamCity Web UI で作成されます。
TeamCity オンラインリファレンスで詳細を参照してください:

ビルドグリッド

複数のプロジェクトのビルドを同時に作成するために TeamCity によって使用されるコンピューターのプール(ビルドエージェント)。

ビルドキュー

TeamCity が互換性のあるビルドエージェントが利用可能になったときに配布するビルド構成のリスト。

詳細については、TeamCity オンラインリファレンスを参照してください。

変更

導入するソースコードの変更。変更がバージョン管理システムにコミットされているが、ビルドにまだ含まれていない場合、特定のビルド構成で保留中と見なされます。

パーソナルビルド

個人ビルドは、リモート実行コマンドによって開始されるビルドです。これにより、「実際の」ビルドに影響を与えることなく、ソースコードへの最近の変更を安全にテストできます。個人ビルドが失敗しても、「実際の」ビルドには影響しません。開発者には失敗の原因がすぐに通知され、個人ビルドの開始時に有効な状態にロールバックできます。ビルドが成功すると、TeamCity は変更をバージョンコントロールシステムに自動的にコミットします。

事前にテストされたコミット機能を使用して、ビルドが正常に行われた場合、変更されたコードをバージョン管理に自動的にチェックインできます。テスト済みのコミットを参照してください。

事前テスト済み(遅延)コミット

事前にテストされたコミットは、欠陥のあるコードがビルドに組み込まれるのを防ぎ、チーム全体を壊れたビルドの煩わしさから救うのに役立つアプローチです。

パーソナルビルドを実行するときは、事前にテストされたコミット機能を有効にできます。このオプションを選択すると、変更が TeamCity サーバーに送信され、ビルドがビルドキューに追加されます。同時に、TeamCity は変更をシェルフセットにコピーします。ビルドが成功したことがサーバーに通知されると、TeamCity はシェルフセットからソース管理への変更を自動的にコミットします。コミットが成功した場合、TeamCity はシェルフセットを削除します。何らかの理由でコミットが失敗した場合は、事前にテストされたコミットが追加されました <date><time> という名前のシェルフセットで変更を見つけることができます。

事前にテストされたコミットは、次の状況で失敗します。

  • ビルドがテストに失敗した場合


    ビルドがテストに失敗すると、開発者に通知され、すぐにローカルで修正作業を開始できます。

  • 競合する変更が発生した場合


    テスト前のコミットの後、ビルドが成功したことが TeamCity クライアントに通知される前に、誰かがファイルのいずれかに変更をコミットすると、競合する変更が発生します。この場合、バージョン管理から最新のリビジョンを取得し、テスト済みのコミットを再実行することで、競合をローカルで解決する必要があります)。このような競合が発生した場合、テスト済みでコミット済みの変更を適切なシェルブセットで見つけることができます。

プロジェクト

プロジェクトは、ビルド構成のコレクションです。プロジェクトには名前があり(通常は実際のプロジェクトの名前に対応します)、意味のある説明を付けることができます。

リモートデバッグ

リモートデバッグを使用すると、ローカル開発者マシンの IDE から、TeamCity エージェントマシンでのデバッグテストをリモートで実行できます。エージェント環境が特定の面で一意であり、テストが失敗し、問題をローカルで再現することが難しい場合に役立ちます。

リモート実行

パーソナルビルドを参照してください。

シェルフセット

シェルフセットは、保存されているが、VCS にコミットする準備がまだ整っていないファイルのセットです。保留中の変更をワークスペースに保存したり、フィードバックのために他のチームメンバーと共有したりするために、ファイルをシェルブすることができます。シェルブされたファイルを使用して、部分的に完了した作業を渡すこともできます。

適切なビルド構成

適切な構成は、変更を検証するために使用できる TeamCity サーバー上のビルド構成です。TeamCity プラグインは、パーソナルビルドを実行する場合と、プロジェクトで変更をフィルタリングする場合の 2 つの場合に適切な構成を探します。

TeamCity プラグインが適切な構成を見つけられない場合は、次のことを確認してください。

  • IDEA の VCS 設定は、TeamCity の VCS 設定に対応しています。

  • ターゲットプロジェクトの表示と実行のビルド権限があります。

バージョン管理システム (VCS)

バージョン管理システム(VCS)は、プロジェクトのソースファイルのリビジョンを追跡するためのシステムです。SCM(ソースコード管理)またはリビジョン管理システムとも呼ばれます。

VCS ルート

VCS ルートは、VCS 設定(ソースへのパス、ログイン、パスワード、その他の設定)のコレクションであり、TeamCity がバージョン管理(SCM)システムと通信して変更を監視し、ビルドのソースを取得する方法を定義します。