Maven トリガを設定する
ビルド設定のトリガーページでは、次の Maven 関連のトリガーを追加できます。
チェックサムベースのトリガー
トリガーは、ローカルに保存されたバージョンに対してリポジトリのチェックサムを検証することにより、依存関係のコンテンツが実際に変更されたかどうかをチェックします。TeamCity は、ビルドをトリガーする前に、そのアーティファクトに関連付けられたファイルダイジェスト（MD5 /SHA-1）をダウンロードすることにより、必要な依存関係のチェックサムを決定しようとします。
チェックサムを取得でき、ローカルに保存されているものと一致する場合、ビルドはトリガーされません。チェックサムが異なる場合、ビルドがトリガーされます。
チェックサムをリモートサーバーから取得できない場合、依存関係がダウンロードされ、TeamCity はチェックサムを計算し、上記のビルドトリガーメカニズムに従います。
Maven スナップショット依存関係トリガー
Maven スナップショット依存関係トリガーは、チェックサムの変更によって検出されたリモートリポジトリ内のスナップショット依存関係コンテンツの実際の変更がある場合、キューに新しいビルドを追加します。
依存性アーティファクトは、POM およびサーバー側 Maven 設定に従って解決されます。
Maven アーティファクト依存関係トリガー
Maven アーティファクト依存関係トリガーは、チェックサムの変更によって検出された依存関係コンテンツの実際の変更がある場合に、キューにビルドを追加します。
トリガーを追加するには、新しいトリガーを追加ダイアログで次のパラメーターを指定します。
パラメーター | 説明 |
|---|---|
グループ ID | 目的の Maven アーティファクトが属するグループの識別子を指定します。 |
アーティファクト ID | アーティファクトの識別子を指定します。 |
バージョンまたはバージョン範囲 | アーティファクトのバージョンまたはバージョン範囲を指定します。バージョン範囲の構文については、以下のセクションで説明します。SNAPSHOT バージョンも使用できます。 |
タイプ | 指定されたアーティファクトのタイプを明示的に定義します。デフォルトでは、タイプは |
分類子 | （オプション）アーティファクトの分類子を指定します。 |
Maven リポジトリの URL | Maven リポジトリへの URL を指定します。このパラメーターはオプションです。URL が指定されていない場合: |
現在実行中のビルドがこのアーティファクトを生成できる場合は、ビルドをトリガーしないでください | ここで使用されるアーティファクトを生成するビルドが終了した後にのみビルドをトリガーするには、このオプションを選択します。 |
拡張オプション
パラメーター | 説明 |
|---|---|
リポジトリ ID | 有効な Maven 設定からの許可の使用を許可します |
ユーザー設定の選択 | 有効な設定を選択できます。Maven ランナーのユーザー設定と同じ。 |
TeamCity は、アーティファクトの更新をチェックし、変更が検出された場合にビルドをトリガーする有効なリポジトリを次のように決定します。
URL とリポジトリ ID が設定されている場合、認証は有効な設定から選択されます (下記を参照)
URL のみが設定されている場合、古い動作は保持されます: 一時的なリポジトリ ID が使用されます (
_tc_temp_remote_repo)URL が設定されていない場合（リポジトリ ID に関係なく）、アーティファクトは有効な設定に従って利用可能なリポジトリで検索されます。
TeamCity は有効な設定を次のように決定します。
トリガー設定では、ユーザーはデフォルト、カスタム、アップロードされた Maven 設定から選択できます。詳細については、Maven のサーバー側設定を参照してください。
トリガーに特定の設定が構成されていない場合、Maven ビルドステップ設定が使用されます
トリガーの設定が構成されておらず、Maven ビルドステップもない場合は、
defaultサーバーの Maven 設定が使用されます。
バージョン範囲
バージョン範囲を指定するには、Maven ドキュメントで提案されて(英語)いるように、次の構文を使用します。
Maven アーティファクト依存関係トリガーは、固定バージョンのアーティファクトだけでなく、Maven スナップショット依存関係トリガーのきめ細かい代替としてスナップショットにも使用できることに注意してください。
範囲 | 意味 |
|---|---|
| x <= 1.0 |
| 1.0 の「ソフト」要件 (単なる推奨事項 — すべての範囲に一致する場合、正しいバージョンを選択できます) |
| 1.0 のハード要件 |
| 1.2 <= x <= 1.3 |
| 1.0 <= x <2.0 |
| x> = 1.5 |
| x <= 1.0 または x> = 1.2。複数のセットはコンマ区切りです |
| このライブラリと組み合わせて動作しないことがわかっている場合、これは 1.1 を除外します |
1.0-SNAPSHOT | トリガーは、最新のスナップショットバージョンの更新を確認します |
トリガーされたビルドのカスタマイズ
トリガーの設定のビルドのカスタマイズタブでは、このトリガーによって開始されたビルドのカスタムパラメーターを構成できます。カスタムビルドを実行するダイアログと同様に、ビルドパラメーターの値を上書きし、ビルド前にチェックアウトディレクトリをクリーンアップするかどうかを選択できます。
このタブでは、現在のビルド構成で使用されているパラメーターの値をカスタマイズできます。または、新しいパラメーターを追加することもできます。このパラメーターは、このトリガーによって開始されたビルドでのみ使用できます。現在のビルドに他のビルドとのスナップショットの依存関係がある場合、そのようなパラメーターを使用して、依存関係ビルド構成の特定のプロパティをオーバーライドすることもできます。これには reverse.dep.<dependencyBuildID>.<property> 構文を使用します。
トリガー内でビルドパラメーターを再定義してからパラメーターで元のパラメーターを削除すると、その再定義された値がトリガー自体のプレーンテキストパラメーターに変換されることに注意してください。安全な値をカスタマイズするときは、「パスワード」の種類と一緒に保存された場合にのみ隠され、プレーンテキストに変換された場合に読み取り可能になるため、これを考慮することが重要です。
TeamCity を使用すると、同様のタスクを複数の方法で解決できます。場合によっては、異なるビルド構成を作成することが望ましい場合もあります。例: 同じ構成でカスタム実行が多すぎる場合、TeamCity が各ビルドの正確な期間を予測するのが難しい場合があります。多数の異なるパラメーターを使用してビルドをトリガーする必要がある場合は、ビルド構成テンプレートを作成し、それぞれが独自のパラメーターを持つ複数の構成の青写真として使用することをお勧めします。
関連ページ：
プロジェクト管理者ガイド
このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...
Maven のサーバー側設定
サーバー側の Maven 設定の解決：TeamCity サーバーは、Maven 依存関係トリガーや Maven ビルド構成タブ上の Maven モデル表示などの機能のために、サーバー側で Maven を呼び出します。プロジェクト設定の Maven 設定タブを使用して Maven 設定をアップロードし、Maven ステップ設定でアップロードした設定の 1 つを選択できます。プロセス中、TeamCity は通常の Maven ロジックを使用して、いくつかの違いがあるファイルを見つけます（以下を参照）。グ...
Maven
Maven ビルドステップでは、ビルドを自動化するために Apache Maven を使用できます。ステップ設定：Maven ステップ設定のリストとそれに対応する UI ラベルは、ビルド構成を構成するかパイプラインを構成するかによって若干異なります。メイン設定ゴール TeamCity で実行させたい Maven ゴールをスペースで区切ってリストします。一部の Maven ゴールはバージョン管理システムを使用できるため、一部の VCS チェックアウトモードゴールと互換性がなくなる可能性があります。このよう...
カスタムビルドの実行
ビルド構成とパイプラインの右上隅には、新しいビルドをトリガーする 2 つのボタンが表示されます。実行 — デフォルト設定で新規ビルドを開始します。カスタムビルドを実行する — ビルド開始前にビルド設定を変更できるダイアログを表示します。この記事では、利用可能なカスタマイズオプションについて説明するとともに、カスタムビルドをトリガーするその他の方法についても触れています。カスタムビルドを実行するダイアログ：このダイアログは、以下のいずれかの場合に TeamCity UI に表示されます。カスタムビル...
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は 3 種類のパラメーターをサポートしています。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...
チェーンのビルドでパラメーターを使用する
このトピックでは、TeamCity ビルドパラメーターを使用して、ビルドチェーンの構成間で単純なデータを交換する方法を説明します。入力および出力パラメーター：ビルド構成設定のパラメーターページでは、入力パラメーターと出力パラメーターを切り替えることができます。どちらも手動で作成された名前と値のペアです。主な違いは、意図された使用例とアクセシビリティ設定にあります。入力パラメーター入力パラメーターは、定義する同じ構成で使用されるように設計されています。例: デフォルトのブランチ名を格納し、VCS...