クラウドでビルドエージェントをホストする

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

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

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

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

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

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

共通情報

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

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

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

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

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

プロファイル設定に応じて、TeamCity がさらにエージェントを必要としていると判断すると、次のいずれかを実行できます：

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

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

切断されたエージェントは、TeamCity ビルドエージェントライセンスを解放するために、承認済みエージェントリストから除去され、システムから削除されます。

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

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

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

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

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

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

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

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

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

• 起動後のスクリプト。

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

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

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

TeamCity クラウド統合で使用する仮想マシン/イメージの要件：

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

• サーバーへの各エージェント接続時に更新を試行しないようにするには、エージェントが最新であることを確認してください。エージェントを起動し、更新が完了するまで待ちます。 サーバー上でプラグインまたはツールがインストール、更新、除去されるたびに、エージェントの状態が変わります。

• ビルドエージェント.プロパティ ファイルは"そのまま"にしておくことができます。 サーバー URL、 お名前、 認可トークン プロパティは空のままにするか任意の値に設定できます。TeamCity がインスタンスを開始するときには無視されます。

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

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

コストの見積もり

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

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