Mercurial
TeamCity は、一般的な Mercurial コマンドラインクライアントである hg コマンドを使用します。Mercurial 1.5.2\+ がサポートされています。
ご了承ください:
IDE からのリモート実行はサポートされていません。代わりにブランチリモート実行トリガを使用してください。
エージェント側チェックアウトのチェックアウトルールは、
.=><target_dir>ルールを除いてサポートされていません。
一般的な VCS ルートプロパティについては、このセクションを参照してください。以下のセクションでは、Mercurial 固有のフィールドとオプションについて説明します。
TeamCity は、すぐに Mercurial をサポートします。
一般設定
オプション | 説明 | |
|---|---|---|
変更をプル | ホスティングの URL。 | |
デフォルトブランチ | ブランチ仕様がない場合、またはブランチ仕様のブランチが見つからない場合に使用したデフォルトブランチに設定します。ここではパラメーター参照がサポートされていることに注意してください。 | |
ブランチ仕様 | このエリアには、変更を監視するすべてのブランチをリストします。構文はチェックアウトルールに似ています: | |
ブランチとしてタグを使用 | ブランチ仕様でタグを使用できます。デフォルトでは、タグは無視されます。 | |
サブレポの変更を検出する | デフォルトでは、サブリポジトリの変更は監視されません。 | |
タグ / マージのユーザー名 | ラベル付けに使用されるカスタムユーザー名 | |
非圧縮転送を使用する | 非圧縮転送は、LAN 内のリポジトリの方が高速です。 | |
HG コマンドパス | hg 実行可能ファイルへのパス。ホワイトリストに含まれている場合にのみ TeamCity サーバーで使用されます。詳細は以下を参照してください。 |
hg 実行可能ファイル検出へのパス
エージェントが起動すると、hg-plugin はエージェントマシンにインストールされた Mercurial を検出します。
プラグインは、teamcity.hg.agent.path パラメーターで指定されたパスを使用して hg version コマンドを実行しようとします。このパラメーターは、 <Agent Home Directory> \conf\buildAgent.properties で変更できます。
このパラメーターが設定されていない場合、プラグインはコマンドへのパスとして hg を使用し、それが $PATH のどこかにあるものと想定します。コマンドが正常に実行され、mercurial が適切なバージョン (1.5.2\+) である場合、hg プラグインは teamcity.hg.agent.path パラメーターで hg へのパスを報告します。
ビルド中、プラグインは VCS ルート設定の HG コマンドパスフィールドで指定された hg を使用します。検出された hg を使用するには、このフィールドに %teamcity.hg.agent.path% を入力します。このような設定を使用した構成は、hg へのパスを報告するエージェントでのみ実行されます。
プラグインのサーバー側は、teamcity.hg.customServerHgPathWhitelist 内部プロパティの値をチェックします。このプロパティには、サーバーで使用できる許可された hg パスの ; -separated リストが含まれています。VCS ルートで指定されたパスがホワイトリストに含まれている場合は、サーバーでそのパスが使用されます。含まれていない場合は、teamcity.hg.server.path 内部プロパティで指定されたパスが使用されます。このプロパティが設定されていない場合、TeamCity サーバーは $PATH から hg を使用します。
エージェント設定
これらは、エージェント側のチェックアウト ( デフォルトモード ) の場合に使用される設定であり、すべてのエージェントに Mercurial がインストールされている必要があります。
オプション | 説明 |
|---|---|
Mercurial 設定 | エージェント側のチェックアウト中にリポジトリに適用される Mercurial 構成オプションを指定します。たとえば、
[extensions]
`largefiles =
構成フォーマットについては、ここで説明します。 |
パージ設定 | 現在のリポジトリで Mercurial によって追跡されていないファイル(英語)とディレクトリをパージする(英語)かどうかを定義します。不明なファイルと空のディレクトリのみを削除するか、無視されたファイルも削除するかを選択できます。追加されたファイルおよび（変更されていないまたは変更された）追跡されたファイルは保持されます。 |
鏡を使う | 有効にすると、TeamCity は最初に（エージェントの |
内部プロパティ
このセクションでは、hg 関連の内部プロパティについて説明します。必要に応じてデフォルトを変更して、Mercurial 設定を調整できます。
サーバー側の内部プロパティ:
プロパティ | デフォルト | 説明 |
|---|---|---|
| 3600 | プル操作を実行する最大時間（秒） |
| hg | サーバー上の hg 実行可能ファイルへのパス（詳細については、hg 実行可能ファイル検出へのパスを参照）。 |
|
|
Mercurial のエージェント設定 :
プロパティ | デフォルト | 説明 | |
|---|---|---|---|
| 3600 | プル操作を実行する最大時間（秒） | |
| hg | エージェントで実行可能な hg へのパス（詳細については、hg 実行可能ファイル検出へのパスを参照）。 |
関連ページ：
VCS チェックアウトモード
ビルド構成のバージョン管理設定ページでは、プロジェクトのソースコードを VCS から取得する方法を構成できます。VCS ルートを接続してチェックアウトオプションを構成できます。VCS チェックアウトモードは、プロジェクトソースがエージェントに到達する方法に影響する設定です。このモードは、ソースのチェックアウトのみに影響します。現在のリビジョンおよび変更データの取得ロジックは TeamCity サーバーによって実行されるため、TeamCity サーバーはどのモードでも VCS サーバーにアクセスする...
VCS ルートの設定
VCS ルートは、TeamCity ←→ VCS リポジトリ通信の基礎です。この不可欠な要素は、リポジトリのチェックアウト、コードソースのタグ付け、ビルドステータスの VCS への返信など、さまざまな操作を実行するために必要な VCS プロバイダーへの接続を定義します。VCS ルートには次の情報が保存されます。TeamCity がリモートファイルをプルおよびプッシュするために使用する URL を取得してプッシュします。ブランチ情報: TeamCity が追跡する必要があるリポジトリブランチのリスト...
SSH 鍵管理
秘密 SSH キーを TeamCity プロジェクトにアップロードできます。アップロードされたキーは、VCS ルートの設定時および SSH エージェントビルド機能で使用できます。サポートされているキー形式：TeamCity は、PEM および OpenSSH 形式のキーをサポートします。異なる形式を使用するキーは変換する必要があります。例:PuTTY キージェネレーターを使用して、サポートされていない Putty 秘密鍵 () を PEM 形式に変換できます。これを行うには、変換 | OpenS...