NuGet CLI 환경 변수

  • 아티클

nuget.exe CLI의 동작은 컴퓨터 전체, 사용자 또는 프로세스 수준의 nuget.exe 영향을 미치는 여러 환경 변수를 통해 구성할 수 있습니다. 환경 변수는 항상 파일의 NuGet.Config 설정을 재정의하므로 빌드 서버는 파일을 수정하지 않고도 적절한 설정을 변경할 수 있습니다.

일반적으로 명령줄 또는 NuGet 구성 파일에 직접 지정된 옵션이 우선하지만 FORCE_NUGET_EXE_INTERACTIVE 같은 몇 가지 예외가 있습니다. nuget.exe 서로 다른 컴퓨터 간에 다르게 동작하는 경우 환경 변수가 원인일 수 있습니다. 예를 들어 Azure Web Apps Kudu(배포 중에 사용됨)는 패키지 복원 성능의 속도를 향상시키고 디스크 공간을 절약하기 위해 건너뛰도록 NUGET_XMLDOC_MODE 설정되었습니다.

NuGet CLI는 MSBuild를 사용하여 프로젝트 파일을 읽습니다. 모든 환경 변수는 MSBuild 평가 중에 속성으로 사용할 수 있습니다. MSBuild 대상으로 NuGet 팩 및 복원에 설명된 속성 목록을 환경 변수로 설정할 수도 있습니다.

변수 설명 설명
http_proxy NuGet HTTP 작업에 사용되는 Http 프록시입니다. 이 형식은 .로 http://<username>:<password>@proxy.com지정됩니다.
no_proxy 프록시를 사용하지 않도록 do기본s를 구성합니다. 쉼표(,)로 구분된 기본 지정됩니다.
EnableNuGetPackageRestore 복원 시 패키지에 필요한 경우 NuGet이 암시적으로 동의를 부여해야 하는 경우 플래그를 지정합니다. 지정된 플래그는 true 또는 1로 처리되고 다른 값은 플래그로 처리되지 않습니다.
NUGET_CLI_LANGUAGE 출력 언어를 nuget.exe 변경 6.5 이상 버전에서 사용할 수 있습니다. 지원되는 값은 지원되는 Visual Studio 언어 로캘 이름zh-cnpt-brja-jpko-krit-itpl-plru-ruzh-twen-ustr-trcs-czes-esfr-frde-de입니다.
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 전역 패키지 및 캐시 폴더 관리에 설명된 대로 global-packages 폴더에 사용할 경로입니다. 절대 경로로 지정됩니다.
NUGET_FALLBACK_PACKAGES 전역 대체 패키지 폴더입니다. 세미콜론(;)으로 구분된 절대 폴더 경로입니다.
NUGET_HTTP_CACHE_PATH 전역 패키지 및 캐시 폴더 관리에 설명된 대로 http-cache 폴더에 사용할 경로입니다. 절대 경로로 지정됩니다.
NUGET_OBSERVE_RETRY_AFTER HTTP 응답 메시지 다시 시도 후 지연 기간 사용 옵트아웃 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를 설정하는 예제는 /p:Foo=Bar입니다.
NUGET_RETRY_HTTP_429 HTTP 429 응답에 대한 재시도 동작 변경 NuGet 6.5 이전에는 NuGet이 408에서 HTTP 429를 발생시키는 요청을 다시 시도하지 않았습니다. 기본값은 이며 true, 이 환경 변수는 이전 NuGet 동작에 옵트인하도록 설정할 false 수 있습니다(요청을 다시 시도하지 않음).
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 문서 파일 추출을 처리하는 방법을 결정합니다. 지원되는 모드는 건너뛰기 (XML 문서 파일 추출 안 함), 압축 (XML 문서 파일을 zip 보관 파일로 저장) 또는 없음 (기본값, XML 문서 파일을 일반 파일로 처리)입니다.
NUGET_CERT_REVOCATION_MODE 서명된 패키지가 설치되거나 복원될 때 패키지 서명에 사용되는 인증서의 해지 상태 검사 수행하는 방법을 결정합니다. 설정되지 않은 경우 기본값은 .로 설정 online됩니다. 가능한 값 은 온라인 (기본값), 오프라인입니다. 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 연결을 다시 시도하기 전에 대기하는 시간(밀리초)을 구성합니다. 대기할 millseconds의 수, 기본값은 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING 복원하는 동안 자산 파일을 구문 분석하는 데 사용되는지 Netwonsoft.Json 여부를 결정합니다. 가능한 값은 true 또는 false(기본값)입니다.