TeamCity で BuildAgent を作る手順(Windowsインストーラー)

概要

Windowsインストーラを使った、TeamCity のBuildAgentを新規に追加するための手順。

BuildAgent のインストール

1. BuildAgentにするマシンから、TeamCity サーバにアクセスし、管理者でログインする。

2. Agents をクリックする
   
3. MS Windows Installer リンクをクリックする(2つ目以降のBuildAgentの場合は、まず右上の「Install Build Agents」リンクをクリック)

4. BuildAgent の初期化に必要なインストーラがダウンロードされるので、そのファイルを実行する

※ 特にこだわりが無ければ、「Next」で、どんどん進めて、インストール。

※インストールの途中で、Build Agent ユーザの設定を求められるが、色々な権限を持つ必要がある。

サーバと通信できる、Build Agent のフォルダに対する完全な権限を持っている、「サービスとしてログオン」権限がある、サービスの起動/停止が行える、プログラムのデバッグが行える、等。

細かくは、右記ページ(公式)で:https://confluence.jetbrains.com/display/TCD10/Setting+up+and+Running+Additional+Build+Agents#SettingupandRunningAdditionalBuildAgents-agent_permissions

インストールの最後に、Build Agent Properties の設定画面が開く

1. 「serverUrl」に、TeamCity サーバのurlを入力する。(Build Agent マシンから、ブラウザで入力するURLと同様で良い)

例)以下のような値になるはず

http://localhost/

http://myexample:8111/

2. 右下の「Save」ボタンをクリックして、設定を保存する

Build Agent の追加結果を確認

1. 「serverUrl」で入力したTeamCityサーバにログイン
2. 上側のメニューの「Agents」をクリック
3. 「Connected」か「Unauthorized」タブの中身で、追加したAgent が確認できるはず。

4. サーバと別マシンにBuild Agentを追加した場合、まず「Unauthorized」タブに表示されるので、「Unauthorized」リンクをクリックして、出てきたウィンドウで「Authorize」ボタンクリックで、使用可能なBuild Agentになる。

TeamCityサーバでビルド等を起動すると、ここで追加されたBuildAgentが実際のビルド処理を行う。

ので、Build Agent の追加のためのセットアップだけではなく、予定されるビルド処理に必要なアプリがあれば、別途インストールす必要がある。(Visual Studioとか、JDKとか、MSBuildとか)

以上。