일반적인 NuGet 구성

  • 아티클

NuGet의 동작은 솔루션(솔루션이 사용되지 않는 경우 프로젝트), 사용자 및 컴퓨터 수준과 같은 솔루션에 존재할 수 있는 하나 이상의 NuGet.Config (XML) 파일에서 누적된 설정에 의해 좌우됩니다. 특히 전역 NuGetDefaults.Config 파일은 패키지 원본도 구성합니다. 설정은 CLI, 패키지 관리자 콘솔 및 패키지 관리자 UI에서 실행되는 모든 명령에 적용됩니다.

Config 파일 위치 및 사용

범위 NuGet.Config 파일 위치 설명
솔루션 현재 폴더(솔루션 폴더) 또는 드라이브 루트까지의 모든 폴더. 솔루션 폴더에서는 하위 폴더의 모든 프로젝트에 설정이 적용됩니다. 구성 파일이 프로젝트 폴더에 있는 경우에는 해당 프로젝트에 영향을 주지 않습니다. 명령줄에서 프로젝트를 복원할 때 프로젝트의 디렉터리가 솔루션 디렉터리로 처리되므로 프로젝트와 솔루션을 복원할 때 동작이 달라질 수 있습니다.
사용자 Windows:%appdata%\NuGet\NuGet.Config
Mac/Linux:~/.config/NuGet/NuGet.Config 또는 ~/.nuget/NuGet/NuGet.Config (도구에 따라 다름)
모든 플랫폼에서 추가 구성이 지원됩니다. 해당 구성은 도구로 편집할 수 없습니다.
Windows:%appdata%\NuGet\config\*.Config
Mac/Linux:~/.config/NuGet/config/*.config 또는 ~/.nuget/config/*.config		 설정 모든 작업에 적용되지만 솔루션 수준 설정에서 재정의됩니다.
컴퓨터 Windows:%ProgramFiles(x86)%\NuGet\Config
Mac/Linux:/etc/opt/NuGet/Config (Linux) 또는 /Library/Application Support (Mac) 기본적으로. null도 비어 $NUGET_COMMON_APPLICATION_DATA/NuGet/Config 있지도 않으면 $NUGET_COMMON_APPLICATION_DATA 대신		 설정 컴퓨터의 모든 작업에 적용되지만 사용자 또는 솔루션 수준 설정에 의해 재정의됩니다.

참고 항목

Mac/Linux에서 사용자 구성 파일 위치는 도구에 따라 다릅니다. .NET CLI는 폴더를 사용하고 ~/.nuget/NuGet Mono는 폴더를 사용합니다 ~/.config/NuGet .

Mac/Linux에서 사용자 수준 구성 파일 위치는 도구에 따라 다릅니다.

Mac/Linux에서 사용자 구성 파일 위치는 도구에 따라 다릅니다. 대부분의 사용자는 폴더 아래에서 ~/.nuget/NuGet 사용자 구성 파일을 찾는 도구를 사용합니다. 이러한 다른 도구는 폴더 아래에 있는 사용자 구성 파일을 찾습니다 ~/.config/NuGet .

  • Mono
  • NuGet.exe
  • Mac용 Visual Studio 2019(및 이전 버전)
  • 클래식 Mono 프로젝트에서 작업하는 경우에만 Mac용 Visual Studio 2022 이상 버전입니다.

사용하는 도구에 두 위치가 모두 포함된 경우 다음 단계에 따라 통합하여 하나의 사용자 수준 구성 파일만 사용할 수 있도록 하는 것이 좋습니다.

  1. 두 사용자 수준 구성 파일의 내용을 확인하고 폴더 아래에 ~/.nuget/NuGet 원하는 구성 파일을 유지합니다.
  2. 기호 링크를 다음으로 ~/.nuget/NuGet~/.config/NuGet설정합니다. 예: bash 명령 실행: ln -s ~/.nuget/NuGet ~/.config/NuGet.

이전 버전의 NuGet에 대한 참고 사항:

  • NuGet 3.3 및 이전 버전에서는 솔루션 수준 설정에 대해 .nuget 폴더를 사용했습니다. 이 폴더는 NuGet 3.4 이상에서 사용되지 않습니다.
  • NuGet 2.6~3.x에서 Windows의 컴퓨터 수준 구성 파일은 {IDE}가 VisualStudio일 수 있는 %ProgramData%\NuGet\Config[\{IDE}[\{Version}[\{SKU}]]]\NuGet.Config에 있었으며, {Version}은 14.0과 같은 Visual Studio 버전이었고, {SKU}는 Community, Pro 또는 Enterprise 중 하나였습니다. 설정을 NuGet 4.0 이상으로 마이그레이션하려면 구성 파일을 %ProgramFiles(x86)%\NuGet\Config에 복사하기만 하면 됩니다. 이 이전 위치는 Linux의 경우 /etc/opt이며 Mac의 경우 /Library/Application Support입니다.

구성 설정 변경

NuGet.Config 파일은 NuGet 구성 설정 항목에서 설명한 대로 키/값 쌍을 포함한 간단한 XML 텍스트 파일입니다.

설정은 NuGet CLI config 명령을 사용하여 관리됩니다.

  • 기본적으로 사용자 수준 구성 파일이 변경됩니다. (Mac/Linux에서 사용자 수준 구성 파일의 위치는 도구에 따라 다름)
  • 다른 파일의 설정을 변경하려면 -configFile 스위치를 사용합니다. 이 경우 파일은 모든 파일 이름을 사용할 수 있습니다.
  • 키는 항상 대/소문자를 구분합니다.
  • 컴퓨터 수준 설정 파일의 설정을 변경하려면 권한 상승이 필요합니다.

Warning

텍스트 편집기에서 파일을 수정할 수 있지만, NuGet(v3.4.3 이상)은 잘못된 XML(일치하지 않는 태그, 잘못된 인용 부호 등)이 포함된 경우 전체 구성 파일을 자동으로 무시합니다. 따라서 nuget config를 사용하여 설정을 관리하는 것이 좋습니다.

값 설정

Windows:

# Set repositoryPath in the user-level config file
nuget config -set repositoryPath=c:\packages 

# Set repositoryPath in solution-level files
nuget config -set repositoryPath=c:\packages -configfile c:\my.Config
nuget config -set repositoryPath=c:\packages -configfile .\myApp\NuGet.Config

# Set repositoryPath in the computer-level file (requires elevation)
nuget config -set repositoryPath=c:\packages -configfile %ProgramFiles(x86)%\NuGet\Config\NuGet.Config

Mac/Linux:

# Set repositoryPath in the user-level config file
nuget config -set repositoryPath=/home/packages 

# Set repositoryPath in solution-level files
nuget config -set repositoryPath=/home/projects/packages -configfile /home/my.Config
nuget config -set repositoryPath=/home/packages -configfile home/myApp/NuGet.Config

# Set repositoryPath in the computer-level file (requires elevation)
nuget config -set repositoryPath=/home/packages -configfile $XDG_DATA_HOME/NuGet.Config

참고 항목

NuGet 3.4 이상에서는 repositoryPath=%PACKAGEHOME%(Windows) 및 repositoryPath=$PACKAGEHOME(Mac/Linux)과 같이 모든 값에 환경 변수를 사용할 수 있습니다.

값 제거

값을 제거하려면 빈 값이 있는 키를 지정합니다.

# Windows
nuget config -set repositoryPath= -configfile c:\my.Config

# Mac/Linux
nuget config -set repositoryPath= -configfile /home/my.Config

새 구성 파일 만들기

아래 템플릿을 새 파일에 복사한 다음 nuget config -configFile <filename>을 사용하여 값을 설정합니다.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
</configuration>

설정 적용 방법

여러 NuGet.Config 파일을 사용하면 설정을 여러 위치에 저장하여 단일 솔루션 또는 솔루션 그룹에 적용할 수 있습니다. 이러한 설정은 명령줄 또는 Visual Studio에서 호출된 NuGet 작업에 전체적으로 적용되며 솔루션 또는 현재 폴더에 "가장 가까운" 설정이 우선적으로 적용됩니다. 솔루션 파일이 아닌 프로젝트 파일에서 명령줄 도구를 사용하는 경우 프로젝트 디렉터리가 "솔루션 디렉터리"로 사용되므로 솔루션 파일의 하위 디렉터리에 파일이 있을 때 일관성 없는 NuGet.Config 동작이 발생할 수 있습니다.

특히 NuGet은 다음과 같은 순서로 다른 구성 파일의 설정을 로드합니다.

  1. NuGetDefaults.Config 파일(패키지 원본에만 관련된 설정이 포함되어 있음)
  2. 컴퓨터 수준 파일
  3. 사용자 수준 파일
  4. -configFile로 지정된 파일
  5. 드라이브 루트에서 현재 폴더(호출되는 위치 nuget.exe 또는 Visual Studio 솔루션이 포함된 폴더)로 경로의 모든 폴더에 있는 파일입니다. 예를 들어 명령이 c:\A\B\C에서 호출되면 NuGet은 c:\, c:\A, c:\A\B 및 마지막으로 c:\A\B\C에서 구성 파일을 찾아 로드합니다.

NuGet은 이러한 파일에서 설정을 찾으면 다음과 같이 적용합니다.

  1. 단일 항목 요소의 경우 NuGet은 동일한 키에 대해 이전에 찾은 값을 바꿉니다. 즉, 현재 폴더 또는 솔루션에 "가장 가까운" 설정은 이전에 찾은 다른 설정을 재정의합니다. 예를 들어 NuGetDefaults.Config의 defaultPushSource 설정은 다른 설정 파일에 있는 경우 재정의됩니다.
  2. 컬렉션 요소(예: <packageSources>)의 경우 NuGet은 모든 구성 파일의 값을 단일 컬렉션으로 결합합니다.
  3. 지정된 노드에 대해 <clear />가 있으면 NuGet은 해당 노드에 대해 이전에 정의된 구성 값을 무시합니다.

팁

nuget.config 솔루션 리포지토리의 루트에 파일을 추가합니다. 이는 반복성을 촉진하고 다른 사용자가 동일한 NuGet 구성을 갖도록 함에 따라 모범 사례로 간주됩니다.

설정 연습

두 개의 개별 드라이브에 다음과 같은 폴더 구조가 있다고 가정해 보겠습니다.

disk_drive_1
    User
disk_drive_2
    Project1
        Source
    Project2
        Source
    tmp

다음으로, 지정된 내용이 포함된 4개의 NuGet.Config 파일이 다음 위치에 있습니다. (컴퓨터 수준 파일은 이 예제에 포함되어 있지 않지만 사용자 수준 파일과 비슷하게 작동합니다.)

파일 A - 사용자 수준 파일(Windows의 경우 %appdata%\NuGet\NuGet.Config, Mac/Linux의 경우 ~/.config/NuGet/NuGet.Config):

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <activePackageSource>
        <add key="NuGet official package source" value="https://api.nuget.org/v3/index.json" />
    </activePackageSource>
</configuration>

파일 B - disk_drive_2/NuGet.Config:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <config>
        <add key="repositoryPath" value="disk_drive_2/tmp" />
    </config>
    <packageRestore>
        <add key="enabled" value="True" />
    </packageRestore>
</configuration>

파일 C - disk_drive_2/Project1/NuGet.Config:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <config>
        <add key="repositoryPath" value="External/Packages" />
        <add key="defaultPushSource" value="https://MyPrivateRepo/ES/api/v2/package" />
    </config>
    <packageSources>
        <clear /> <!-- ensure only the sources defined below are used -->
        <add key="MyPrivateRepo - ES" value="https://MyPrivateRepo/ES/nuget" />
    </packageSources>
</configuration>

파일 D - disk_drive_2/Project2/NuGet.Config:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <packageSources>
        <!-- Add this repository to the list of available repositories -->
        <add key="MyPrivateRepo - DQ" value="https://MyPrivateRepo/DQ/nuget" />
    </packageSources>
</configuration>

그런 다음 NuGet은 호출된 위치에 따라 다음과 같이 설정을 로드하고 적용합니다.

  • disk_drive_1/users에서 호출됨: disk_drive_1에 있는 유일한 파일이기 때문에 사용자 수준 구성 파일 (A)에 나열된 기본 리포지토리만 사용됩니다.

  • disk_drive_2/ 또는 disk_drive_/tmp에서 호출됨: 사용자 수준 파일 (A)가 먼저 로드된 다음 NuGet에서 disk_drive_2의 루트로 이동하여 파일 (B)를 찾습니다. 또한 NuGet은 /tmp에 있는 구성 파일을 찾지만 하나도 찾을 수 없습니다. 따라서 nuget.org의 기본 리포지토리가 사용되고, 패키지 복원을 사용하도록 설정되고, 패키지가 disk_drive_2/tmp로 확장됩니다.

  • disk_drive_2/Project1 또는 disk_drive_2/Project1/Source에서 호출됨: 사용자 수준 파일 (A)가 먼저 로드된 다음 disk_drive_2의 루트에서 NuGet 로드 파일 (B)가 로드된 후 파일 (C)가 로드됩니다. (B) 및 (A) 설정을 (C) 설정이 재정의하므로 패키지가 설치되는 repositoryPath가 disk_drive_2/tmp 대신 disk_drive_2/Project1/External/Packages가 됩니다. 또한 (C)에서 <packageSources>를 지우므로 https://MyPrivateRepo/ES/nuget만 남아 있는 nuget.org는 더 이상 원본으로 사용할 수 없습니다.

  • disk_drive_2/Project2 또는 disk_drive_2/Project2/Source에서 호출됨: 사용자 수준 파일 (A)가 먼저 로드된 다음 파일 (B) 및 (D)가 로드됩니다. packageSources를 지우지 않으므로 nuget.org와 https://MyPrivateRepo/DQ/nuget은 모두 원본으로 사용할 수 있습니다. 패키지는 (B)에서 지정한 대로 disk_drive_2/tmp로 확장됩니다.

추가 사용자 수준 구성

5.7부터 NuGet에서는 추가 사용자 수준 구성 파일을 추가로 지원합니다. 따라서 타사 공급업체가 권한 상승 없이 사용자 구성 파일을 추가할 수 있습니다. 해당 구성 파일은 config 하위 폴더 내의 표준 사용자 수준 구성 폴더에 있습니다. .config 또는 .Config로 끝나는 모든 파일을 고려하며 해당 파일은 표준 도구로 편집할 수 없습니다.

OS Platform 추가 구성
Windows %appdata%\NuGet\config\*.Config
Mac/Linux ~/.config/NuGet/config/*.config 또는 ~/.nuget/config/*.config

NuGet 기본 파일

패키지가 설치되고 업데이트되는 패키지 원본을 지정하고 nuget push를 사용하여 패키지를 게시하기 위한 기본 대상을 제어하기 위해 NuGetDefaults.Config 파일이 존재합니다. 관리자는 개발자와 빌드 컴퓨터에 일관된 NuGetDefaults.Config 파일을 편리하게(예: 그룹 정책 사용) 배포할 수 있으므로, 조직의 모든 사용자가 nuget.org가 아닌 올바른 패키지 소스를 사용하도록 할 수 있습니다.

Important

NuGetDefaults.Config 파일은 개발자의 NuGet 구성에서 패키지 원본이 제거되지 않도록 합니다. 즉 개발자가 이미 NuGet을 사용하고 있고 이에 따라 등록된 nuget.org 패키지 원본이 있는 경우 NuGetDefaults.Config 파일을 만든 후에도 패키지 원본이 제거되지 않습니다.

또한 NuGetDefaults.Config NuGet의 다른 메커니즘도 nuget.org 같은 패키지 원본에 대한 액세스를 방지할 수 없습니다. 조직에서 이러한 액세스를 차단하려는 경우 방화벽과 같은 다른 방법을 사용해야 합니다.

NuGetDefaults.Config 위치

다음 표에서는 대상 OS에 따라 NuGetDefaults.Config 파일을 저장해야 하는 위치를 설명합니다.

OS Platform NuGetDefaults.Config 위치
Windows Visual Studio 2017 또는 NuGet 4.x 이상:%ProgramFiles(x86)%\NuGet
Visual Studio 2015 이하 또는 NuGet 3.x 이하:%PROGRAMDATA%\NuGet
Mac/Linux $XDG_DATA_HOME(일반적으로 OS 배포에 따라 ~/.local/share 또는 /usr/local/share)

NuGetDefaults.Config 설정

  • packageSources: 이 컬렉션은 일반 설정 파일에서 packageSources와 동일한 의미를 가지며, 기본 원본을 지정합니다. NuGet은 packages.config 관리 형식을 사용하는 프로젝트에서 패키지를 설치하거나 업데이트할 때 소스를 순서대로 사용합니다. PackageReference 형식을 사용하는 프로젝트의 경우, NuGet은 구성 파일의 순서에 관계없이 로컬 소스를 먼저 사용하고, 네트워크 공유의 소스를 사용한 후, HTTP 소스를 사용합니다. NuGet은 복원 작업에서 소스 순서를 항상 무시합니다.

  • disabledPackageSources: 이 컬렉션은 NuGet.Config 파일과 동일한 의미를 가지며, 영향을 받는 각 원본이 이름 및 사용하지 않도록 설정되어 있는지 여부를 나타내는 true/false 값으로 나열됩니다. 이렇게 하면 원본 이름과 URL이 기본적으로 설정되지 않고 packageSources에 남아 있게 됩니다. 개별 개발자는 올바른 URL을 다시 찾지 않고도 다른 NuGet.Config 파일에서 원본의 값을 false로 설정하여 원본을 사용하도록 다시 설정할 수 있습니다. 또한 이는 기본적으로 개별 팀의 원본만 사용하도록 설정하면서 개발자에게 조직의 내부 원본 URL에 대한 전체 목록을 제공하는 데에도 유용합니다.

  • defaultPushSource: nuget push 작업에 대한 기본 대상을 지정하여 nuget.org의 기본 제공된 기본값을 재정의합니다. 개발자는 특히 nuget push -Source를 사용하여 nuget.org에 게시해야 하므로 관리자가 이 설정을 배포하여 실수로 내부 패키지를 공용 nuget.org에 게시하지 않도록 방지할 수 있습니다.

예제 NuGetDefaults.Config 및 애플리케이션

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- defaultPushSource key works like the 'defaultPushSource' key of NuGet.Config files. -->
    <!-- This can be used by administrators to prevent accidental publishing of packages to nuget.org. -->
    <config>
        <add key="defaultPushSource" value="https://contoso.com/packages/" />
    </config>

    <!-- Default Package Sources; works like the 'packageSources' section of NuGet.Config files. -->
    <!-- This collection cannot be deleted or modified but can be disabled/enabled by users. -->
    <packageSources>
        <add key="Contoso Package Source" value="https://contoso.com/packages/" />
        <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
    </packageSources>

    <!-- Default Package Sources that are disabled by default. -->
    <!-- Works like the 'disabledPackageSources' section of NuGet.Config files. -->
    <!-- Sources cannot be modified or deleted either but can be enabled/disabled by users. -->
    <disabledPackageSources>
        <add key="nuget.org" value="true" />
    </disabledPackageSources>
</configuration>