NuGet CLI ortam değişkenleri

  • Makale

nuget.exe CLI'sinin davranışı, bilgisayar genelinde, kullanıcı veya işlem düzeylerindeki nuget.exe etkileyen bir dizi ortam değişkeni aracılığıyla yapılandırılabilir. Ortam değişkenleri her zaman dosyalardaki NuGet.Config ayarları geçersiz kılar ve derleme sunucularının herhangi bir dosyayı değiştirmeden uygun ayarları değiştirmesine olanak tanır.

Genel olarak, doğrudan komut satırında veya NuGet yapılandırma dosyalarında belirtilen seçenekler önceliklidir, ancak FORCE_NUGET_EXE_INTERACTIVE gibi birkaç özel durum vardır. nuget.exe farklı bilgisayarlar arasında farklı davrandığını fark ederseniz, bunun nedeni ortam değişkeni olabilir. Örneğin Azure Web Apps Kudu (dağıtım sırasında kullanılır), paket geri yükleme performansını hızlandırmak ve disk alanından tasarruf etmek için NUGET_XMLDOC_MODE ayarlanmıştır.

NuGet CLI, proje dosyalarını okumak için MSBuild kullanır. MsBuild değerlendirmesi sırasında tüm ortam değişkenleri özellik olarak kullanılabilir. NuGet paketinde belgelenen özelliklerin listesi ve MSBuild hedefleri olarak geri yükleme ortam değişkenleri olarak da ayarlanabilir.

Değişken Açıklama Açıklamalar
http_proxy NuGet HTTP işlemleri için kullanılan http proxy'si. Bu, olarak http://<username>:<password>@proxy.combelirtilebilir.
no_proxy Etki alanlarını proxy'yi kullanmaktan atlayacak şekilde yapılandırılır. Virgülle (,) ayrılmış etki alanları olarak belirtilir.
EnableNuGetPackageRestore Geri yüklemede paket için gerekliyse NuGet'in örtük olarak onay vermesi gerekiyorsa için bayrağı. Belirtilen bayrak true veya 1 olarak değerlendirilir; diğer tüm değerler bayrak olarak değerlendirilmez.
NUGET_CLI_LANGUAGE Çıkış dilini nuget.exe değiştirir 6.5 ve üzeri sürümlerde kullanılabilir. Desteklenen değerler desteklenen Visual Studio dillerinin yerel ayar adlarıdır: zh-cn, zh-tw, cs-cz, en-us, es-es, , fr-frde-de, , it-itja-jp, , ko-kr, pl-pl, pt-br, ru-ruve tr-tr.
NUGET_EXE_NO_PROMPT Exe'nin kimlik bilgilerini istemesini engeller. Null veya boş dize dışındaki tüm değerler bu bayrak kümesi/true olarak kabul edilir.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS HTTP yanıtı Retry-After üst bilgisini içerdiğinde yeniden denemeler arasındaki en uzun süre NUGET_OBSERVE_RETRY_AFTER etkinleştirildiğinde (varsayılan olarak olduğu gibi) ve HTTP yanıtı yeniden deneme sonrası üst bilgisi içerdiğinde, bu ortam değişkeni beklenecek en uzun süreyi ayarlar. Retry-After işlevinin bir süre (delta) veya zaman damgası (tarih) sağlayabileceğini unutmayın. Sunucu bir zaman damgası döndürürse ve makinenizin saati sunucuyla eşitlenmemişse, hesaplanan süre çok uzun (veya negatif) olabilir.
FORCE_NUGET_EXE_INTERACTIVE Etkileşimli modu zorlamak için genel ortam değişkeni. Null veya boş dize dışındaki tüm değerler bu bayrak kümesi/true olarak kabul edilir.
NUGET_PACKAGES Genel paketleri ve önbellek klasörlerini yönetme konusunda açıklandığı gibi genel paketler klasörü için kullanılacak yol. Mutlak yol olarak belirtilir.
NUGET_FALLBACK_PACKAGES Genel geri dönüş paketleri klasörleri. Noktalı virgülle ayrılmış mutlak klasör yolları (;).
NUGET_HTTP_CACHE_PATH Genel paketleri ve önbellek klasörlerini yönetme konusunda açıklandığı gibi http-cache klasörü için kullanılacak yol. Mutlak yol olarak belirtilir.
NUGET_OBSERVE_RETRY_AFTER HTTP yanıt iletisini kullanmayı geri çevirme-Gecikme sürelerinden sonra yeniden deneme NuGet 6.5'in öncesinde, NuGet aynı geri yükleme stratejisine sahip tüm başarısız istekleri yeniden denerdi. NuGet 6.5'den başlayarak, NuGet varsayılan olarak sunucu tarafından sağlanan Yeniden Deneme Sonrası gecikme süresini kullanır. Retry-After yanıt üst bilgisini yoksaymak için bu ortam değişkenini false olarak ayarlayın. Ayrıca bkz. NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Ek MSBuild bağımsız değişkenlerini ayarlar. Bunları msbuild.exe geçirme yöntemiyle aynı bağımsız değişkenleri geçirin. Komut satırından Foo proje özelliğini Çubuk değerine ayarlama örneği /p:Foo=Bar olabilir
NUGET_RETRY_HTTP_429 HTTP 429 yanıtlarında yeniden deneme davranışını değiştirme NuGet 6.5'in öncesinde NuGet, 408'de HTTP 429'a neden olan istekleri yeniden denemez. Varsayılan değerdir trueve bu ortam değişkeni eski NuGet davranışını kabul etmek için ayarlanabilir false (isteği yeniden denemeyin)
NUGET_RESTORE_MSBUILD_VERBOSITY MSBuild günlük ayrıntı düzeyini ayarlar. Varsayılan değer sessizdir ("/v:q"). Olası q[uiet], m[inimal], n[ormal], d[etailed] ve diag[nostic] değerleri.
NUGET_SHOW_STACK Kullanıcıya tam özel durumun (yığın izleme dahil) görüntülenip görüntülenmeyeceğini belirler. True veya false (varsayılan) olarak belirtilir.
NUGET_UPDATEFILETIME_MAXRETRIES NuGet'in paketleri ayıklarken dosya zaman damgasını ayarlamayı deneyeceği zamanı ayarlar. Windows virüsten koruma yazılımı dosyaları geçici olarak açarak NuGet'in zaman damgasını değiştirmesini engelleyebilir. NuGet, denemeler Math.Pow(2, retryNumber)arasındaki bekleme süresinin olduğu üstel bir geri alma kullanır. Varsayılan maksimum yeniden deneme sayısı 9'dur, yani hatadan önceki varsayılan toplam bekleme süresi yaklaşık bir saniye olur.
NUGET_XMLDOC_MODE Derlemeler XML belge dosyası ayıklamanın nasıl işleneceğini belirler. Desteklenen modlar atlanır (XML belge dosyalarını ayıklamaz), sıkıştırılır (XML belge dosyalarını zip arşivi olarak depolar) veya hiçbiri (varsayılan olarak, XML belge dosyalarını normal dosyalar olarak ele alma).
NUGET_CERT_REVOCATION_MODE Bir paketi imzalamak için kullanılan sertifikanın iptal durumu denetiminin, imzalı bir paket yüklendiğinde veya geri yüklendiğinde nasıl gerçekleştirileceğini belirler. Ayarlanmadığında, varsayılan olarak olarak onlineayarlanır. Olası değerler çevrimiçi (varsayılan), çevrimdışı. NU3028 ile ilgili
NUGET_ENABLE_ENHANCED_HTTP_RETRY NuGet'te gelişmiş HTTP yeniden denemesini etkinleştirir veya devre dışı bırakır. Olası değerler (varsayılan) veya falseşeklindedir true .
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Gelişmiş yeniden denemeler etkinleştirildiğinde bir HTTP bağlantısının yeniden denenmesi gereken en fazla kaç kez yeniden denenmesi gerektiğini yapılandırılır. Kaç yeniden deneme yapılacağını gösteren bir sayıdır ve varsayılan değerdir 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Gelişmiş yeniden denemeler etkinleştirildiğinde HTTP bağlantısını yeniden denemeden önce milisaniye cinsinden beklenmesi gereken süreyi yapılandırılır. Beklenen milisaniye sayısı, varsayılan değerdir 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING Geri yükleme sırasında varlık dosyasını ayrıştırma için kullanılıp kullanılmayacağını Netwonsoft.Json belirler Olası değerler true veya false (varsayılan).