NuGet CLI-Umgebungsvariablen

  • Artikel

Das Verhalten der nuget.exe CLI kann über eine Reihe von Umgebungsvariablen konfiguriert werden, die sich auf nuget.exe auf computerweiten, Benutzer- oder Prozessebenen auswirken. Umgebungsvariablen setzen alle Einstellungen in NuGet.Config Dateien immer außer Kraft, sodass Buildserver geeignete Einstellungen ändern können, ohne Dateien zu ändern.

Im Allgemeinen haben Optionen, die direkt in der Befehlszeile oder in NuGet-Konfigurationsdateien angegeben sind, Vorrang, aber es gibt einige Ausnahmen wie FORCE_NUGET_EXE_INTERACTIVE. Wenn Sie feststellen, dass nuget.exe sich zwischen verschiedenen Computern anders verhält, könnte eine Umgebungsvariable die Ursache sein. Beispielsweise hat Azure Web-Apps Kudu (während der Bereitstellung verwendet) NUGET_XMLDOC_MODE festgelegt, um die Leistung der Paketwiederherstellung zu beschleunigen und Speicherplatz zu sparen.

Die NuGet CLI verwendet MSBuild zum Lesen der Projektdateien. Alle Umgebungsvariablen sind während der MSBuild-Auswertung als Eigenschaften verfügbar. Die Liste der im NuGet-Paket dokumentierten Eigenschaften und die Wiederherstellung als MSBuild-Ziele können auch als Umgebungsvariablen festgelegt werden.

Variable Beschreibung Notizen
http_proxy Http-Proxy, der für NuGet-HTTP-Vorgänge verwendet wird. Dies würde als http://<username>:<password>@proxy.com angegeben werden.
no_proxy Konfiguriert do Standard s to bypass from using proxy. Wird wie folgt angegeben Standard durch Komma (,) getrennt.
EnableNuGetPackageRestore Kennzeichnen, ob NuGet implizit die Zustimmung erteilen soll, wenn dies für das Paket beim Wiederherstellen erforderlich ist. Angegebene Kennzeichnung wird als "true" oder "1" behandelt, wobei ein anderer Wert, der als Kennzeichnung behandelt wird, nicht festgelegt ist.
NUGET_CLI_LANGUAGE Ändert nuget.exe Ausgabesprache Verfügbar in 6.5 und höheren Versionen. Unterstützte Werte werden von Visual Studio-Sprachen mit Gebietsschemanamen unterstützt: 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, und tr-tr.
NUGET_EXE_NO_PROMPT Verhindert die EXE zum Anfordern von Anmeldeinformationen. Jeder Wert mit Ausnahme von NULL oder leerer Zeichenfolge wird als dieser Flagsatz/true behandelt.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS Maximale Dauer zwischen Wiederholungsversuchen, wenn die HTTP-Antwort den Retry-After-Header enthält Wenn NUGET_OBSERVE_RETRY_AFTER aktiviert ist (wie standardmäßig) und eine HTTP-Antwort einen Retry-After-Header enthält, legt diese Umgebungsvariable die maximale Dauer fest, die gewartet wird. Beachten Sie, dass "Retry-After" entweder eine Dauer (Delta) oder einen Zeitstempel (Datum) bereitstellen kann. Wenn der Server einen Zeitstempel zurückgibt und die Uhr Ihres Computers nicht mit dem Server synchronisiert ist, kann die berechnete Dauer sehr lang (oder negativ) sein.
FORCE_NUGET_EXE_INTERACTIVE Globale Umgebungsvariable, um den interaktiven Modus zu erzwingen. Jeder Wert mit Ausnahme von NULL oder leerer Zeichenfolge wird als dieser Flagsatz/true behandelt.
NUGET_PAKETE Pfad zur Verwendung für den Ordner "Globale Pakete", wie unter "Verwalten der globalen Pakete und Cacheordner" beschrieben. Als absoluter Pfad angegeben.
NUGET_FALLBACK_PACKAGES Ordner für globale Fallbackpakete. Absolute Ordnerpfade getrennt durch Semikolon (;).
NUGET_HTTP_CACHE_PATH Pfad zur Verwendung für den Http-Cache-Ordner, wie unter "Verwalten der globalen Pakete und Cacheordner" beschrieben. Als absoluter Pfad angegeben.
NUGET_OBSERVE_RETRY_AFTER Abmelden der Verwendung der HTTP-Antwortnachricht "Wiederholung nach Verzögerungsdauer" Vor NuGet 6.5 würde NuGet alle fehlgeschlagenen Anforderungen mit derselben Back-Off-Strategie wiederholen. Ab NuGet 6.5 verwendet NuGet standardmäßig den vom Server bereitgestellten Retry-After-Verzögerungszeitraum. Legen Sie diese Umgebungsvariable fest, um den Antwortheader "Retry-After" zu false ignorieren. Siehe auch NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Legt zusätzliche MSBuild-Argumente fest. Übergeben Sie argumente identisch mit der Vorgehensweise, die Sie an msbuild.exe übergeben würden. Ein Beispiel für das Festlegen einer Projekteigenschaft foo aus der Befehlszeile auf die Wertleiste lautet "/p:Foo=Bar"
NUGET_RETRY_HTTP_429 Ändern des Wiederholungsverhaltens für HTTP 429-Antworten Vor NuGet 6.5 würde NuGet keine Anforderungen wiederholen, die zu HTTP 429 auf 408 führen. Der Standardwert ist true, und diese Umgebungsvariable kann so festgelegt werden, dass false sie sich für ein älteres NuGet-Verhalten anmeldet (versuchen Sie die Anforderung nicht erneut)
NUGET_RESTORE_MSBUILD_VERBOSITY Hiermit wird der MSBuild-Ausführlichkeitsgrad festgelegt. Der Standardwert ist ruhig ("/v:q"). Zulässige Werte sind „q[uiet]“, „m[inimal]“, „n[ormal]“, „d[etailed]“ und „diag[nostic]“.
NUGET_SHOW_STACK Bestimmt, ob die vollständige Ausnahme (einschließlich Stapelüberwachung) für den Benutzer angezeigt werden soll. Wird als wahr oder falsch angegeben (Standard).
NUGET_UPDATEFILETIME_MAXRETRIES Legt fest, wie oft NuGet versucht, den Zeitstempel der Datei beim Extrahieren von Paketen festzulegen. Unter Windows-Antivirensoftware können Dateien vorübergehend geöffnet werden, hindern NuGet daran, den Zeitstempel zu ändern. NuGet verwendet ein exponentielles Backoff, bei dem die Wartezeit zwischen den Versuchen Math.Pow(2, retryNumber) ist. Die standardmäßigen maximalen Wiederholungsversuche sind 9, d. h. die Standardmäßige Gesamtwartedauer, bevor der Fehler ungefähr eine Sekunde beträgt.
NUGET_XMLDOC_MODE Bestimmt, wie assemblys XML-Dokumentationsdateiextraktion behandelt werden soll. Unterstützte Modi werden übersprungen (XML-Dokumentationsdateien nicht extrahieren), komprimieren (XML-Dokumentdateien als ZIP-Archiv speichern) oder keine (Standardeinstellung, XML-Dokumentdateien als normale Dateien behandeln).
NUGET_CERT_REVOCATION_MODE Bestimmt, wie die Sperrstatusüberprüfung des Zertifikats, das zum Signieren eines Pakets verwendet wird, ausgeführt wird, wenn ein signiertes Paket installiert oder wiederhergestellt wird. Wenn nicht festgelegt, ist der Standardwert online. Mögliche Werte online (Standard), offline. Im Zusammenhang mit NU3028
NUGET_ENABLE_ENHANCED_HTTP_RETRY Aktiviert oder deaktiviert den erweiterten HTTP-Wiederholungsversuche in NuGet. Mögliche Werte sind: true (Standard) oder false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Konfiguriert, wie oft eine HTTP-Verbindung wiederholt werden soll, wenn erweiterte Wiederholungen aktiviert sind. Eine Zahl, die angibt, wie viele Wiederholungen ausgeführt werden sollen, der Standardwert ist 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Konfiguriert die Wartezeit in Millisekunden, bevor eine HTTP-Verbindung erneut versucht wird, wenn erweiterte Wiederholungen aktiviert sind. Die Standardanzahl der zu wartenden Sekunden beträgt 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING Legt fest, ob Netwonsoft.Json für das Parsen der Ressourcendatei während der Wiederherstellung verwendet wird oder nicht Mögliche Werte sind true oder false (Standardwert).