NuGet CLI 環境変数

  • [アーティクル]

nuget.exe CLI のビヘイビアーはさまざまな環境変数を使用して構成できます。これらは、コンピューター全体、ユーザー、またはプロセス レベルの nuget.exe に影響を与えます。 環境変数は常に NuGet.Config ファイル内の設定をオーバーライドするため、ビルド サーバーはファイルを変更せずに適切な設定を変更できます。

一般に、コマンド ラインまたは NuGet 構成ファイルで直接指定されたオプションが優先されますが、FORCE_NUGET_EXE_INTERACTIVE などのいくつかの例外があります。 異なるコンピューター間で nuget.exe の動作が異なる場合は、環境変数が原因である可能性があります。 たとえば、(展開時に使用される) Azure Web Apps Kudu では、NUGET_XMLDOC_MODE を skip に設定してパッケージの復元パフォーマンスを高速化し、ディスク領域を節約しています。

NuGet CLI は MSBuild を使用してプロジェクト ファイルを読み取ります。 すべての環境変数は、MSBuild の評価中にプロパティとして入手できます。 「MSBuild ターゲットとしての NuGet のパックおよび復元」に記載されているプロパティのリストは、環境変数として設定することもできます。

変数 説明 解説
http_proxy NuGet HTTP 操作に使用される HTTP プロキシ。 これは、http://<username>:<password>@proxy.com のように指定します。
no_proxy プロキシの使用をバイパスするようにドメインを構成します。 コンマ (,) で区切り、ドメインとして指定します。
EnableNuGetPackageRestore 復元時にパッケージで必要な場合に NuGet が暗黙的に同意するかどうかのフラグを設定します。 指定されたフラグは true または 1 として扱われ、その他の値はフラグが設定されていないとして扱われます。
NUGET_CLI_LANGUAGE nuget.exe 出力言語を変更します 6.5 以降のバージョンで利用できます。 サポートされている値は、サポートされている Visual Studio 言語のロケール名 zh-cn、zh-tw、cs-cz、en-us、es-es、fr-fr、de-de、it-it、ja-jp、ko-kr、pl-pl、pt-br、ru-ru、tr-tr です。
NUGET_EXE_NO_PROMPT 資格情報を求めるプロンプトの exe を禁止します。 null (つまり空の文字列) を除くすべての値は、このフラグが設定されている (true) として扱われます。
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS HTTP 応答に Retry-After ヘッダーが含まれている場合の再試行の最大間隔 NUGET_OBSERVE_RETRY_AFTER が (既定と同様に) 有効になっており、HTTP 応答に Retry-After ヘッダーが含まれている場合、この環境変数は待機する最大期間を設定します。 Retry-After では、期間 (差分) またはタイム スタンプ (日付) を指定できます。 サーバーからタイム スタンプが返され、マシンのクロックがサーバーと同期していない場合、計算される期間が非常に長くなる (または負になる) 可能性があります。
FORCE_NUGET_EXE_INTERACTIVE 対話型モードを強制するグローバル環境変数。 null (つまり空の文字列) を除くすべての値は、このフラグが設定されている (true) として扱われます。
NUGET_PACKAGES 「グローバル パッケージ、キャッシュ、および一時フォルダーを管理する」に記載されているように、グローバル パッケージ フォルダーに使用するパス。 絶対パスとして指定します。
NUGET_FALLBACK_PACKAGES グローバル フォールバック パッケージ フォルダー。 セミコロン (;) で区切られた絶対フォルダー パス。
NUGET_HTTP_CACHE_PATH 「グローバル パッケージ、キャッシュ、および一時フォルダーを管理する」に記載されているように、http キャッシュ フォルダーに使用するパス。 絶対パスとして指定します。
NUGET_OBSERVE_RETRY_AFTER HTTP 応答メッセージの Retry-After の延期期間の使用をオプトアウトする NuGet 6.5 より前では、NuGet は同じバックオフ戦略で失敗したすべての要求を再試行していました。 NuGet 6.5 以降、NuGet では既定で、サーバーによって指定される Retry-After 延期期間が使用されます。 Retry-After 応答ヘッダーを無視するには、この環境変数を false に設定します。 NUGET_MAX_RETRY_AFTER_DELAY_SECONDS も参照してください
NUGET_RESTORE_MSBUILD_ARGS 追加の MSBuild 引数を設定します。 msbuild.exe に渡す方法と同じように引数を渡します。 コマンド ラインからプロジェクト プロパティ Foo を値 Bar に設定する例は、/p:Foo=Bar です。
NUGET_RETRY_HTTP_429 HTTP 429 応答の再試行ビヘイビアーを変更する NuGet 6.5 より前では、NuGet は 408 で HTTP 429 になる要求を再試行しません。 既定値は true です。この環境変数を false に設定して古い NuGet のビヘイビアー (要求を再試行しない) にオプトインできます
NUGET_RESTORE_MSBUILD_VERBOSITY MSBuild のログの詳細度を設定します。 既定値は quiet ("/v:q") です。 指定できる値は、q[uiet] (なし)、m[inimal] (最小限)、n[ormal] (通常)、d[etailed] (詳細)、diag[nostic] (診断用) です。
NUGET_SHOW_STACK 例外を完全に (スタック トレースを含み) ユーザーに表示するかどうかを決定します。 true または false (既定) として指定されます。
NUGET_UPDATEFILETIME_MAXRETRIES パッケージの抽出時に NuGet がファイルのタイムスタンプの設定を試行する回数を設定します。 Windows では、ウイルス対策ソフトウェアがファイルを一時的に開き、NuGet がタイムスタンプを変更できなくなる可能性があります。 NuGet は指数バックオフを使用します。試行の間の待機時間は Math.Pow(2, retryNumber) になります。 既定の最大再試行回数は 9 です。つまり、既定では失敗するまでの待機時間の合計は約 1 秒です。
NUGET_XMLDOC_MODE アセンブリの XML ドキュメント ファイル抽出の処理方法を決定します。 サポートされているモードは、skip (XML ドキュメント ファイルを抽出しない)、compress (XML ドキュメント ファイルを zip アーカイブとして保存)、または none (既定、XML ドキュメント ファイルを通常のファイルとして扱う) です。
NUGET_CERT_REVOCATION_MODE 署名されたパッケージがインストールまたは復元されたときに、パッケージの署名に使用される証明書の失効ステータス チェックを実行する方法を決定します。 設定しない場合の既定値は online です。 使用可能な値は online (既定)、offline です。 NU3028 に関連
NUGET_ENABLE_ENHANCED_HTTP_RETRY NuGet での拡張 HTTP 再試行を有効または無効にします。 指定できる値は、true (既定値) または falseです。
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT 拡張再試行が有効な場合に HTTP 接続を再試行する最大回数を設定します。 実行する再試行回数を表す数値。既定値は 6 です。
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS 拡張再試行が有効になっているときに HTTP 接続を再試行するまでの待機時間をミリ秒単位で設定します。 待機時間の既定値 (ミリ秒) は 1000 です。
NUGET_EXPERIMENTAL_U Standard Edition_NJ_FOR_FILE_PARSING 復元中にアセット ファイルの解析に Netwonsoft.Json を使用するかどうかを決定します。 指定できる値は true または false (既定値) です。