TeamCity オンプレミス 2026.1 ヘルプ

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 が各ビルドの正確な期間を予測するのが難しい場合があります。多数の異なるパラメーターを使用してビルドをトリガーする必要がある場合は、ビルド構成テンプレートを作成し、それぞれが独自のパラメーターを持つ複数の構成の青写真として使用することをお勧めします。

2025 年 4 月 10 日

関連ページ:

NuGet

統合機能:TeamCity は NuGet パッケージマネージャーと統合され、NuGet がエージェントにインストールされている場合、次の機能を提供します。ビルドの公開されたアーティファクトに基づくプライベート NuGet フィード。NuGet パッケージをインストールおよび更新する NuGet インストーラービルドランナー。NuGet パッケージをビルドする NuGet パックビルドランナー。NuGet パブリッシュビルドランナー。選択したフィードにパッケージを公開します。、NuGet 依存関係トリ...

カスタムビルドの実行

ビルド構成とパイプラインの右上隅には、新しいビルドをトリガーする 2 つのボタンが表示されます。実行 — デフォルト設定で新規ビルドを開始します。カスタムビルドを実行する — ビルド開始前にビルド設定を変更できるダイアログを表示します。この記事では、利用可能なカスタマイズオプションについて説明するとともに、カスタムビルドをトリガーするその他の方法についても触れています。カスタムビルドを実行するダイアログ:このダイアログは、以下のいずれかの場合に TeamCity UI に表示されます。カスタムビル...

ビルドパラメーターの設定

パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型:TeamCity は 3 種類のパラメーターをサポートしています。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...

チェーンのビルドでパラメーターを使用する

このトピックでは、TeamCity ビルドパラメーターを使用して、ビルドチェーンの構成間で単純なデータを交換する方法を説明します。入力および出力パラメーター:ビルド構成設定のパラメーターページでは、入力パラメーターと出力パラメーターを切り替えることができます。どちらも手動で作成された名前と値のペアです。主な違いは、意図された使用例とアクセシビリティ設定にあります。入力パラメーター入力パラメーターは、定義する同じ構成で使用されるように設計されています。例: デフォルトのブランチ名を格納し、VCS...

ビルドステップの実行条件

ビルドステップを構成するときに、一般的な実行ポリシーを選択し、TeamCity 2020.1 以降ではパラメーターベースの実行条件を追加できます。実行条件により、ビルドがより柔軟になり、次のような多くの一般的な使用例に対応します。デフォルトのブランチでのみステップを実行する、ブランチでのみステップを実行する、個人ビルドのステップをスキップする、ビルドステップの条件を追加メニューで使用可能な共通オプションをすばやく選択できます。または、その他の状態オプションを選択して、パラメーターベースの実行条件...

カスタムパラメーターの作成と設定

このトピックでは、カスタム TeamCity パラメーターを作成し、その外観と動作を構成する方法について説明します。名前の制限:構成パラメーターの名前には、文字のみが含まれ、ASCII 文字で始まる必要があります。新しいパラメーターを作成する方法:TeamCity UI 内プロジェクトまたは構成設定に移動し、パラメータータブに切り替えます。パラメーターの優先順位と継承ルールについては、この記事を参照してください: パラメーター値。入力パラメータータブに切り替えます。出力パラメーターはビルドチェ...