用語集

TeamCity がクラウド内のビルドエージェントを備えた仮想マシンを起動する際に従う設定のコレクション。 クラウドプロファイルの構成は、TeamCity をクラウドプロバイダー: Amazon EC2、Kubernetes、VMWare vSphere、 その他 と統合するための必須の手順です。

ビルドエージェントがインストールされているディレクトリ。 その場所は手動で変更できます。 このディレクトリには、エージェント構成ファイルと、エージェントを開始および停止するためのスクリプトなど、その他の重要なファイルが含まれています。

外部ソフトウェアで、ビルドエージェントなしで実行できるビルドステップ。 このような手順を使用すると、ビルド操作を完了するために必要がなくなったらすぐにビルドエージェントを解放できます。 これは、サーバー上のエージェントのワークロードを最適化できます。

プロジェクトを割り当てることができる名前付きのビルドエージェントのセット。 ビルドエージェントは、1 つのプールにのみ属することができます。 プロジェクトは、ビルドに複数のプールを使用できます。 プールを使用すると、特定のエージェントを特定のプロジェクトにバインドできます。

特定のビルド構成を特定のエージェントで実行できるかどうかを指定するルール。 各ビルド構成の実行に使用されるエージェントを管理できます。

ビルドエージェントがビルドを開始する前に VCS からビルドのソースファイルをチェックアウトするときのモード。 優先モードまたは強制モードとして設定できます。 サーバー側のチェックアウトの代替手段。

デフォルトのチェックアウトディレクトリを含むビルドエージェント上のディレクトリ。 デフォルトでは、エージェントのホームディレクトリと同じです。

失敗したビルドの概要に表示される確認で、現在失敗しているテストが成功し、最初にテストが失敗したビルドの 後に実行されたビルドを示します。

あるビルドによって生成されたアーティファクトを別のビルドに送信できるようにするビルド構成間の依存関係。

TeamCity で特定の認証技術を実装する役割を担う機能のまとまり。 TeamCity には二種類の認証モジュールがあります: 資格情報認証モジュールと HTTP 認証モジュールです。

特定の CI/CD ジョブを実行するプロセス。 ほとんどのビルドは、独自の詳細なアクションを実行する複数の連続したステップで構成されています。 ビルドは、ビルド構成で指定された設定に従って実行されます。

TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェア。 エージェントは、お客様の環境にインストールすることも、クラウドでオンデマンドで実行することもできます。

ビルドによって生成されたファイル。 通常、これらにはディストリビューションパッケージ、WAR ファイル、レポート、ログファイルなどが含まれます。

スナップショットの依存関係によって接続されたビルドのパイプラインまたはシーケンス。 ビルドをチェーンに接続すると、同じソースリビジョンでビルドを実行したり、ビルドを最適にキューに入れてトリガーしたり、パイプライングラフで監視したりするなどの多くの利点が得られます。 ビルドチェーンの例は、単一のプロジェクトのコンパイル、テスト、デプロイです。

すべてのビルドのすべてのソースがチェックアウトされる TeamCity エージェントマシン上のディレクトリ。

特定の種類のビルドの設定のコレクションで、ステップ、機能、その他の共通パラメーターを決定します。 属するすべてのビルドのブループリントとして機能します。 ビルド構成のホームページには、最近のすべてのビルドの一覧が表示されます。 ビルド構成の例には、 配布、 統合テスト、 リリース配布の準備、 "nightly" ビルドがあります。

同様のビルド構成を作成するためのベースとして機能する、事前定義された設定のコレクション。

ビルドで使用できる追加機能の一部（パフォーマンスモニター、レポートツール、プルリクエストのサポートなど）。

複数のプロジェクトのビルドを同時に作成するために TeamCity が使用するエージェントのプール。 ビルドグリッドは、会社全体の単一または複数のプロジェクトのために、複数のコンピューターで現在使用されていないリソースを利用します。これらのコンピューターでは、複数のビルドやテストを同時に実行できます。

TeamCity によって生成された過去のビルドの記録。

ビルドの強化されたコンソール出力。 ビルド中に発生したイベントの構造化されたリストで表されます。 通常、TeamCity が実行したアクションに関するエントリと、ビルド中に起動されたプロセスの出力が含まれます。 TeamCity はプロセス出力をキャプチャーし、階層表示できる内部形式で保存します。

ビルド構成設定で指定されたパターンに従って構成された文字列識別子。 この番号は UI に表示され、 事前定義されたパラメーターとしてビルドに渡されます。 次のようになります:

• アーティファクトのダウンロードに使用

• プロパティとして参照

• 依存関係によって接続されたビルドで共有

• アーティファクトの依存関係で使用

• サービスメッセージで設定

トリガーされ、開始を待っているビルドの一覧。 TeamCity は、これらのエージェントがアイドル状態になるとすぐに、互換性のあるビルドエージェントにそれらを配布します。 キュー内のビルドは、エージェント上で開始された時点でそのエージェントに割り当てられます。ビルドがビルドキューで待機している間は、事前割り当ては行われません。

ユーザーが定義した、または TeamCity が提供する、ビルドで使用可能な名称と値のペア。 ビルドパラメーターは、設定を柔軟に共有し、ビルドステップに渡すのに役立ちます。

特定のツールとの統合を可能にする TeamCity モジュール: コマンドライン、.NET、Kotlin スクリプト、Gradle など。 各ビルドステップは、それを実行するために使用されるランナーを定義します。

ビルドランナーによって実行されるタスク。 1 つのビルド構成に複数のステップを含めることができます。

ビルドに割り当てることができるラベル。 ラベルは、ビルドの履歴の整理、検索とナビゲーションの容易化などに使用できます。

特定のイベント（たとえば、構成された VCS ルートの変更）で新しいビルドを開始するルール。 ビルドはビルドキューに入れられ、実行可能なエージェントが存在するときに開始されます。

ビルドプロセスで現在として設定されているディレクトリ。 デフォルトでは、これはビルドチェックアウトディレクトリと同じディレクトリです。

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

次のビルドが VCS からフェッチされたソースのコピーを確実に取得する操作。 ビルドチェックアウトディレクトリのすべてのコンテンツが削除され、ソースがバージョン管理から再フェッチされます。

コードが単体テストでどのようにカバーされているかを測定するいくつかのメトリクス。 TeamCity は、さまざまな .NET および Java ツールのカバレッジを初期状態でサポートします。

コードの繰り返しブロック。 重複ファインダービルドランナー（Java および C# の場合）は、類似したコードフラグメントを検索し、コードベースで検出されたコードの反復ブロックに関する包括的なレポートを提供します。

ソースコードをその場でインスペクションし、一般的な問題やアンチパターンを見つけて報告できるコード分析ツール。

スナップショットの依存関係によって組み合わされた他のいくつかのビルドの結果を集約する特別なタイプのビルド構成。 複合ビルドは、さまざまなエージェントで並行して実行できる複数のパーツで構成されるビルドと見なすことができます。 これらのすべての部分には、ソースコードの同期されたスナップショットがあり、結果を 1 か所で確認できます。

TeamCity では、ビルド構成内で設定を共有するための ビルドパラメーターの一種です (テンプレートやレシピで広く使用されます)。

アプリケーションを頻繁に再構築およびテストするプロセスを説明するソフトウェアエンジニアリング用語。 一般的に、サーバープロセスまたはデーモンの形をとります。

• ファイルシステムまたはバージョン管理システムの変更を監視します。

• ビルドプロセスを実行します（たとえば、スクリプトを起動します）。

• テスト (JUnit や NUnit など) を実行します。
  継続的インテグレーションは、 エクストリームプログラミングやその他の アジャイルソフトウェア開発手法にも関連しています。
  継続的インテグレーションの原則に従い、TeamCity では、コミュニケーションを改善し、確立された慣行を損なうことなく変更の統合を促進しながら、会社のソフトウェア開発プロセスを監視できます。

ビルド構成と比較して設定が調整されたスタンドアロンビルド。 このようなビルドは、 実行 ボタンの横にあるコンテキストメニューから開始できます。

スナップショットまたはアーティファクトの依存関係を介して 1 つ以上のビルドに依存するビルド構成。

一部の環境へのデプロイを実行する特殊なタイプのビルド構成。 これらは通常、結果がデプロイされるビルドにスナップショットまたはアーティファクトの依存関係があるビルド構成です。

TeamCity コンポーネントであり、ソース管理で変更されたファイルの二つのバージョン間の差分を確認し、それらの差分間を移動できます。

TeamCity では、生成されたビルドプロセスに環境として渡される ビルドパラメーターの一種です。 環境。 接頭辞によって定義されます。

ユーザーによって特定のビルドに割り当てられたマーク。 ユーザーは UI でお気に入りのビルドにすばやくアクセスし、これらのビルドに関する通知のみをサブスクライブすることを選択できます。

同じビルド構成の現在のテストで、TeamCity が最初の失敗を検出したビルドへのリンク。 現在のビルドから開始して、TeamCity はビルド履歴をさかのぼり、このテストが初めて失敗した時点を調べます。

TeamCity サーバーに匿名でアクセスするユーザー。 サーバー管理者は、必要に応じてゲストアクセスを有効または無効にできます。 デフォルトでは、ゲストユーザーにすべてのプロジェクトに対する プロジェクトビューアーロールが与えられますが、そのロールと権限は調整できます。

より最近の変更を伴うビルドの後に開始するビルド。 ソースリビジョンの順序に従って、通常のビルドフローが中断されます。

ビルドステータスに関する通知を外部ターゲットに送信する TeamCity モジュール。 例: Slack 通知機能、メール通知機能、ブラウザー通知機能。

特定の操作を実行するための許可: たとえば、ビルドを実行したり、ビルド構成設定を変更したりします。

共通のビルドシーケンスから実行されるビルド。 通常、バージョン管理にまだコミットされていない変更を使用します。 これにより、開発者は、VCS のプロジェクトコードを変更することなく、実際の環境で新しく追加された機能を実行できます。 パーソナルビルドは通常、IDE からリモート実行手順を介して開始されます。

スケジュールされた clean-up 中に削除されないビルド。

欠陥のあるコードをビルドにコミットすることを防ぎ、チーム全体のプロセスに影響を与えないアプローチ。 これらの図は、事前テスト済みコミットに対する TeamCity のアプローチを示しています。

ビルド構成のコレクション。 プロジェクトは、ソフトウェアプロジェクト、プロジェクトの特定のバージョン / リリース、ビルド構成の他の論理グループに対応できます。 プロジェクトは、すべてのビルド構成に共通の設定を定義します。

ローカル開発者マシンの IDE から TeamCity エージェントマシン上のテストをリモートでデバッグできる機能。 この機能は、エージェント環境がテストの失敗の原因となるある面で一意である場合や、問題をローカルで再現することが難しい場合に役立ちます。

変更がプロジェクトのコードベースにどのように統合されるかをテストするために、サポートされている IDE プラグインの 1 つから開発者によって開始されたパーソナルビルド。 事前にテストされたコミットとは異なり、リモート実行を介して開始されたパーソナルビルドの状態に関係なく、VCS にコードがチェックインされることはありません。

バージョン管理履歴の特定の状態、つまりソースコードのバージョン。 変更が発生すると、通常は リビジョンと呼ばれる数字または文字コードで識別されます。

単一またはすべてのプロジェクトでユーザーに付与できる権限設定であり、プロジェクトや UI のさまざまな機能へのアクセスを制御します。

プロジェクト階層の最上位にあるデフォルトのプロジェクト。 その設定は、サーバー上の他のすべてのプロジェクトで使用できます。

ビルドエージェントで実行する特定のビルド構成を選択できるポリシー。 デフォルトでは、ビルドエージェントは互換性のあるすべてのビルド構成を実行しますが、常に望ましいとは限りません — その場合、このポリシーにより、各エージェントの詳細で許可される設定を制限できます。 実行構成ポリシーの設定は エージェントの詳細 | 互換性のある構成 にあります。

TeamCity がビルドのソースファイルを VCS からサーバーマシンにチェックアウトし、新しい各ビルドを開始する前にそれらをビルドエージェントマシンにエクスポートするモード。 優先モードまたは強制モードとして設定できます。 エージェント側のチェックアウトの代替。

複数のビルドを同じソースリビジョン（コミット）に割り当てて、すべてのビルドステージで同じプロジェクトファイルを使用できるようにするビルド構成間の依存関係。

スーパーユーザーログインにより、システム管理者権限でサーバー UI にアクセスできます。 管理者が資格情報を忘れた場合、または認証関連の設定を修正する必要がある場合に役立ちます。 ログインは、サーバーログにある認証トークンを使用して実行されます。

TeamCity では、ビルドツールに固有の変数として特定のランナーのビルドスクリプトに渡すことができる ビルドパラメーターの一種です。 system. 接頭辞によって定義されます。

TeamCity サーバーが構成、ビルド結果、現在の操作ファイルを保存するために使用するファイルシステム上のディレクトリ。 このディレクトリは、すべての構成設定のプライマリストレージであり、TeamCity のインストールに不可欠なデータを保持します。

TeamCity のインストール中に TeamCity サーバーアプリケーションのファイルとライブラリがアンパックされたディレクトリ。

TeamCity ユーザーがサーバーにサインインしてその機能を使用できるようにするユーザー名とパスワードの組み合わせ。 ユーザーアカウントは、手動で作成することも、使用される認証スキームに応じてサインイン時に自動的に作成することもできます (詳細については、 認証モジュールセクションを参照してください)。

管理を容易にするために、同様のロールと権限を持つユーザーアカウントを集約する方法。

バージョン管理システムへの接続。 これは、TeamCity が VCS と通信して 変更を監視し、ビルドのソースを取得する方法を決定するパラメーターのセット (ソースへのパス、ユーザー名、パスワード、その他の設定) を表します。