Partilhar via


Variáveis de ambiente da CLI do NuGet

O comportamento da nuget.exe CLI pode ser configurado por meio de várias variáveis de ambiente, que afetam nuget.exe em todo o computador, usuário ou níveis de processo. As variáveis de ambiente sempre substituem quaisquer configurações em NuGet.Config arquivos, permitindo que os servidores de compilação 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ê achar que nuget.exe se comporta de forma diferente entre computadores diferentes, uma variável de ambiente pode ser a causa. Por exemplo, o Kudu de Aplicativos Web do Azure (usado durante a implantação) NUGET_XMLDOC_MODE definido para pular para acelerar o desempenho da restauração de pacotes e economizar espaço em disco.

A CLI do NuGet usa o MSBuild para ler os arquivos de 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 NuGet pack e restaurar como destinos do MSBuild também pode ser definida como variáveis de ambiente.

Variável Descrição Observações
http_proxy Proxy http usado para operações HTTP do NuGet. Isto 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 Sinalize 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 nas versões 6.5 e superiores. Os valores suportados são nomes de localidade de idiomas do Visual Studio suportados: zh-cn, zh-tw, cs-cz, en-us, es-esfr-fr, de-deit-itja-jpko-krpl-plpt-brru-rue .tr-tr
NUGET_EXE_NO_PROMPT Impede que o exe solicite credenciais. Qualquer valor, exceto null ou empty string, será tratado como este sinalizador set/true.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS Duração máxima entre novas tentativas 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á esperada. 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 da sua máquina 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 null ou empty string, será tratado como este sinalizador set/true.
NUGET_PACKAGES Caminho a ser usado para a pasta global-packages , conforme descrito em Gerenciando os pacotes globais e as pastas de cache. Especificado como caminho absoluto.
NUGET_FALLBACK_PACKAGES Pastas de pacotes de fallback globais. Caminhos de pasta absolutos separados por ponto-e-vírgula (;).
NUGET_HTTP_CACHE_PATH Caminho a ser usado para a pasta http-cache , conforme descrito em Gerenciando os pacotes globais e as pastas de cache. Especificado como caminho absoluto.
NUGET_OBSERVE_RETRY_AFTER Desativação do uso de mensagens de resposta HTTP Retry-After durações de atraso Antes do NuGet 6.5, o NuGet repetia 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 de Retry-After fornecido pelo servidor. Defina essa variável de ambiente para false ignorar o cabeçalho de resposta Retry-After. Ver também NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Define argumentos adicionais do MSBuild. Passe argumentos idênticos aos que você passaria para msbuild.exe. Um exemplo de configuração de uma propriedade de projeto Foo da linha de comando para o valor Bar 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 resultassem em HTTP 429 em 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 repetir a solicitação)
NUGET_RESTORE_MSBUILD_VERBOSITY Define a verbosidade do 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 rastreamento de pilha) deve ser exibida para o usuário. Especificado como verdadeiro ou falso (padrão).
NUGET_UPDATEFILETIME_MAXRETRIES Define o número de vezes que o NuGet tentará definir novamente o carimbo de data/hora do arquivo ao extrair pacotes quando a primeira tentativa falhar. No Windows, o software antivírus pode abrir arquivos temporariamente, 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). O máximo de tentativas padrão é 9, o que significa que a duração total de espera padrão antes da falha será de aproximadamente um segundo.
NUGET_XMLDOC_MODE Determina como a extração do arquivo de documentação XML de assemblies deve ser tratada. Os modos suportados são skip (não extrair arquivos de documentação XML), compactar (armazenar arquivos doc XML como um arquivo zip) ou nenhum (padrão, tratar arquivos doc XML como arquivos regulares).
NUGET_CERT_REVOCATION_MODE Determina como a verificação do status de revogação do certificado usado para assinar um pacote é executada quando um pacote assinado é instalado ou restaurado. Quando não estiver definido, o padrão será online. Valores possíveis online (padrão), offline. Relacionados com 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 avançadas são habilitadas. Um número que representa quantas tentativas repetidas executar, o valor padrão é 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Configura a quantidade de tempo de espera em milissegundos antes de tentar novamente uma conexão HTTP quando as novas tentativas avançadas estão habilitadas. Número de millseconds a esperar, o valor padrão é 1000.