TeamCity On-Premises 2026.2 Help

NuGet 依存関係トリガー

NuGet リポジトリで NuGet パッケージの更新が検出された場合、 NuGet 依存関係トリガーを使用して新しいビルドを開始できます。

要件と制限

Windows で実行されている TeamCity サーバーには、 .NET 4.0 が必要です。

Linux 上で実行されている TeamCity サーバーでは、NuGet 依存関係トリガーは次の 制限事項 で動作すると報告されています:

  • パッケージバージョンスペックによるフィルタリングはサポートされていません

  • HTTP パッケージソースのみがサポートされています

  • NuGet フィードバージョン 1.0 が使用されているため、大文字と小文字の区別の問題が発生する可能性があります

  • Linux での現在のトリガー実装により、サーバーの負荷が増大する可能性

  • 認証の問題が発生する可能性があります

トリガー設定

  1. NuGet.exe ドロップダウンメニューから、使用する NuGet バージョンを選択します。

  2. nuget.org と異なる場合は、NuGet パッケージソースを指定します。

  3. 必要に応じて、NuGet フィードにアクセスするための資格情報を指定します。

  4. パッケージ ID を入力して、更新を確認します。

  5. オプションで、チェックする パッケージのバージョン範囲を指定できます。 指定されていない場合、TeamCity は最新バージョンをチェックします。

プレリリースパッケージのバージョンが検出された場合、対応するチェックボックスを選択してビルドをトリガーすることもできます。 これは、NuGet バージョン 1.8 以降でのみサポートされていることに注意してください。

トリガーされたビルドのカスタマイズ

トリガーの設定の ビルドカスタマイズ タブでは、このトリガーによって開始されたビルドのカスタムパラメーターを構成できます。 カスタムビルドを実行するダイアログと同様に、 ビルドパラメーターの値を上書きし、ビルド前に チェックアウトディレクトリをクリーンアップするかどうかを選択できます。

このタブでは、現在の ビルド構成 で使用されている任意の パラメーター の値をカスタマイズできます。 また、新しいパラメーターを追加することもでき、そのパラメーターはこのトリガーによって開始されるビルドでのみ使用できます。 現在のビルドに他のビルドに対する スナップショット依存関係 がある場合、このようなパラメーターを使用して、依存ビルド構成の 特定のプロパティをオーバーライド することもできます: このためには reverse.dep.<dependencyBuildID>.<property> 構文を使用します。

トリガー内でビルドパラメーターを再定義してから パラメーター で元のパラメーターを削除すると、その再定義された値がトリガー自体のプレーンテキストパラメーターに変換されることに注意してください。 安全な値をカスタマイズするときは、 「パスワード」の種類と一緒に保存された場合にのみ隠され、プレーンテキストに変換された場合に読み取り可能になるため、これを考慮することが重要です。

TeamCity では類似したタスクを複数の方法で解決でき、場合によっては別々のビルド構成を作成するほうが依然として望ましいことがあります。 たとえば、同じ構成でカスタム実行が多すぎる場合、TeamCity が各ビルドの正確な所要時間を予測しにくくなることがあります。 多数の異なるパラメーターでビルドをトリガーする必要がある場合は、 ビルド構成テンプレート を作成し、それぞれ独自のパラメーターを持つ複数の構成のブループリントとして使用することをお勧めします。

2026 年 9 月 11 日