Compartilhar via


Variáveis de ambiente da CLI do NuGet

O comportamento da CLI nuget.exe pode ser configurado por meio de várias variáveis de ambiente, que afetam nuget.exe em níveis de todo o computador, usuário ou processo. As variáveis de ambiente sempre substituem quaisquer configurações em NuGet.Config arquivos, permitindo que os servidores de build alterem as configurações apropriadas sem modificar nenhum arquivo.

Em geral, as opções especificadas diretamente na linha de comando ou nos arquivos de configuração do NuGet têm precedência, mas há algumas exceções, como FORCE_NUGET_EXE_INTERACTIVE. Se você descobrir que nuget.exe se comporta de forma diferente entre computadores diferentes, uma variável de ambiente pode ser a causa. Por exemplo, o Kudu dos Aplicativos Web do Azure (usado durante a implantação) NUGET_XMLDOC_MODE definido para ignorar para acelerar o desempenho de restauração de pacotes e economizar espaço em disco.

A CLI do NuGet usa o MSBuild para ler os arquivos do projeto. Todas as variáveis de ambiente estão disponíveis como propriedades durante a avaliação do MSBuild. A lista de propriedades documentadas no pacote NuGet e a restauração como destinos do MSBuild também podem ser definidas como variáveis de ambiente.

Variable Description Observações
http_proxy Proxy http usado para operações HTTP do NuGet. Isso seria especificado como http://<username>:<password>@proxy.com.
no_proxy Configura domínios para ignorar o uso de proxy. Especificado como domínios separados por vírgula (,).
EnableNuGetPackageRestore Sinalizar se o NuGet deve conceder consentimento implicitamente se isso for exigido pelo pacote na restauração. O sinalizador especificado é tratado como true ou 1, qualquer outro valor tratado como sinalizador não definido.
NUGET_CLI_LANGUAGE Alterações nuget.exe idioma de saída Disponível em versões 6.5 e superiores. Os valores com suporte têm suporte para nomes de localidade de idiomas do Visual Studio: zh-cn, , zh-tw, cs-cz, en-us, es-es, , de-defr-fr, , it-it, ja-jp, ko-kr, , pl-pl, , pt-br, , , ru-rue tr-tr.
NUGET_EXE_NO_PROMPT Impede que o exe para solicitar credenciais. Qualquer valor, exceto cadeia de caracteres nula ou vazia, será tratado como este conjunto de sinalizadores/true.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS Duração máxima entre repetições quando a resposta HTTP contém Retry-After cabeçalho Quando NUGET_OBSERVE_RETRY_AFTER está habilitado (como é por padrão) e uma resposta HTTP contém um cabeçalho Retry-After, essa variável de ambiente define a duração máxima que será aguardada. Observe que Retry-After pode fornecer uma duração (delta) ou um carimbo de data/hora (data). Se o servidor retornar um carimbo de data/hora e o relógio do computador estiver fora de sincronia com o servidor, a duração calculada poderá ser muito longa (ou negativa).
FORCE_NUGET_EXE_INTERACTIVE Variável de ambiente global para forçar o modo interativo. Qualquer valor, exceto cadeia de caracteres nula ou vazia, será tratado como este conjunto de sinalizadores/true.
NUGET_PACKAGES Caminho a ser usado para a pasta de pacotes globais , conforme descrito no Gerenciamento de pacotes globais e pastas de cache. Especificado como caminho absoluto.
NUGET_FALLBACK_PACKAGES Pastas de pacotes de fallback global. Caminhos de pasta absoluta separados por ponto-e-vírgula (;).
NUGET_HTTP_CACHE_PATH Caminho a ser usado para a pasta http-cache , conforme descrito no Gerenciamento de pacotes globais e pastas de cache. Especificado como caminho absoluto.
NUGET_OBSERVE_RETRY_AFTER Recusar o uso da mensagem de resposta HTTP Retry-After durações de atraso Antes do NuGet 6.5, o NuGet repetiria todas as solicitações com falha com a mesma estratégia de back-off. A partir do NuGet 6.5, o NuGet usará por padrão o período de atraso Retry-After fornecido pelo servidor. Defina essa variável de ambiente para false ignorar o cabeçalho de resposta Retry-After. Veja também NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Define argumentos adicionais do MSBuild. Passe argumentos idênticos a como você os passaria para msbuild.exe. Um exemplo de como definir uma propriedade de projeto Foo da linha de comando para o valor Barra seria /p:Foo=Bar
NUGET_RETRY_HTTP_429 Alterar o comportamento de repetição em respostas HTTP 429 Antes do NuGet 6.5, o NuGet não repetia solicitações que resultam em HTTP 429 no 408. O valor padrão é true, e essa variável de ambiente pode ser definida para false aceitar o comportamento mais antigo do NuGet (não tente novamente a solicitação)
NUGET_RESTORE_MSBUILD_VERBOSITY Define a verbosidade de log do MSBuild. O padrão é silencioso ("/v:q"). Valores possíveis q[uiet], m[inimal], n[ormal], d[etailed], e diag[nostic].
NUGET_SHOW_STACK Determina se a exceção completa (incluindo o rastreamento de pilha) deve ser exibida ao usuário. Especificado como verdadeiro ou falso (padrão).
NUGET_UPDATEFILETIME_MAXRETRIES Define o número de vezes que o NuGet tentará repetir a definição do carimbo de data/hora do arquivo ao extrair pacotes quando a primeira tentativa falhou. No software antivírus do Windows, é possível abrir temporariamente arquivos, impedindo que o NuGet altere o carimbo de data/hora. O NuGet usa um back-off exponencial em que a duração da espera entre as tentativas é Math.Pow(2, retryNumber). As tentativas máximas padrão são 9, o que significa que a duração de espera total padrão antes da falha será de aproximadamente um segundo.
NUGET_XMLDOC_MODE Determina como a extração de arquivos de documentação XML de assemblies deve ser tratada. Os modos com suporte são ignorar (não extrair arquivos de documentação XML), compactar (armazenar arquivos de documentos XML como um arquivo zip) ou nenhum (padrão, tratar arquivos de documentos XML como arquivos regulares).
NUGET_CERT_REVOCATION_MODE Determina como a verificação de status de revogação do certificado usado para assinar um pacote é executada quando um pacote assinado é instalado ou restaurado. Quando não definido, o padrão é online. Valores possíveis online (padrão), offline. Relacionado ao NU3028
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Configura o número máximo de vezes que uma conexão HTTP deve ser repetida quando novas tentativas aprimoradas são habilitadas. Um número que representa quantas tentativas executar, o valor padrão é 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Configura a quantidade de tempo para aguardar em milissegundos antes de tentar novamente uma conexão HTTP quando novas tentativas aprimoradas estiverem habilitadas. Número de millseconds a aguardar, o valor padrão é 1000.