편집

다음을 통해 공유


NuGet.org 질문과 대답

사용 조건

패키지에서 특정 라이선스 정보를 제공하지 않는 경우 기본 사용 조건은 무엇인가요?

각 패키지는 패키지에 포함된 사용 조건이 적용됩니다. 패키지를 액세스, 다운로드 또는 획득하기 전에 해당 사용 조건을 검토해야 합니다. NuGet.org의 패키지 페이지에 있는 라이선스 정보 링크를 사용합니다.

패키지에서 사용 조건을 지정하지 않은 경우 NuGet.org 패키지 페이지의 연락처 소유자 링크를 사용하여 패키지 소유자에게 직접 문의해 보세요. Microsoft는 타사 패키지 공급자로부터 사용자에게 지적 재산권을 부여하지 않으며 타사에서 제공한 정보에 대해 책임을 지지 않습니다.

NuGet.org의 패키지 관리

패키지 메타데이터를 업로드한 후에 편집할 수 있나요?

NuGet은 모든 패키지에 서명을 권장합니다. 패키지 서명의 디자인 원칙은 nuspec을 포함한 서명된 패키지 콘텐츠를 변경할 수 없다는 것입니다. 패키지 메타데이터를 편집하면 nuspec이 변경되고 기존 서명이 무효화됩니다. 패키지를 만든 후에 패키지 메타데이터를 편집할 필요가 없도록 기존 워크플로를 수정하는 것이 좋습니다.

패키지에 대해 나열된 종속성은 패키지 자체에서 자동으로 생성되며 편집할 수 없습니다.

또한 int.nugettest.org에 패키지를 업로드하는 것은 공용 갤러리에서 패키지를 사용하지 않고도 패키지를 테스트하고 유효성을 검사할 수 있는 좋은 방법입니다. API 엔드포인트: https://apiint.nugettest.org/v3/index.json

NuGet.org에 게시된 패키지를 삭제할 수 있나요?

일반적으로 NuGet.org 게시된 패키지는 삭제할 수 없습니다. 패키지 삭제에 대한 정책에 대해 자세히 알아보세요.

나중에 게시되는 패키지의 이름을 예약할 수 있나요?

예. 계정에 대한 패키지 ID 접두사를 요청하여 NuGet.org에서 패키지 ID를 예약할 수 있습니다. 패키지 ID 접두사를 요청하려면 설명서의 지침을 따르세요.

패키지 소유권을 주장하려면 어떻게 할까요?

소프트웨어 라이선스를 위반하는 패키지 소유자를 처리하려면 어떻게 할까요?

NuGet 커뮤니티에서 패키지 소유자와 다른 소프트웨어 소유자 간에 발생할 수 있는 분쟁을 해결하기 위해 함께 노력하는 것이 좋습니다. NuGet.org 관리자에게 중재를 요청하기 전에 따라야 할 분쟁 해결 절차가 마련되어 있습니다.

내 테스트 패키지를 NuGet.org에 업로드하는 것이 좋을까요?

테스트를 위해 int.nugettest.org 또는 대체 공용 NuGet 서버(예: myget.org 또는 Azure DevOps)를 사용할 수 있습니다.

int.nugettest.org에 업로드된 패키지는 유지되지 않을 수 있습니다.

NuGet.org에 업로드할 수 있는 패키지의 최대 크기는 무엇인가요?

NuGet.org는 최대 250MB의 패키지를 허용하지만, 가능한 한 패키지를 1MB 미만으로 유지하고 종속성을 사용하여 패키지를 함께 연결하는 것이 좋습니다. 경험상 패키지는 충돌을 방지하기 위해 하나의 어셈블리만 포함합니다.

NuGet은 HTTP를 사용하여 패키지를 다운로드하므로, 큰 패키지는 작은 패키지보다 설치에 실패할 가능성이 높습니다.

여러 패키지 간에 종속성을 공유하여 NuGet 패키지의 소비자에 대한 전체 다운로드 크기를 줄일 수 있습니다.

종속성은 대부분 정적이며 변경되지 않습니다. 코드에서 버그를 수정하는 경우 종속성을 업데이트할 필요가 없을 수도 있습니다. 종속성을 번들로 제공하면 매번 더 큰 패키지를 다시 전달하게 됩니다. NuGet 패키지를 관련 종속성으로 분할하면 패키지 소비자가 훨씬 더 세부적으로 업그레이드할 수 있습니다.

NuGet.org에 액세스할 수 없음

어떤 SSL/TLS 버전 및 암호화 제품군이 NuGet.org 지원하나요?

NuGet.org TLS 1.2 및 다음 암호 그룹을 지원합니다.

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

NuGet.org 패키지를 복원할 수 없는 이유는 무엇인가요?

NuGet.org 패키지를 복원할 때 일시적인 오류가 발생하는 경우 다음을 권장합니다.

  • 더 나은 복원력 지원을 통해 최신 버전의 NuGet 클라이언트를 사용합니다.
  • NuGet 클라이언트의 환경 변수를 사용하여 CI 머신의 재시도 정책을 향상시킵니다.
환경 변수 설명 설명
NUGET_ENABLE_ENHANCED_HTTP_RETRY NuGet에서 향상된 HTTP 재시도를 사용하거나 사용하지 않도록 설정합니다. 가능한 값은 true (.NET CLI 6.0.300, NuGet CLI 6.2, Visual Studio 2022 버전 17.2 이후 기본값) 또는 false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT 향상된 재시도를 사용하도록 설정할 때 HTTP 연결을 다시 시도해야 하는 최대 횟수를 구성합니다. 수행할 재시도 횟수를 나타내는 숫자로, 기본값은 .입니다 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS 향상된 재시도를 사용하도록 설정할 때 HTTP 연결을 다시 시도하기 전에 대기하는 시간(밀리초)을 구성합니다. 대기할 millseconds의 수, 기본값은 1000.

참고 항목

이러한 환경 변수는 .NET CLI(.NET SDK) 6.0.100, NuGet CLI 6.0, Visual Studio 2022 버전 17.0 및 해당 MSBuild 버전부터 사용할 수 있습니다. NuGet 릴리스 정보를 참조하세요.

Important

NuGet.org Alpine Linux 사용자에게 Alpine Linux 3.18.0 이상으로 업그레이드할 것을 권장합니다. 이러한 버전은 DNS 확인자에서 TCP 대체를 지원합니다. UDP를 통해서만 DNS를 지원하는 이전 버전의 Alpine Linux를 사용하는 경우 V3 API액세스할 때 DNS 오류가 발생할 수 있습니다.

해당 버전의 NuGet 클라이언트가 계속 실패 하는 경우 지원에 문의하고 다음을 비롯한 추가 연결 문제 해결 정보를 제공합니다.

  • 사용 중인 패키지 원본
  • 사용 중인 NuGet 클라이언트의 버전
  • 자세한 세부 정보가 있는 복원 로그
  • MTR 또는 Fiddler 추적(아래 참조)
  • 사용자의 지리적 지역
  • 머신이 프록시 또는 방화벽 뒤에 있는지 여부는?
  • 머신이 클라우드 공급 기업의 데이터 센터(Azure, AWS 등)에 위치해 있나요? 그렇다면 공급 기업 및 지역의 이름을 제공하세요.

MTR을 캡처하려면:

  • WinMTR을 다운로드합니다.

  • 호스트 이름으로 api.nuget.org를 입력하고 시작을 클릭합니다.

  • 보냄 열이 100개 이상이 될 때까지 기다립니다.

    캡처 중인 MTR

  • 클립보드에 텍스트를 복사합니다.

Fiddler를 캡처하려면:

  • 최신 버전의 Fiddler를 설치합니다.
  • Fiddler를 시작하고 파일 > 트래픽 캡처 메뉴를 사용하여 트래픽 캡처를 사용하지 않도록 설정합니다.
  • 모든 세션을 제거합니다(목록에서 모든 항목을 선택하고 삭제 키를 누름).
  • 도구 > Fiddler 옵션... 메뉴의 HTTPS 탭에서 HTTPS 트래픽 해독을 선택하여 HTTPS 트래픽을 캡처하도록 Fiddler를 구성합니다.
  • Visual Studio를 닫습니다.
  • 파일 > 트래픽 캡처 메뉴를 사용하도록 설정합니다.
  • Visual Studio 또는 nuget.exe .exe를 시작하고 작동하지 않는 작업을 수행합니다. 이러한 작업으로 생성된 트래픽이 Fiddler에 표시됩니다.
  • 작업이 실행되면 파일 > 저장 > 모든 세션을 사용하여 캡처된 세션을 저장합니다.

참고: Fiddler를 통해 NuGet 트래픽을 라우팅하기 위해 HTTP_PROXY 환경 변수를 http://127.0.0.1:8888로 설정해야 할 수도 있습니다.

실패하면 StackOverflow 게시물에서 언급한 팁을 사용해 보세요.

NuGet.org 계정 관리

NuGet.org 암호 로그인을 복구하려면 어떻게 하나요?

NuGet.org 암호 로그인이 중단되었습니다. 안타깝게도 암호 계정을 복구할 방법이 NuGet.org MSA(개인 Microsoft 계정) 또는 AAD(Azure Active Directory) 계정으로만 NuGet.org 로그인할 수 있습니다.

Microsoft 로그인 을 사용할 수 없는 경우 단계에 따라 NuGet.org 계정을 복구하세요.

이메일을 support@nuget.org보내 패키지 소유권을 다른 계정으로 이전하는 데 도움이 필요한지 알려주세요.

어떤 Microsoft 계정이 내 NuGet.org 계정에 연결되어 있나요?

NuGet.org 계정과 연결된 Microsoft 계정을 잊어버린 경우 아래 단계를 따르면 지원을 받을 수 있습니다.

  1. NuGet.org 로그인 페이지로 이동하여 로그인하는 데 도움이 필요하나요? 링크를 클릭합니다.
  2. 그러면 지원에 대한 팝업 대화 상자가 표시됩니다. NuGet.org 계정에 대해 연결된 Microsoft 계정을 파악하려면 이 대화 상자의 단계를 따릅니다.

NuGet.org 로그인에 사용된 Microsoft 계정을 변경하려면 어떻게 하나요?

NuGet.org 사용자에 대한 Microsoft 계정을 변경하려는 경우 다음 단계를 따릅니다. account1@outlook.com 전자 메일을 사용한 Microsoft 계정이 사용자 이름을 사용한 NuGet.org 계정 MyNuGetAccount와 연결되어 있다고 가정합니다. account2@outlook.com 이메일을 사용하여 다른 Microsoft 계정으로 로그인을 변경하려면

  1. Microsoft로 로그인을 클릭한 후 로그인 페이지에서 현재 연결된 Microsoft 계정 즉, account1@outlook.com을 사용하여 로그인하세요.

  2. 로그인하면 계정 설정 페이지로 이동합니다.

  3. 로그인 계정의 섹션을 확장합니다. 계정 변경 단추를 클릭합니다.

  4. 이제 Microsoft 로그인 페이지로 리디렉션됩니다. 연결을 변경하려는 계정으로 로그인하세요. account2@outlook.com. 참고: 다른 Microsoft 계정으로 로그인할 수 있으려면 로그인 진행 중에 다른 계정으로 로그인 및 로그아웃을 클릭해야 할 수 있습니다.

  5. 아래와 같은 오류가 표시되는 경우 자세한 내용은 Microsoft 계정이 다른 NuGet.org 계정과 연결되어 있습니다를 참조하세요.

    'account2 account2@outlook.com'로 Microsoft 계정을 업데이트하지 못했습니다. 다른 NuGet 계정에 이미 연결되어 있는 경우 이런 오류가 발생할 수 있습니다. 자세한 내용은 지원 부서에 문의하세요.

  6. 두 번째 계정으로 로그인에 성공했으면 NuGet.org 계정 설정 페이지로 다시 리디렉션되고 이제 로그인 계정으로 연결된 새 Microsoft 계정이 표시되어야 합니다. 앞으로는 NuGet.org에 로그인할 때 이 계정을 사용해야 합니다.

Microsoft 계정이 다른 NuGet.org 계정에 연결되어 있습니다.

Microsoft 로그인을 변경했는데 아래 오류가 나타난 경우:

'account2 account2@outlook.com'로 Microsoft 계정을 업데이트하지 못했습니다. 다른 NuGet 계정에 이미 연결되어 있는 경우 이런 오류가 발생할 수 있습니다. 자세한 내용은 지원 부서에 문의하세요.

Microsoft 계정 로그인을 MyNuGetAccount1 사용자 이름을 사용한 NuGet.org 사용자에 대한 account1@outlook.com에서 account2@outlook.com 전자 메일을 사용한 다른 Microsoft 계정으로 변경했다고 가정합니다. 그러면 위의 오류가 발생합니다.

**위의 오류가 의미하는 것은 무엇인가요?

위의 예제에서 MyNuGetAccount2 사용자 이름을 사용한 다른 NuGet.org 계정과 연결된 <account2@outlook.com> 전자 메일을 사용하는 Microsoft 계정으로 변경하려는 Microsoft 계정과 연결된 다른 NuGet.org 계정이 있다는 의미입니다.

다른 NuGet.org 계정에 연결된 Microsoft 계정과 연결된 로그인을 변경할 수 없습니다.

다른 NuGet.org 계정이 있다는 것을 잊은 경우 NuGet.org 계정을 확인하려면 어떻게 하나요?

로그인 페이지에서 두 번째 Microsoft 계정으로 로그인합니다. 그러면 현재 두 번째 Microsoft 계정과 연결된 NuGet.org 계정에 로그인할 수 있습니다. 그런 다음, 업로드된 패키지를 확인하고 이 계정에서 계정 관리를 수행할 수 있습니다.

이 두 번째 NuGet.org 계정에 대해 신경 쓰지 않고, 첫 번째 NuGet.org 계정에 대한 내 로그인을 두 번째 Microsoft 계정으로 변경하려고 합니다. 어떻게 해야 합니까?

두 번째 NuGet.org 계정에 대해 신경 쓰지 않으면서 account2@outlook.com 전자 메일과 연결된 Microsoft 계정을 다시 사용하려는 경우에 해당합니다.

NuGet.org 계정을 삭제하여 Microsoft 계정 및 NuGet.org 계정 간 연결을 해제할 수 있습니다.

  1. 이 단계에 따라 MyNuGetAccount2 두 번째 NuGet.org 계정의 사용자를 삭제합니다.
  2. 이 계정이 삭제되면 이 단계를 다시 시도하여 Microsoft 계정 로그인을 변경할 수 있습니다.

잠깐. 이 두 번째 계정에도 관심이 있습니다. 이 계정은 손실되지만 첫 번째 계정에 대한 내 연결된 계정 로그인을 변경하지 않겠습니다.

account3@outlook.com 이메일을 사용한 세 번째 Microsoft 계정을 만들어야/사용해야 합니다.

  1. 먼저 NuGet.org 두 번째 Microsoft 계정 account2@outlook.com 으로 로그인해야 합니다. 위의 단계에 따라 연결된 로그인을 변경하고 세 번째 Microsoft 계정을 이 NuGet.org 계정에 연결합니다.
  2. 완료되면 account2@outlook.com 전자 메일을 사용한 두 번째 Microsoft 계정은 자유롭게 MyNuGetAccount1 첫 번째 NuGet.org 계정에 연결될 수 있습니다. 위의 동일한 단계에 따라 두 번째 Microsoft 계정에 대한 Microsoft 로그인을 변경합니다.

Microsoft 계정으로 로그인하면 내 이메일이 다른 Microsoft 계정에 연결됐는지 표시됨

account1@outlook.com 이메일을 사용한 Microsoft 계정으로 로그인을 시도했는데 아래와 같은 오류가 발생한 경우:

'account1@outlook.com' 이메일을 사용한 계정이 다른 Microsoft 계정에 연결돼 있습니다.

연결된 Microsoft 계정을 업데이트하려는 경우 계정 설정 페이지에서 업데이트할 수 있습니다.

위의 오류가 의미하는 것은 무엇인가요?

NuGet.org에서 계정을 만드는 경우 해당 계정과 연결된 통신 전자 메일 주소가 있습니다. 일반적으로 이 주소는 연결된 Microsoft 계정에 사용되는 이메일 주소와 동일합니다. 그러나 통신용으로 다른 이메일 주소를 지정하는 것은 선택할 수 있습니다. 따라서 기술적으로 다른 Microsoft 계정 즉, 통신 전자 메일 주소로 account1@outlook.com을 사용하여 NuGet.org 계정에 연결하는 account2@outlook.com이 있을 수 있습니다.

위의 오류는 account1@outlook.com 통신 전자 메일 주소를 사용하는 NuGet.org 계정이 이미 있지만 account1@outlook.com아닌 전자 메일을 사용하여 다른 Microsoft 계정과 연결되어 있다는 것을 의미합니다.

이 NuGet.org 계정에 어떤 Microsoft 계정이 연결되어 있는지 알려면 어떻게 하나요?

account1@outlook.com 전자 메일 주소를 사용한 NuGet.org 계정에 어떤 Microsoft 계정이 연결돼 있는지 파악하려면 로그인 지원 흐름을 사용해야 합니다.

Microsoft 로그인을 사용할 수 없습니다. NuGet.org 계정을 복구하려면 어떻게 해야 하나요?

로그인 지원을 사용하려고 했지만 NuGet.org 계정과 연결된 Microsoft 계정에 액세스할 수 없는 경우 Microsoft 계정 지원에 문의하세요.

내 NuGet.org 계정을 조직 계정으로 변환하려면 어떻게 하나요?

계정을 조직으로 변환하려면 nuget.org 조직의 설명서에 제공된 단계를 따르세요.

관리되지 않는 테넌트가 있는 AAD 계정에서 NuGet.org 로그인 문제가 발생하면 어떻게 하나요?

전자 메일 계정 도메인(@yourdomain.com)으로 로그인 흐름 도중 아래와 같은 오류가 표시되는 경우 NuGet.org 계정을 복구하려면 다음 단계를 참조하세요.

AAD 계정 로그인 중 오류

로그인 도중 이 관리되지 않는 상태란? 이런 일이 일어나는 이유는 무엇인가요?

사용자 계정이 이전에 개인 Microsoft 계정으로 등록된 것으로 보이고 문제 없이 작동했지만, 지금은 해당 계정이 Azure Active Directory에 "관리되지 않는" 테넌트로 등록된 것으로 보입니다(Microsoft 계정을 인증하는 데 사용하는 ID 서비스).

(@yourdomain.com 전자 메일 주소를 사용하는) 조직의 누군가 또는 사용자가 AAD 통합 서비스 중 하나에 등록했거나, Azure Active Directory에 셀프 서비스 등록하여 사용한 Microsoft 계정 도메인(사용자의 경우는 @yourdomain.com)에 이러한 “관리되지 않는” 테넌트를 만든 경우 이런 일이 발생할 수 있습니다.

내 계정을 복구하려면 어떻게 해야 하나요?

현재 NuGet.org에는 Azure Active Directory에서 이러한 “관리되지 않는” 테넌트 계정을 사용하여 계정을 인증하는 방법이 없습니다. 지금은 이러한 계정을 인증하는 더 나은 방법을 찾아보고 있습니다.

Microsoft 계정(@yourdomain.com)으로 NuGet.org에 로그인하려는 경우 사용자(또는 사용자 회사의 관리자)는 “@yourdomain.com” 전자 메일 주소를 사용하여 사용자를 인증하려면 DNS 유효성 검사를 수행하여 AAD의 소유권을 주장해야 합니다. Azure Active Directory에서 설명된 도메인 관리자 인수에 대한 단계를 따릅니다. 이 작업이 완료되면 일반적인 로그인으로 작업이 시작되어야 합니다.

내 NuGet.org 계정 사용자 이름을 변경하려면 어떻게 하나요?

업데이트하려는 계정에 연결된 전자 메일 주소로 전자 메일 support@nuget.org 을 보내 사용자 이름 변경을 요청할 수 있습니다. 변경하려는 이전 사용자 이름과 새 사용자 이름을 포함해야 합니다. 그러면 요청을 검토하고 승인 시 올바른 조치를 취하려고 하며 그 결과를 이해한다는 확인을 받게 됩니다. 확인되면 사용자 이름을 변경합니다.

Important

  • 이전 사용자 이름은 계속 예약됩니다. 이전 사용자 이름을 다시 사용할 수 없으며 여기에는 대/소문자 변경이 포함됩니다.
  • 위의 결과로 이 변경 내용도 되돌릴 수 없습니다.
  • 이전 사용자 이름 프로필 페이지(예: https://www.nuget.org/profiles/OldUsername)에 대한 링크는 새 프로필로 리디렉션되지 않습니다.
  • 현재 계정이 소유한 패키지 버전에는 리포지토리 서명에 이전 사용자 이름이 계속 포함됩니다. 새 패키지 버전에는 새 사용자 이름이 포함됩니다.
  • 기존 패키지 버전에서 이전 사용자 이름 또는 기타 식별 정보를 참조하는 작성자가 제공한 메타데이터는 변경되지 않습니다.
  • 이전 사용자 이름의 트러스트를 어설션하는 NuGet 클라이언트 정책은 새 사용자 이름으로 게시된 패키지를 암시적으로 신뢰하지 않습니다. 이러한 클라이언트 정책을 구성한 패키지 소비자는 새로 게시된 패키지 버전으로 업데이트하려고 할 때 새 사용자 이름을 신뢰하도록 수동으로 업데이트해야 합니다.

내 NuGet.org 계정을 삭제하려면 어떻게 하나요?

계정을 삭제하려면 사용자가 유일한 소유자인 모든 패키지의 소유권을 양도하는 것이 좋습니다. 소유권을 양도하는 방법은 패키지 소유자 관리를 참조할 수 있습니다. 그러면 요청을 신속하게 처리하는 데도 도움이 됩니다.

계정을 조직으로 변환하려는 경우 내 NuGet.org 계정을 조직으로 변환에 제공된 단계를 따르세요.

Important

사용자를 삭제하면 다음과 같이 됩니다.

  1. 사용자 이름은 예약되며 개별 계정 또는 조직 계정을 만드는 데 해당 사용자 이름을 다시 사용할 수 없습니다.
  2. 연결된 API 키를 취소합니다.
  3. 모든 자식 패키지의 소유자로서 계정을 제거합니다.
  4. 이 계정과 기존의 모든 ID 접두사 예약을 분리합니다.
  5. 모든 조직의 구성원으로서 계정을 제거합니다.

계정 삭제를 진행하려면 다음 단계를 따릅니다.

  1. 삭제하려는 계정으로 NuGet.org에 로그인합니다.
  2. 이 URL https://www.nuget.org/account/delete를 클릭하고 계정 삭제 요청을 제출하는 단계를 따릅니다.

그러면 본사의 고객 지원팀은 이 요청을 처리하고 계정 삭제를 수행합니다.

Microsoft 계정이 삭제되면 NuGet.org 계정은 어떻게 되나요?

nuget.org 계정에 로그인하는 데 사용하는 Microsoft 또는 Azure Active Directory 계정이 삭제되면 nuget.org 계정도 삭제됩니다. 계정 삭제 작업은 Microsoft 계정 삭제 날짜로부터 30일 이내에 nuget.org 고객 지원에 의해 완료됩니다.

계정과 연결된 패키지가 있는 경우 삭제를 진행하기 전에 영업일 기준 3일 전에 알림을 받고 패키지를 다른 nuget.org 계정으로 전송하는 데 도움을 드립니다.