Mercurial

TeamCityは、典型的なMercurialコマンドラインクライアントであるhgコマンドを使用します。Mercurial 1.5.2+がサポートされています。

ご了承ください：

IDEからのリモート実行はサポートされていません。代わりにブランチリモート実行トリガを使用してください。
.=><target_dir> ルールを除き、エージェント側チェックアウトのチェックアウトルールはサポートされていません。一般的なVCSルートプロパティーについては、このセクションを参照してください。以下のセクションには、Mercurial固有のフィールドとオプションの説明が含まれています。

TeamCityは、すぐにMercurialをサポートします。

このページで：

一般設定
- hg実行可能ファイル検出へのパス
エージェント設定
内部プロパティー

一般設定

オプション	説明
変更をプル	ホスティングのURL。
デフォルトブランチ	ブランチ仕様がない場合、またはブランチ仕様のブランチが見つからない場合に使用したデフォルトブランチに設定します。ここではパラメータ参照がサポートされていることに注意してください。
ブランチ仕様	このエリアには、変更を監視するすべてのブランチをリストします。構文はチェックアウトルールに似ています： `+\|-:branch_name`、ここで `branch_name` はVCSに固有です（オプションの `*` プレースホルダーを使用）。1つのアスタリスクのみが許可され、各ルールは新しい行で開始する必要があることに注意してください。ブックマークは、ブランチおよびブランチ仕様フィールドでも使用できます。ブックマークの名前が通常のブランチと同じ場合、通常のブランチが勝ちます。関連するTeamCityブログ投稿(英語)の詳細。ブックマークのサポートには、TeamCityサーバーにインストールされたMercurial 2.4が必要です。
ブランチとしてタグを使用	ブランチ仕様でタグを使用できます。デフォルトでは、タグは無視されます。
サブレポの変更を検出する	デフォルトでは、サブリポジトリの変更は監視されません。
タグ/マージのユーザー名	ラベル付けに使用されるカスタムユーザー名
非圧縮転送を使用する	非圧縮転送は、LAN内のリポジトリの方が高速です。
HGコマンドパス	hg実行可能ファイルへのパス。ホワイトリストに含まれる場合にのみ、TeamCityサーバーで使用されます。以下を参照してください。

hg実行可能ファイル検出へのパス

エージェントが起動すると、hg-pluginはエージェントマシンにインストールされたMercurialを検出します。

プラグインは、teamcity.hg.agent.path パラメーターで指定されたパスを使用して hg version コマンドを実行しようとします。このパラメーターは、<エージェントホームディレクトリー> \ conf \ buildAgent.propertiesで変更できます。

このパラメーターが設定されていない場合、プラグインは hg をコマンドへのパスとして使用します（$PATHのどこかにあると想定します）。コマンドが正常に実行され、mercurialに適切なバージョン（1.5.2+）がある場合、hg-pluginは 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構成オプションを指定します。たとえば、`largefiles` 拡張を有効にするには、次を入力します。 [extensions] `largefiles = 設定形式については、ここで説明します。 2017.2.2より前は、このオプションはTeamCityサーバーでも使用されていました。これはセキュリティ上の理由で無効にされました。
パージ設定	現在のリポジトリのMercurialによって追跡されていないファイル(英語)とディレクトリーを削除する(英語)かどうかを定義します。不明なファイルと空のディレクトリーのみを削除するか、無視されたファイルも削除するかを選択できます。追加されたファイルと（変更されていないまたは変更された）追跡されたファイルは保持されます。
鏡を使う	有効にすると、TeamCityは最初に（エージェントの `system/mercurial` ディレクトリーに）ローカルエージェントミラーを作成し、このローカルミラーから作業ディレクトリーにクローンを作成します。ビルド作業ディレクトリーのみがクリーンアップされるため、このオプションはクリーンチェックアウトを高速化します。また、単一のルートが複数のビルド構成で使用されている場合、クローンは高速になります。

オプション

説明

Mercurial設定

エージェント側のチェックアウト中にリポジトリに適用されるMercurial構成オプションを指定します。たとえば、largefiles 拡張を有効にするには、次を入力します。

[extensions] 
`largefiles =

設定形式については、ここで説明します。

2017.2.2より前は、このオプションはTeamCityサーバーでも使用されていました。これはセキュリティ上の理由で無効にされました。

パージ設定

現在のリポジトリのMercurialによって追跡されていないファイル(英語)とディレクトリーを削除する(英語)かどうかを定義します。不明なファイルと空のディレクトリーのみを削除するか、無視されたファイルも削除するかを選択できます。追加されたファイルと（変更されていないまたは変更された）追跡されたファイルは保持されます。

鏡を使う

有効にすると、TeamCityは最初に（エージェントの system/mercurial ディレクトリーに）ローカルエージェントミラーを作成し、このローカルミラーから作業ディレクトリーにクローンを作成します。ビルド作業ディレクトリーのみがクリーンアップされるため、このオプションはクリーンチェックアウトを高速化します。また、単一のルートが複数のビルド構成で使用されている場合、クローンは高速になります。

内部プロパティー

このセクションでは、hg関連の内部プロパティーについて説明します。デフォルトを変更して、必要に応じてMercurial設定を調整できます。

サーバー側の内部プロパティー：

プロパティー	デフォルト	説明
`teamcity.hg.pull.timeout.seconds`	3600	プル操作を実行する最大時間（秒）
`teamcity.hg.server.path`	hg	サーバー上のhg実行可能ファイルへのパス（詳細については、hg実行可能ファイル検出へのパスを参照）。
`teamcity.hg.customServerHgPathWhitelist`		`;` -TeamCityサーバーマシンで使用するhg実行可能ファイルへの許可パスの分離リスト

Mercurialのエージェント設定：

プロパティー	デフォルト	説明
`teamcity.hg.pull.timeout.seconds`	3600	プル操作を実行する最大時間（秒）
`teamcity.hg.agent.path`	hg	エージェントで実行可能なhgへのパス（詳細については、hg実行可能ファイル検出へのパスを参照）。

関連事項:

管理者ガイド : ブランチリモート実行トリガ

TeamCity 2019.1ヘルプ