TeamCity オンプレミス 2025.11 ヘルプ

VMware vSphere および vCenter 用の TeamCity のセットアップ

TeamCity vSphere 統合により、VMware vSphere および vCenter インストールで TeamCity エージェントクラウド機能を使用できます。VMware vSphere/vCenter アカウントを使用して TeamCity を構成する必要があり、その後、キューに入れられたビルドに基づいて、オンデマンドで TeamCity エージェントを使用して仮想マシンの自動作成、起動、停止、削除を処理します。

機能は TeamCity にバンドルされているプラグインとして実装されています。

要件

機能

TeamCity vSphere 統合により、以下のことが可能になります。

  • 動作のタイプを選択します。

    • 既存の仮想マシンを起動 / 停止します。

    • 仮想マシンまたはテンプレートのクローンを作成し、アイドル状態になったら(ビルドが終了するか、プロファイル設定に応じてアイドルタイムアウトが経過したときに)クローンを削除するか、停止後に保持します。

  • 開始する仮想マシンのスナップショットを選択します。

  • クローンのディレクトリと、マシンが割り当てられるリソースプールを指定します。

  • 開始されるインスタンスの最大数を構成します。

使用箇所

TeamCity と VMware vSphere エージェントのクラウド統合を設定するには、次の手順が必要です。

  1. ビルドを実行する仮想マシンを作成します。仮想マシン(英語)の作成の詳細については、VMware vSphereWeb サイトを参照してください。

  2. VMware Tools または Open VM Tools がインストールされていることを確認してください。VMware のドキュメント(英語)を参照してください。

  3. このセクションの説明に従って、TeamCity エージェントをインストールし、マシンを構成およびテストします。

    • TeamCity でこのマシンをオンデマンドで起動 / 停止したり、クローンを作成したりする場合は、TeamCity サーバーで VMware エージェントクラウドプロファイルの構成に進みます。プロファイルが変更されると、TeamCity は変更をすぐに検出し、エージェントが現在のビルドを完了すると、これらの変更の前に起動されたエージェントを強制的にシャットダウンします。

    • このマシンのテンプレートを作成してクローンを作成する場合は、テンプレート(英語)の作成方法の詳細について VMware vSphere Web サイトを参照し、TeamCity サーバーで VMware クラウドプロファイルの構成に進みます。有効な vCenter SDK URL(英語) を指定してください。

エージェントクラウドプロファイルの設定に関する注意

  • すべてのイメージでインスタンス数を制限したり、イメージごとに制限を設定したりできます。

  • クラウドエージェントに固有のホスト名を指定することができます。イメージを追加するときは、対応するフィールドからカスタマイズスペックを選択してください。このオプションは、Windows および Linux の仮想マシンで利用できます。

  • 異なるクラウドプロファイルで同じイメージを使用する場合は、競合の可能性を避けるために、TeamCity でクラウドプロファイルを設定するときにカスタムエージェントイメージ名を使用することが可能です。これは、エージェントの命名パターンにも役立ちます。カスタムエージェントイメージ名を指定した場合、そのイメージから複製されたクラウドエージェントインスタンスの名前はこの名前に基づきます。

仮想マシンのクローンを作成してエージェントを再利用する

仮想マシンまたはテンプレートのクローンを作成し、そのクローンを保存して TeamCity で再利用できるようにするには、イメージの追加 / イメージの編集ダイアログの振る舞い構成フィールドで該当するオプションを選択します。

vCenter Add Image Behavior

スナップショット名フィールドに <Current State> を使用すると、TeamCity は常に新しいクローンを作成し、以前のクローンを削除することに注意してください。クローンされた仮想マシンを保存するには:

2025 年 4 月 07 日