• NuGet 패키지용 GitLab 엔드포인트 사용
• NuGet 패키지용 패키지 레지스트리 소스 추가
  • NuGet CLI를 사용하여 소스 추가
    • 프로젝트 수준 엔드포인트
    • 그룹 수준 엔드포인트
  • Visual Studio를 사용하여 소스 추가
    • 프로젝트 수준 엔드포인트
    • 그룹 레벨 엔드포인트
  • .NET CLI를 사용하여 소스 추가
    • 프로젝트 레벨 엔드포인트
    • 그룹 레벨 엔드포인트
  • 구성 파일로 소스 추가
    • 프로젝트 레벨 엔드포인트
    • 그룹 레벨 엔드포인트
  • Chocolatey CLI를 사용하여 소스 추가
    • 프로젝트 레벨 엔드포인트 구성
• NuGet 패키지 게시
  • NuGet CLI를 사용하여 패키지 게시
  • .NET CLI를 사용하여 패키지 게시
  • CI/CD를 사용하여 NuGet 패키지 게시
  • Chocolatey CLI를 사용하여 NuGet 패키지 게시
  • 동일한 이름 또는 버전으로 패키지 게시
  • 중복 NuGet 패키지 허용 안 함
• 패키지 설치
  • NuGet CLI를 사용하여 패키지 설치
  • .NET CLI를 사용하여 패키지 설치
  • NuGet v2 피드를 사용하여 패키지 설치
• 패키지 삭제
• Symbol 패키지
  • 패키지 레지스트리를 Symbol 서버로 사용
    • Symbol 패키지 사용
• 지원되는 CLI 명령어
• 예제 프로젝트
• 문제 해결
  • NuGet 캐시 지우기
  • Docker 기반의 GitLab 설치에서 NuGet 패키지를 게시하려고 시도할 때 오류 발생

패키지 레지스트리의 NuGet 패키지

프로젝트의 패키지 레지스트리에 NuGet 패키지를 게시하세요. 그런 다음, 종속성으로 사용해야 할 때마다 패키지를 설치하세요.

패키지 레지스트리는 다음과 함께 작동합니다:

• NuGet CLI
• .NET Core CLI
• Visual Studio

이러한 클라이언트가 사용하는 특정 API 엔드포인트에 대한 문서는 NuGet API documentation을 참조하세요.

병합 요청을 생성하는 다양한 방법을 알아보세요.

NuGet 패키지용 GitLab 엔드포인트 사용

NuGet 패키지용 GitLab 엔드포인트를 사용하려면 옵션을 선택하세요:

• 프로젝트 수준: NuGet 패키지가 적고 GitLab 그룹 내에 없을 때 사용하세요.
• 그룹 수준: 동일한 GitLab 그룹 내 다른 프로젝트에 여러 NuGet 패키지가 있는 경우 사용하세요.

패키지 레지스트리에 게시하는 등 일부 기능은 프로젝트 수준 엔드포인트에서만 사용할 수 있습니다.

특정 NuGet 패키지 이름의 버전을 요청할 때, GitLab 패키지 레지스트리는 최근 300개의 버전을 반환합니다.

문서에 기재되지 않은 인증 방법을 사용하지 마십시오. 문서화되지 않은 인증 방법은 나중에 제거될 수 있습니다.

경고: NuGet이 자격 증명을 처리하는 방식으로 인해, 그룹 수준 엔드포인트에서 익명 요청은 패키지 레지스트리에서 거부됩니다. 이 제한을 해결하려면 인증을 추가하세요.

NuGet 패키지용 패키지 레지스트리 소스 추가

패키지 레지스트리에 패키지를 게시하고 설치하려면 패키지 레지스트리를 패키지 소스로 추가해야 합니다.

필수 사항:

• GitLab 사용자 이름.
• 개인 액세스 토큰 또는 배포 토큰. 리포지토리 인증을 위한:
  • 개인 액세스 토큰을 생성할 수 있습니다.
    • 리포지토리에서 패키지를 설치하려면 토큰의 범위에 read_api 또는 api를 포함해야 합니다.
    • 리포지토리에 패키지를 게시하려면 토큰의 범위에 api를 포함해야 합니다.
  • 배포 토큰을 생성할 수 있습니다.
    • 리포지토리에서 패키지를 설치하려면 토큰의 범위에 read_package_registry를 포함해야 합니다.
    • 리포지토리에 패키지를 게시하려면 토큰의 범위에 write_package_registry를 포함해야 합니다.
• 소스의 이름.
• 사용하는 엔드포인트 수준에 따라 다음 중 하나:
  • 프로젝트 개요 페이지에서 찾을 수 있는 프로젝트 ID.
  • 그룹 홈페이지에서 찾을 수 있는 그룹 ID.

이제 NuGet에 새로운 소스를 추가할 수 있습니다:

• NuGet CLI
• Visual Studio를 사용하여 소스 추가(Visual Studio)(#add-a-source-with-visual-studio)
• .NET CLI
• 구성 파일을 사용하여 소스 추가(Configuration file)(#add-a-source-with-a-configuration-file)
• Chocolatey CLI를 사용하여 소스 추가(Chocolatey CLI)(#add-a-source-with-chocolatey-cli)

NuGet CLI를 사용하여 소스 추가

프로젝트 수준 엔드포인트

패키지 레지스트리에 NuGet 패키지를 게시하려면 프로젝트 수준 엔드포인트가 필요합니다. 프로젝트에서 NuGet 패키지를 설치하려면 프로젝트 수준 엔드포인트가 필요합니다.

프로젝트 수준 NuGet 엔드포인트를 사용하려면 다음과 같이 nuget을 사용하여 패키지 레지스트리를 소스로 추가하세요:

nuget source Add -Name <source_name> -Source "https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/index.json" -UserName <gitlab_username 또는 deploy_token_username> -Password <gitlab_personal_access_token 또는 deploy_token>

• <source_name>은 원하는 소스 이름입니다.

예시:

nuget source Add -Name "GitLab" -Source "https://gitlab.example.com/api/v4/projects/10/packages/nuget/index.json" -UserName carol -Password 12345678asdf

그룹 수준 엔드포인트

그룹에서 NuGet 패키지를 설치하려면 그룹 수준 엔드포인트를 사용하세요.

그룹 수준 NuGet 엔드포인트를 사용하려면 다음과 같이 nuget을 사용하여 패키지 레지스트리를 소스로 추가하세요:

nuget source Add -Name <source_name> -Source "https://gitlab.example.com/api/v4/groups/<your_group_id>/-/packages/nuget/index.json" -UserName <gitlab_username 또는 deploy_token_username> -Password <gitlab_personal_access_token 또는 deploy_token>

• <source_name>은 원하는 소스 이름입니다.

예시:

nuget source Add -Name "GitLab" -Source "https://gitlab.example.com/api/v4/groups/23/-/packages/nuget/index.json" -UserName carol -Password 12345678asdf

Visual Studio를 사용하여 소스 추가

프로젝트 수준 엔드포인트

패키지 레지스트리에 NuGet 패키지를 게시하려면 프로젝트 수준 엔드포인트가 필요합니다. 프로젝트에서 NuGet 패키지를 설치하려면 프로젝트 수준 엔드포인트가 필요합니다.

프로젝트 수준 NuGet 엔드포인트를 사용하려면 Visual Studio에서 패키지 레지스트리를 소스로 추가하세요:

1. Visual Studio를 엽니다.
2. Windows의 경우 도구 > 옵션을 선택합니다. macOS의 경우 Visual Studio > 환경 설정을 선택합니다.
3. NuGet 섹션에서 모든 NuGet 소스 목록을 보려면 소스를 선택하세요.
4. 추가를 선택합니다.

5. 다음 필드를 입력하세요:

   • 이름: 소스 이름.
   • 소스: https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/index.json, 여기서 <your_project_id>은 프로젝트 ID이며, gitlab.example.com은 도메인 이름입니다.
6. 저장을 선택합니다.

7. 패키지에 액세스할 때 사용자 이름과 암호를 입력해야 합니다.

   • 사용자 이름: GitLab 사용자 이름 또는 배포 토큰 사용자 이름.
   • 암호: 개인 액세스 토큰 또는 배포 토큰.

소스가 목록에 표시됩니다.

경고가 표시되면 소스, 사용자 이름, 암호가 올바른지 확인하세요.

그룹 레벨 엔드포인트

그룹에서 패키지를 설치하려면 그룹 레벨 엔드포인트를 사용합니다.

그룹 레벨 NuGet 엔드포인트를 사용하려면 Visual Studio에서 패키지 레지스트리를 소스로 추가합니다.

1. Visual Studio를 엽니다.
2. Windows의 경우 Tools > Options를, macOS의 경우 Visual Studio > Preferences를 선택합니다.
3. NuGet 섹션에서 Sources를 선택하여 NuGet 소스 목록을 확인합니다.
4. Add를 선택합니다.

5. 다음 필드를 작성합니다:

   • 이름: 소스의 이름
   • 소스: https://gitlab.example.com/api/v4/groups/<your_group_id>/-/packages/nuget/index.json (여기서 <your_group_id>는 그룹 ID이고, gitlab.example.com은 도메인 이름입니다)
6. Save를 선택합니다.

7. 패키지에 액세스하려면 사용자 이름과 암호를 입력해야 합니다.

   • 사용자 이름: GitLab 사용자 이름 또는 배포 토큰 사용자 이름
   • 암호: 개인 액세스 토큰 또는 배포 토큰

소스가 목록에 표시됩니다.

경고가 표시되는 경우 소스, 사용자 이름, 암호가 올바른지 확인하세요.

.NET CLI를 사용하여 소스 추가

프로젝트 레벨 엔드포인트

NuGet 패키지를 패키지 레지스트리에 게시하려면 프로젝트 레벨 엔드포인트가 필요합니다. 또한 NuGet 패키지를 프로젝트에서 설치하려면 프로젝트 레벨 엔드포인트도 필요합니다.

프로젝트 레벨 NuGet 엔드포인트를 사용하려면 nuget을 통해 패키지 레지스트리를 소스로 추가합니다:

dotnet nuget add source "https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/index.json" --name <source_name> --username <gitlab_username 또는 deploy_token_username> --password <gitlab_personal_access_token 또는 deploy_token>

• <source_name>은 원하는 소스 이름입니다.
• 사용하는 운영 체제에 따라 --store-password-in-clear-text를 추가해야 할 수 있습니다.

예:

dotnet nuget add source "https://gitlab.example.com/api/v4/projects/10/packages/nuget/index.json" --name gitlab --username carol --password 12345678asdf

그룹 레벨 엔드포인트

그룹에서 NuGet 패키지를 설치하려면 그룹 레벨 엔드포인트를 사용합니다.

그룹 레벨 NuGet 엔드포인트를 사용하려면 nuget을 통해 패키지 레지스트리를 소스로 추가합니다:

dotnet nuget add source "https://gitlab.example.com/api/v4/groups/<your_group_id>/-/packages/nuget/index.json" --name <source_name> --username <gitlab_username 또는 deploy_token_username> --password <gitlab_personal_access_token 또는 deploy_token>

• <source_name>은 원하는 소스 이름입니다.
• 사용하는 운영 체제에 따라 --store-password-in-clear-text를 추가해야 할 수 있습니다.

예:

dotnet nuget add source "https://gitlab.example.com/api/v4/groups/23/-/packages/nuget/index.json" --name gitlab --username carol --password 12345678asdf

구성 파일로 소스 추가

프로젝트 레벨 엔드포인트

다음이 필요한 프로젝트 레벨 엔드포인트입니다:

• 패키지 레지스트리에 NuGet 패키지를 게시
• 프로젝트에서 NuGet 패키지를 설치

프로젝트 레벨 패키지 레지스트리를 .NET의 소스로 사용하려면 프로젝트 루트에 nuget.config라는 파일을 만듭니다.

다음 내용을 추가합니다:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <packageSources>
     <clear />
     <add key="gitlab" value="https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/index.json" />
 </packageSources>
 <packageSourceCredentials>
     <gitlab>
         <add key="Username" value="%GITLAB_PACKAGE_REGISTRY_USERNAME%" />
         <add key="ClearTextPassword" value="%GITLAB_PACKAGE_REGISTRY_PASSWORD%" />
     </gitlab>
 </packageSourceCredentials>
</configuration>

필요한 환경 변수를 구성하세요:

export GITLAB_PACKAGE_REGISTRY_USERNAME=<gitlab_username 또는 deploy_token_username>
export GITLAB_PACKAGE_REGISTRY_PASSWORD=<gitlab_personal_access_token 또는 deploy_token>

그룹 레벨 엔드포인트

그룹에서 패키지를 설치하려면 그룹 레벨 엔드포인트를 사용합니다.

그룹 레벨 패키지 레지스트리를 .NET의 소스로 사용하려면 프로젝트 루트에 nuget.config라는 파일을 만듭니다.

다음 내용을 추가합니다:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <packageSources>
     <clear />
     <add key="gitlab" value="https://gitlab.example.com/api/v4/groups/<your_group_id>/-/packages/nuget/index.json" />
 </packageSources>
 <packageSourceCredentials>
     <gitlab>
         <add key="Username" value="%GITLAB_PACKAGE_REGISTRY_USERNAME%" />
         <add key="ClearTextPassword" value="%GITLAB_PACKAGE_REGISTRY_PASSWORD%" />
     </gitlab>
 </packageSourceCredentials>
</configuration>

필요한 환경 변수를 구성하세요:

export GITLAB_PACKAGE_REGISTRY_USERNAME=<gitlab_username 또는 deploy_token_username>
export GITLAB_PACKAGE_REGISTRY_PASSWORD=<gitlab_personal_access_token 또는 deploy_token>

Chocolatey CLI를 사용하여 소스 추가

Chocolatey CLI를 사용하여 소스 피드를 추가할 수 있습니다. Chocolatey CLI v1.x를 사용하는 경우 NuGet v2 소스 피드만 추가할 수 있습니다.

프로젝트 레벨 엔드포인트 구성

NuGet 패키지를 패키지 레지스트리에 게시하려면 프로젝트 레벨 엔드포인트가 필요합니다.

프로젝트 레벨 패키지 레지스트리를 Chocolatey의 소스로 사용하려면 다음을 수행합니다:

• choco를 사용하여 패키지 레지스트리를 소스로 추가합니다:

  choco source add -n=gitlab -s "'https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/v2'" -u=<gitlab_username 또는 deploy_token_username> -p=<gitlab_personal_access_token 또는 deploy_token>
  

NuGet 패키지 게시

전제 조건:

• 패키지 레지스트리에 NuGet 패키지로서 소스를 추가합니다. 이는 프로젝트 수준 엔드포인트로 설정합니다.

패키지를 게시하는 경우:

• GitLab.com의 패키지 레지스트리는 최대 5GB 내용을 저장할 수 있습니다. 이 한도는 자체 호스팅된 GitLab 인스턴스에서 구성할 수 있습니다.
• 동일한 버전의 동일한 패키지를 여러 번 게시하면 각각의 연속 업로드는 별도 파일로 저장됩니다. 패키지를 설치할 때 GitLab은 가장 최근 파일을 제공합니다.
• GitLab에 패키지를 게시하면 해당 패키지는 프로젝트의 패키지 사용자 인터페이스에 바로 표시되지 않습니다. 패키지를 처리하는 데 최대 10분이 소요될 수 있습니다.

NuGet CLI를 사용하여 패키지 게시

전제 조건:

• NuGet CLI로 생성된 NuGet 패키지가 있어야 합니다.
• 프로젝트 수준 엔드포인트를 설정합니다.

다음 명령을 실행하여 패키지를 게시합니다:

nuget push <package_file> -Source <source_name>

• <package_file>은 .nupkg로 끝나는 패키지 파일명입니다.
• <source_name>은 설정 중 사용한 소스 이름입니다.

.NET CLI를 사용하여 패키지 게시

• --api-key로 패키지를 게시하는 기능은 GitLab 16.1에서 도입되었습니다.

전제 조건:

• .NET CLI로 생성된 NuGet 패키지가 있어야 합니다.
• 프로젝트 수준 엔드포인트를 설정합니다.

다음 명령을 실행하여 패키지를 게시합니다:

dotnet nuget push <package_file> --source <source_name>

• <package_file>은 .nupkg로 끝나는 패키지 파일명입니다.
• <source_name>은 설정 중 사용한 소스 이름입니다.

예시:

dotnet nuget push MyPackage.1.0.0.nupkg --source gitlab

--api-key 옵션 대신 사용자 이름 및 암호 대신 CI 작업 토큰을 사용하여 패키지를 게시할 수 있습니다:

dotnet nuget push <package_file> --source <source_url> --api-key <gitlab_personal_access_token, deploy_token or job token>

• <package_file>은 .nupkg로 끝나는 패키지 파일명입니다.
• <source_url>은 NuGet 패키지 레지스트리의 URL입니다.

예시:

dotnet nuget push MyPackage.1.0.0.nupkg --source https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/index.json --api-key <gitlab_personal_access_token, deploy_token or job token>

CI/CD를 사용하여 NuGet 패키지 게시

GitLab CI/CD에서 NuGet을 사용하는 경우 CI 작업 토큰을 사용하여 개인 액세스 토큰 또는 배포 토큰 대신 사용할 수 있습니다. 해당 토큰은 파이프라인을 생성한 사용자의 권한을 상속합니다.

다음 예제는 main 브랜치가 업데이트될 때마다 새 패키지를 생성하는 방법을 보여줍니다:

1. .gitlab-ci.yml 파일에 deploy 작업을 추가합니다:

   image: mcr.microsoft.com/dotnet/core/sdk:3.1
   
   stages:
     - deploy
   
   deploy:
     stage: deploy
     script:
       - dotnet pack -c Release
       - dotnet nuget add source "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json" --name gitlab --username gitlab-ci-token --password $CI_JOB_TOKEN --store-password-in-clear-text
       - dotnet nuget push "bin/Release/*.nupkg" --source gitlab
     only:
       - main
     environment: production
   

2. 변경 내용을 커밋하고 GitLab 저장소에 푸시하여 새 CI/CD 빌드를 트리거합니다.

Chocolatey CLI를 사용하여 NuGet 패키지 게시

• GitLab 16.2에서 도입되었습니다.

전제 조건:

• 프로젝트 수준 패키지 레지스트리가 Chocolatey의 소스여야 합니다.

다음 명령으로 Chocolatey CLI를 사용하여 패키지를 게시합니다:

choco push <package_file> --source <source_url> --api-key <gitlab_personal_access_token, deploy_token or job token>

이 명령에서:

• <package_file>은 패키지 파일명으로 .nupkg로 끝납니다.
• <source_url>은 NuGet v2 피드 패키지 레지스트리의 URL입니다.

예시:

choco push MyPackage.1.0.0.nupkg --source "https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/v2" --api-key <gitlab_personal_access_token, deploy_token or job token>

동일한 이름 또는 버전으로 패키지 게시

동일한 이름 또는 버전을 가진 기존 패키지와 동일한 이름 또는 버전으로 패키지를 게시하면 기존 패키지가 덮어쓰입니다.

중복 NuGet 패키지 허용 안 함

• nuget_duplicates_option이라는 플래그 GitLab 16.3에서 도입되었습니다. 기본적으로 비활성화됨.
• GitLab 16.6에서 일반적으로 사용 가능합니다. nuget_duplicates_option 피쳐 플래그가 제거되었습니다.
• GitLab 17.0에서 필요한 역할이 Maintainer에서 Owner로 변경되었습니다.

중복 NuGet 패키지를 방지하려면 GraphQl API 또는 UI를 사용할 수 있습니다.

UI에서:

1. 왼쪽 사이드바에서 검색 또는 이동하여 그룹을 찾습니다.
2. 설정 > 패키지 및 레지스트리를 선택합니다.
3. Duplicate packages 테이블의 NuGet 행에서 Allow duplicates 토글을 끕니다.
4. 선택 사항. Exceptions 텍스트 상자에 허용할 패키지의 이름과 버전과 일치하는 정규 표현식을 입력합니다.

변경 사항은 자동으로 저장됩니다.

경고: .nuspec 파일이 패키지의 루트에 위치하지 않으면 해당 패키지는 중복으로 인식되지 않을 수 있습니다.

패키지 설치

패키지가 동일한 이름과 버전을 가질 경우, 패키지를 설치할 때 가장 최근에 게시된 패키지가 검색됩니다.

패키지 레지스트리에서 NuGet 패키지를 설치하려면, 먼저 프로젝트 수준 또는 그룹 수준 엔드포인트를 추가해야 합니다.

NuGet CLI를 사용하여 패키지 설치

경고: 기본적으로 nuget은 먼저 nuget.org에서 공식 소스를 확인합니다. nuget.org에 있는 패키지와 패키지 레지스트리에 동일한 이름의 패키지가 있는 경우, 올바른 패키지를 설치하려면 소스 이름을 지정해야 합니다.

다음 명령을 실행하여 패키지의 최신 버전을 설치하세요:

nuget install <package_id> -OutputDirectory <output_directory> \
  -Version <package_version> \
  -Source <source_name>

• <package_id>는 패키지 ID입니다.
• <output_directory>는 패키지가 설치되는 출력 디렉토리입니다.
• <package_version>는 패키지 버전입니다. 선택 사항입니다.
• <source_name>은 소스 이름입니다. 선택 사항입니다.

.NET CLI를 사용하여 패키지 설치

경고: 패키지 레지스트리에 다른 소스에 있는 패키지와 동일한 이름을 가진 패키지가 있는 경우, 설치 중 dotnet이 소스를 확인하는 순서를 확인하세요. 이는 nuget.config 파일에 정의됩니다.

다음 명령을 실행하여 패키지의 최신 버전을 설치하세요:

dotnet add package <package_id> \
       -v <package_version>

• <package_id>는 패키지 ID입니다.
• <package_version>은 패키지 버전입니다. 선택 사항입니다.

NuGet v2 피드를 사용하여 패키지 설치

• GitLab 16.5 에서 도입되었습니다.

필수 조건:

• 프로젝트 수준 패키지 레지스트리는 Chocolatey의 v2 피드 소스입니다.
• NuGet v2 피드를 사용하여 패키지를 설치하거나 업그레이드할 때 버전을 제공해야 합니다.

다음 명령을 실행하여 Chocolatey CLI를 사용하여 패키지를 설치하세요:

choco install <package_id> -Source <source_url> -Version <package_version>

이 명령에서:

• <package_id>는 패키지 ID입니다.
• <source_url>은 NuGet v2 피드 패키지 레지스트리의 URL 또는 이름입니다.
• <package_version>은 패키지 버전입니다.

예시:

choco install MyPackage -Source gitlab -Version 1.0.2

# 또는

choco install MyPackage -Source "https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/v2" -u <username> -p <gitlab_personal_access_token, deploy_token 또는 job token> -Version 1.0.2

다음 명령으로 Chocolatey CLI를 사용하여 패키지를 업그레이드하세요:

choco upgrade <package_id> -Source <source_url> -Version <package_version>

이 명령에서:

• <package_id>는 패키지 ID입니다.
• <source_url>은 NuGet v2 피드 패키지 레지스트리의 URL 또는 이름입니다.
• <package_version>은 패키지 버전입니다.

예시:

choco upgrade MyPackage -Source gitlab -Version 1.0.3

패키지 삭제

• GitLab 16.5 에서 도입되었습니다.

경고: 패키지를 삭제하면 되돌릴 수 없는 영구적인 작업입니다.

필수 조건:

• 프로젝트 내에서 Maintainer 역할 이상을 가지고 있어야 합니다.
• 패키지 이름과 버전 모두 있어야 합니다.

다음 명령을 실행하여 NuGet CLI를 사용하여 패키지를 삭제하세요:

nuget delete <package_id> <package_version> -Source <source_name> -ApiKey <gitlab_personal_access_token, deploy_token 또는 job token>

이 명령에서:

• <package_id>는 패키지 ID입니다.
• <package_version>은 패키지 버전입니다.
• <source_name>은 소스 이름입니다.

예시:

nuget delete MyPackage 1.0.0 -Source gitlab -ApiKey <gitlab_personal_access_token, deploy_token 또는 job token>

Symbol 패키지

.nupkg를 푸시하면 .snupkg 형식의 symbol 패키지 파일이 자동으로 업로드됩니다. 수동으로도 푸시할 수 있습니다:

nuget push My.Package.snupkg -Source <source_name>

패키지 레지스트리를 Symbol 서버로 사용

• GitLab 16.7 에서 도입되었습니다.

GitLab은 NuGet 패키지 레지스트리에서 symbol 파일을 사용할 수 있으므로, 패키지 레지스트리를 symbol 서버로 사용할 수 있습니다.

Symbol 서버를 사용하려면:

1. GraphQl API로 nuget_symbol_server_enabled 네임스페이스 설정을 활성화하세요.

2. 디버거를 symbol 서버로 구성하세요. 예를 들어, Visual Studio를 구성하려면:

   1. 도구 > 환경 설정을 엽니다.
   2. 디버거 > Symbol sources를 선택합니다.
   3. 추가를 선택합니다.

   4. 필수 필드를 입력합니다. symbol 서버의 URL은 다음과 같습니다:

      https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/symbolfiles
      -- 또는 --
      https://gitlab.example.com/api/v4/groups/<your_group_id>/-/packages/nuget/symbolfiles
      

   5. 소스 추가를 선택합니다.

디버거를 구성한 후, 애플리케이션을 평소처럼 디버깅할 수 있습니다. 디버거는 symbol PDB 파일을 패키지 레지스트리에서 자동으로 다운로드합니다. 파일이 사용 가능한 경우.

Symbol 패키지 사용

디버거를 symbol 패키지로 구성하면, 디버거는 요청에서 다음을 보냅니다:

• Symbolchecksum 헤더: Symbol 파일의 SHA-256 체크섬.
• file_name 요청 매개변수: Symbol 파일의 이름. 예: mypackage.pdb.
• signature 요청 매개변수: PDB 파일의 GUID 및 나이입니다.

GitLab 서버는 이 정보와 일치하는 symbol 파일을 반환합니다.

참고: - 이 동작은 이식 가능한 PDB 파일만 지원합니다. - 디버거는 인증 토큰을 제공할 수 없기 때문에, symbol 서버 엔드포인트는 표준 인증 방법을 지원하지 않습니다. GitLab 서버는 올바른 symbol 파일을 반환하려면 signature와 Symbolchecksum이 필요합니다.

지원되는 CLI 명령어

• nuget delete 및 dotnet nuget delete 명령어는 GitLab 16.5에서 소개되었습니다.

GitLab NuGet 저장소는 NuGet CLI(nuget)와 .NET CLI(dotnet)를 위해 다음과 같은 명령어를 지원합니다:

• nuget push: 패키지를 레지스트리에 업로드합니다.
• dotnet nuget push: 패키지를 레지스트리에 업로드합니다.
• nuget install: 레지스트리에서 패키지를 설치합니다.
• dotnet add: 레지스트리에서 패키지를 설치합니다.
• nuget delete: 레지스트리에서 패키지를 삭제합니다.
• dotnet nuget delete: 레지스트리에서 패키지를 삭제합니다.

예제 프로젝트

예제로 GitVersion을 사용한 완전히 자동화된 소프트웨어 및 아티팩트 버전 관리 프로젝트를 참조하세요. 이 프로젝트는 다음을 수행합니다:

• msbuild 방법으로 NuGet 패키지를 생성합니다.
• nuget.exe 방법으로 NuGet 패키지를 생성합니다.
• GitLab 릴리스 및 NuGet 패키징과 관련된 release-cli를 사용합니다.
• 복잡한 리포지토리에서 NuGet 패키지의 버전을 자동으로 결정하고 증가시키기 위해 GitVersion이라는 도구를 사용합니다.

이 예제 프로젝트를 귀하의 그룹이나 인스턴스로 복사하여 테스트할 수 있습니다. 프로젝트 페이지에서 GitLab CI 패턴을 더 자세히 확인하세요.

문제 해결

NuGet 캐시 지우기

성능을 향상시키기 위해 NuGet은 패키지와 관련된 파일을 캐시에 저장합니다. 문제가 발생할 경우 다음 명령어로 캐시를 지울 수 있습니다:

nuget locals all -clear

Docker 기반의 GitLab 설치에서 NuGet 패키지를 게시하려고 시도할 때 오류 발생

웹훅 요청이 내부 웹 서비스의 악용을 방지하기 위해 로컬 네트워크 주소로 차단됩니다. 만약 NuGet 패키지를 게시하려고 시도할 때 Error publishing 또는 Invalid Package: Failed metadata extraction error 메시지가 표시된다면, 네트워크 설정을 변경하여 내부 네트워크로의 웹훅 및 통합 요청을 허용하십시오.