NuGet

統合機能

TeamCity は NuGet パッケージマネージャーと統合され、エージェントに NuGet がインストールされている場合、次の機能を提供します：

• ビルドの公開されたアーティファクトに基づく プライベート NuGet フィード。

• Windows OS 上のビルドで使用される NuGet ランナーのセット、およびエージェントに Mono(英語) がインストールされている場合の Linux と macOS 上のビルドで使用される NuGet ランナーのセット。

  • NuGet Installer ビルドランナー。NuGet パッケージをインストールおよび更新します。

  • NuGet Pack ビルドランナー。NuGet パッケージをビルドします。

  • NuGet Publish ビルドランナー。選択したフィードにパッケージを公開します。

• NuGet 依存関係トリガー 。NuGet フィードの更新時にビルドをトリガーできます。

サポートされているオペレーティングシステム:
NuGet ビルドランナーは、Windows OS を実行しているビルドエージェントでデフォルトでサポートされます。 Linux と macOS は、エージェントに Mono(英語) がインストールされている場合サポートされます (Mono 4.4.2+ 上の NuGet 3.3+ のみがサポートされます)。

一般的な使用箇所のシナリオ

• パブリックフィードからパッケージをインストールするには、 NuGet Installer ビルドステップを追加します。

• パッケージを作成してパブリックフィードに公開するには、 NuGet Pack と NuGet Publish ビルドステップを追加します。

• パッケージを作成して内部 TeamCity NuGet サーバーに公開するには、TeamCity を NuGet サーバーとして有効化し (専用ページを参照)、 NuGet Pack ビルドステップと NuGet Publish ビルドステップを使用します。

• NuGet パッケージが更新されたときに新しいビルドをトリガーするには、 NuGet 依存関係トリガーを使用します。

TeamCity エージェントへの NuGet のインストール

NuGet トリガーと NuGet 関連のビルドランナーには、サーバーで構成された NuGet コマンドラインバイナリが必要です。 構成が完了すると、エージェントに自動的に配布されます。 いくつかのバージョンをインストールでき、選択したバージョンをデフォルトとして設定できます。

NuGet.exe を TeamCity にインストールするには：

1. 管理 | ツール タブに移動します。

2. ツールをインストールして NuGet.exe を選択 をクリックします。

3. パブリックフィードから NuGet をダウンロード（デフォルト）するか、 NuGet.exe を含む独自の NuGet パッケージをアップロードするかを選択します。

   • ダウンロード ラジオボタンが選択されている場合は、すべてのビルドエージェントにインストールする NuGet バージョンを指定します。

   • アップロード ラジオボタンが選択されている場合は、独自の NuGet パッケージを指定します。

4. 関連するチェックボックスを使用して、この NuGet バージョンをデフォルトにするかどうかを指定します。

5. 追加 をクリックして、選択した NuGet バージョンをインストールします。

エージェント上の NuGet パッケージキャッシングのクリーンアップ

NuGet は、いくつかのローカルキャッシュを使用して、すでにインストールされているパッケージのダウンロードを回避し、オフラインサポートを提供します。 エージェントの空き容量が不足している場合、TeamCity はエージェント上の NuGet パッケージキャッシングをクリーンアップしようとします。

TeamCity NuGet クリーナーは、次の Windows ディレクトリ内のキャッシングをクリーンアップします：

• %NUGET_PACKAGES% environment variable (絶対パスでなければなりません)

• %LOCALAPPDATA%\NuGet\Cache

• %LOCALAPPDATA%\NuGet\v3-cache

• %USERPROFILE%\.nuget\packages

TeamCity 2019.2.3 以降、既存の NuGet クリーナーに加えて、新しい自動パッケージクリーナーが導入されています。 .NET SDK がビルドエージェントにインストールされている場合、TeamCity はネイティブの .NET SDK コマンドを使用してクリーンアップします。 新しいクリーナーは、.NET SDK をサポートするすべてのプラットフォームで機能し、いくつかのレベルで動作します。 最初に一時キャッシュをクリーンアップし、その後、必要に応じて .nupkg ファイルと HTTP リクエストをクリーンアップします。

プライベート NuGet フィードでの認証

ビルドイン NuGet フィードまたは NuGet フィード資格情報ビルド機能で指定されたフィードで認証を使用できます。 資格情報のプロバイダーは、これらのフィードへの要求を自動的に認証します。

API サポート:

• NuGet インストーラー / NuGet Publish ランナー

  • v3: NuGet 4.8+（Windows）、Mono 上の NuGet 4.9+ が必要です

  • v1/v2: NuGet 2.0+ は最小要件、NuGet 3.5+ が推奨

• .NET

  • v3: .NET CLI 2.1.500 が必要

  • v1/v2: 未サポート

プロキシ構成

NuGet コマンドラインクライアントは、 NuGet.config ファイルパラメーターまたは環境変数を介したプロキシサーバー構成をサポートしています。 詳細については、 NuGet のドキュメントを参照してください。