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
コマンドを実行しようとします。このパラメーターは、<エージェントホームディレクトリー> \ 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構成オプションを指定します。たとえば、 [extensions]
`largefiles =
設定形式については、ここで説明します。 2017.2.2より前は、このオプションはTeamCityサーバーでも使用されていました。これはセキュリティ上の理由で無効にされました。 |
パージ設定 | 現在のリポジトリのMercurialによって追跡されていないファイル(英語)とディレクトリーを削除する(英語)かどうかを定義します。不明なファイルと空のディレクトリーのみを削除するか、無視されたファイルも削除するかを選択できます。追加されたファイルと(変更されていないまたは変更された)追跡されたファイルは保持されます。 |
鏡を使う | 有効にすると、TeamCityは最初に(エージェントの |
内部プロパティー
このセクションでは、hg関連の内部プロパティーについて説明します。デフォルトを変更して、必要に応じてMercurial設定を調整できます。
サーバー側の内部プロパティー :
プロパティー | デフォルト | 説明 |
---|---|---|
| 3600 | プル操作を実行する最大時間(秒) |
| hg | サーバー上のhg実行可能ファイルへのパス(詳細については、hg実行可能ファイル検出へのパスを参照)。 |
|
|
Mercurialのエージェント設定:
プロパティー | デフォルト | 説明 | |
---|---|---|---|
| 3600 | プル操作を実行する最大時間(秒) | |
| hg | エージェントで実行可能なhgへのパス(詳細については、hg実行可能ファイル検出へのパスを参照)。 |
関連事項:
管理者ガイド : ブランチ リモート実行トリガ