クラウドのホストビルドエージェント

クラウドエージェントとエグゼキューター

TeamCity は次の 2 種類の統合をサポートしています。

• 通常のクラウドエージェント。この統合タイプでは、ビルドエージェントをホストする環境として、クラウドホスティングプロバイダー（AWS、Microsoft、Azure、Google Cloud など）を使用します。これらのエージェントは、ビルドキューのディストリビューション、互換性チェック、起動と終了のアクティビティなど、すべて TeamCity によって制御されます。

• エージェントレス統合。このシナリオでは、クラウドプロバイダーは、TeamCity ビルドを処理する「請負業者」として機能します。TeamCity サーバーは、キューに入れられたビルドを「実行者」に送信し、このキューの処理方法には干渉しません。

どちらのオプションも、プロジェクト設定 | クラウドプロファイルページから利用できます。

このドキュメントセクションでは、主に通常のクラウドエージェントに焦点を当てています。エージェントレスエグゼキュータモードの詳細については、この記事を参照してください: 実行者モード: 外部 Kubernetes 統合。

共通情報

キューに入れられたビルドごとに、TeamCity は最初に自己ホスト型エージェントの 1 つでビルドを開始しようとします。利用可能なものがない場合、TeamCity は、互換性のあるエージェントと一致するクラウドイメージを見つけて、このイメージの新しいインスタンスを開始します。TeamCity は、実行中のクラウドインスタンスの数の制限を超えないようにします。

通常のクラウドエージェント統合には以下が必要です。

• クラウドに TeamCity エージェントがインストールされた構成済みの仮想マシン。起動時に TeamCity エージェントを起動するように事前設定する必要があります。

• TeamCity で構成されたクラウドプロファイル。

クラウドプロファイルが 1 つまたは複数のイメージを使用して TeamCity で構成されると、TeamCity は、新しく追加されたすべてのイメージに対して 1 つのインスタンスのテスト開始を実行し、それらに構成されたエージェントについて学習します。エージェントが接続されると、TeamCity はパラメーターを保管して、ビルド構成とエージェントの互換性を正しく処理できるようにします。利用可能なエージェントライセンスがある場合、TeamCity によって開始されたクラウドインスタンスから接続されたエージェントは自動的に承認されます。クラウドエージェントの数は、TeamCity にあるエージェントライセンスの総数によって制限されます。その後、エージェントは通常のエージェントとして処理されます。

プロファイル設定に応じて、TeamCity がより多くのエージェントを必要としていることを認識すると、次のいずれかを実行できます。

• 既存の仮想マシンを起動して停止します（ビルドが終了した後、またはアイドルタイムアウトが経過した後）。停止したマシンは割り当てが解除されるため、エージェントがアクティブでない場合は仮想マシン料金は適用されません。このタイプの TeamCity エージェントのストレージコストは引き続き適用されます。

• イメージから新しい仮想マシンを作成します。このようなマシンは破棄されます（ビルドが終了した後、またはアイドルタイムアウトが経過した後）。これにより、マシンにそれ以上の実行コストが発生しなくなります。

切断されたエージェントは、許可エージェントリストから削除され、システムから削除されて TeamCity ビルドエージェントライセンスを解放します。

エージェントクラウドプロファイルとイメージ

クラウドプロファイルは、ビルドキューを配布しながら、インストールされた TeamCity エージェントを使用して仮想マシンをオンデマンドで起動するための TeamCity の設定のコレクションです。クラウドプロファイルには、次のような一般的な設定が保存されます。

• クラウドプロバイダーに接続するために必要な認証情報。

• 同時にアクティブなクラウドエージェントの最大数。

• アクティブなエージェントをいつ終了または停止するかを指定する条件。

• 新しいクラウドエージェントの開始時に渡す必要がある TeamCity サーバー URL。

各プロファイルには、次の設定を保存する 1 つまたは複数のクラウドイメージがあります。

• 開始するクラウドインスタンスまたは使用するインスタンスイメージの ID。

• インスタンス / ノードの起動時にプルするコンテナーイメージ。

• 起動後のスクリプト。

• このイメージから生成されたクラウドエージェントを所有するエージェントプール。

クラウド統合のための TeamCity セットアップ

このセクションでは、クラウド統合に必要な一般的な手順について説明します。

TeamCity クラウド統合に使用される仮想マシン / イメージの要件

• TeamCity エージェントは、マシンの起動時に自動的に起動するように正しくインストールおよび構成されている必要があります。

• サーバーへの各エージェント接続での更新の試行をスキップするには、エージェントが最新であることを確認します。開始して、更新が完了するのを待ちます。プラグインまたはツールがサーバーにインストール / 更新 / 削除されるたびに、エージェントの状態が変化します。

• buildAgent.properties ファイルは「現状のまま」にしておくことができます。serverUrl、name、authorizationToken プロパティは空のままにすることも、任意の値に設定することもできます。TeamCity がインスタンスを開始するときは無視されます。

これらの要件が満たされていれば、通常の TeamCity エージェントのインストールとクラウドプロバイダーのイメージバンドリング手順が適用可能です。

サーバーとエージェントマシン間の接続を安全にする必要がある場合は、起動時にサーバーへの安全なトンネル (VPN など) を確立するようにエージェントマシンを設定し、TeamCity エージェントが安全なチャネル経由でデータを受信できるようにする必要があります。TeamCity エージェントとサーバー間の通信には、エージェントとサーバーの両方でポートを開く必要があることに注意してください。

見積もり

クラウドプロバイダーの価格が適用されます。料金は、TeamCity をデプロイするために実装された特定の構成によって異なります。予想外の請求をできるだけ早く発見し防止するために、設定とクラウドアカウントデータを定期的に確認することをお勧めします。

トラフィック量と必要なサーバーおよびエージェントマシンの特性は、TeamCity のセットアップと実行されるビルドの性質に大きく依存することに注意してください。