TeamCity On-Premises 2026.2 Help

Maven サーバー側設定

サーバー側での Maven 設定の解決

TeamCity サーバーは、Maven 依存関係トリガーや Maven ビルド構成タブでの Maven モデル表示などの機能のために、サーバー側で Maven を呼び出します。

プロジェクト設定Maven 設定 タブを使用して Maven 設定をアップロードし、 Maven ステップ設定でアップロードした設定の 1 つを選択できます。

このプロセス中、TeamCity は通常の Maven ロジックを使用して、 settings.xml ファイルを検索しますが、いくつかの違いがあります (以下を参照)。

グローバル設定

Maven グローバルレベル設定は、TeamCity サーバープロセスのデフォルトの Maven ロケーションにある .xml ファイルから使用されます: ${env.M2_HOME}/conf/settings.xml または ${system.maven.home}/conf/settings.xml
TeamCity サーバープロセス用に設定された M2_HOME 環境変数と maven.home JVM オプションのグローバル値が使用されます。

ユーザーレベル設定

Maven user-level 設定は、ビルド構成の Maven ビルドステップの ユーザー設定の選択 セクションで定義されます (複数の Maven ステップがある場合は、最初のステップの設定が使用されます)。

次のオプションが利用可能です。

説明

<デフォルト>

TeamCity は settings.xml ファイルを次の場所で検索します (優先順位順):

  1. <TeamCity データディレクトリ>/system/pluginData/maven/settings.xml

  2. <ユーザーホーム>/.m2/settings.xml (TeamCity サーバープロセスを実行しているユーザーのホームディレクトリが使用されます)

<カスタム>

ファイルへのパスはユーザーによって提供されます。 ファイルは、サーバー上とビルドが実行されるすべてのエージェント上の両方で利用可能であるべきです。

アップロードされた設定名

TeamCity は、指定されたファイルの内容をサーバーとエージェントの両方で自動的に使用します。 Maven の設定はプロジェクトレベル(プロジェクト設定 | Maven 設定 タブ)で定義されます。 設定は <TeamCity データディレクトリ>/config/projects/<projectID>/pluginData/mavenSettings ディレクトリに保存されます。

Maven 設定のロジックについては、関連する Maven の ドキュメント(英語)を参照してください。

ユーザーレベル設定は Maven アーティファクト依存関係トリガーで構成できます。

2026 年 9 月 11 日