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

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

프로젝트의 패키지 레지스트리에 NuGet 패키지를 게시합니다. 그런 다음, 의존성으로 사용해야 할 때 패키지를 설치합니다.

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

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

NuGet 패키지를 생성하는 방법에 대한 자세한 내용은 NuGet를 설치를 참조하세요.

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

GitLab 패키지 레지스트리를 위해 GitLab 엔드포인트를 사용하려면 옵션을 선택하세요:

  • 프로젝트 수준: NuGet 패키지가 몇 개이고, 같은 GitLab 그룹에 속하지 않을 때 사용합니다.
  • 그룹 수준: 같은 GitLab 그룹 내 다른 프로젝트에 많은 NuGet 패키지가 있을 때 사용합니다.

게시와 같은 일부 기능은 프로젝트 수준 엔드포인트에서만 사용할 수 있습니다.

주어진 NuGet 패키지 이름의 버전을 요청하면, GitLab 패키지 레지스트리는 최대 300개의 최신 버전을 반환합니다.

미래에 제거될 수 있는 문서화되지 않은 인증 방법 외에는 사용하지 마십시오.

caution
NuGet이 자격 증명을 처리하는 방식 때문에, 패키지 레지스트리는 그룹 수준 엔드포인트에서 익명 요청을 거부합니다. 이러한 제한을 해결하려면, 인증을 설정하세요.

NuGet 패키지를 위한 패키지 레지스트리 추가

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

전제 조건:

  • 귀하의 GitLab 사용자 이름.
  • 개인 액세스 토큰 또는 배포 토큰. 리포지터리 인증을 위해:
    • 개인 액세스 토큰을 생성할 수 있습니다. 스코프는 api로 설정하세요.
    • 배포 토큰을 생성할 수 있습니다. 스코프는 read_package_registry, write_package_registry, 또는 둘 다로 설정하세요.
  • 소스의 이름.
  • 사용하는 엔드포인트 레벨에 따라:
    • 프로젝트 ID, 프로젝트 ID는 프로젝트 개요 페이지에서 찾을 수 있습니다.
    • 그룹 ID, 그룹 ID는 귀하의 그룹 홈페이지에서 찾을 수 있습니다.

다음 명령어로 NuGet에 새 소스를 추가할 수 있습니다:

NuGet CLI를 사용하여 소스 추가

프로젝트 수준 엔드포인트

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

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

nuget source Add -Name <소스_이름> -Source "https://gitlab.example.com/api/v4/projects/<귀하의_프로젝트_ID>/packages/nuget/index.json" -UserName <gitlab_사용자_이름 또는_배포_토큰_사용자_이름> -Password <gitlab_개인_액세스_토큰 또는_배포_토큰>
  • <소스_이름>은 원하는 소스 이름입니다.

예: 

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 source Add -Name <소스_이름> -Source "https://gitlab.example.com/api/v4/groups/<귀하의_그룹_ID>/-/packages/nuget/index.json" -UserName <gitlab_사용자_이름 또는_배포_토큰_사용자_이름> -Password <gitlab_개인_액세스_토큰 또는_배포_토큰>
  • <소스_이름>은 원하는 소스 이름입니다.

예: 

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 엔드포인트를 사용하려면 패키지 레지스트리를 소스로 추가합니다:

  1. Visual Studio를 엽니다.
  2. Windows에서는 도구 > 옵션을, macOS에서는 Visual Studio > 환경 설정을 선택합니다.
  3. NuGet 섹션에서 소스를 선택하여 모든 NuGet 소스의 디렉터리을 볼 수 있습니다.
  4. 추가를 선택합니다.

  5. 다음 필드를 작성하세요:

    • 이름: 소스 이름.
    • 소스: https://gitlab.example.com/api/v4/projects/<귀하의_프로젝트_ID>/packages/nuget/index.json, where <귀하의_프로젝트_ID>는 귀하의 프로젝트 ID이며, gitlab.example.com은 귀하의 도메인 이름입니다.
  6. 저장을 선택합니다.

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

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

해당 소스는 디렉터리에 표시됩니다.

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

그룹 수준 엔드포인트

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

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

  1. Visual Studio를 엽니다.
  2. Windows에서는 도구 > 옵션을, macOS에서는 Visual Studio > 환경 설정을 선택합니다.
  3. NuGet 섹션에서 소스를 선택하여 모든 NuGet 소스의 디렉터리을 볼 수 있습니다.
  4. 추가를 선택합니다.

  5. 다음 필드를 작성하세요:

    • 이름: 소스 이름.
    • 소스: https://gitlab.example.com/api/v4/groups/<귀하의_그룹_ID>/-/packages/nuget/index.json, where <귀하의_그룹_ID>는 귀하의 그룹 ID이며, gitlab.example.com은 귀하의 도메인 이름입니다.
  6. 저장을 선택합니다.

  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용 프로젝트 수준 패키지 레지스트리를 소스로 사용하려면:

  1. 프로젝트의 루트에 nuget.config라는 파일을 만듭니다.

  2. 다음 내용을 추가합니다: 

    <?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>

  3. 필요한 환경 변수를 구성합니다: 

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

그룹 수준 엔드포인트

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

.NET용 그룹 수준 패키지 레지스트리를 소스로 사용하려면:

  1. 프로젝트의 루트에 nuget.config라는 파일을 만듭니다.

  2. 다음 내용을 추가합니다: 

    <?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>

  3. 필요한 환경 변수를 구성합니다: 

    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 패키지 발행

전제 조건:

패키지를 발행할 때:

  • GitLab.com의 패키지 레지스트리는 최대 5GB의 콘텐츠를 저장할 수 있습니다. 이 제한은 Self-Managed형 GitLab 인스턴스에 대해 구성할 수 있습니다.
  • 동일한 버전의 패키지를 여러 번 게시하는 경우, 각 연속 업로드는 별도의 파일로 저장됩니다. 패키지를 설치할 때 GitLab은 가장 최근 파일을 제공합니다.
  • GitLab에 패키지를 발행하면 프로젝트의 패키지 사용자 인터페이스에 즉시 표시되지 않습니다. 패키지를 처리하는 데 최대 10분이 소요될 수 있습니다.

NuGet CLI로 패키지 발행

전제 조건:

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

nuget push <package_file> -Source <source_name>
  • <package_file>은 .nupkg로 끝나는 패키지 파일명입니다.
  • <source_name>은 설정 중인 소스 이름입니다.

.NET CLI로 패키지 발행

전제 조건:

다음 명령으로 패키지를 발행합니다: 

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 옵션을 사용하여 username 및 password 대신 패키지를 발행할 수 있습니다: 

dotnet nuget push <package_file> --source <source_url> --api-key <gitlab_personal_access_token, deploy_token 또는 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 또는 job token>

CI/CD를 사용하여 NuGet 패키지 발행

만약 NuGet을 GitLab CI/CD와 함께 사용한다면, 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 패키지 발행

전제 조건:

  • 프로젝트 수준의 패키지 레지스트리는 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 패키지 허용하지 않기

  • GitLab 16.3에서 nuget_duplicates_option이라는 플래그로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • 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 텍스트 상자에 허용할 패키지의 이름과 버전과 일치하는 정규 표현식을 입력하세요.

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

caution
.nuspec 파일이 패키지의 루트에 없는 경우 패키지가 중복으로 인식되지 않을 수 있습니다.

패키지 설치

동일한 이름과 버전을 가진 여러 패키지가 있는 경우, 패키지를 설치할 때 최근에 발행된 패키지가 검색됩니다.

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

NuGet CLI로 패키지 설치

caution
기본적으로 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로 패키지 설치

caution
다른 소스에 동일한 이름의 패키지가 있는 경우, dotnet이 설치 중에 확인하는 소스의 순서를 확인해야 합니다. 이는 nuget.config 파일에 정의되어 있습니다.

이 명령으로 최신 버전의 패키지를 설치하세요: 

dotnet add package <package_id> \
       -v <package_version>
  • <package_id>은 패키지 ID입니다.
  • <package_version>은 패키지 버전입니다. (선택사항)

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

전제 조건:

  • 프로젝트 수준의 패키지 레지스트리가 Chocolatey의 v2 feed 소스입니다.
  • 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 or 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

패키지 삭제

caution
패키지를 삭제하는 것은 되돌릴 수 없는 영구적인 작업입니다.

전제 조건:

  • 프로젝트에서 유지자(Maintainer) 권한 이상이 있어야 합니다.
  • 패키지 이름과 버전이 모두 있어야 합니다.

다음 명령으로 NuGet CLI를 사용하여 패키지를 삭제하세요: 

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

이 명령에서:

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

예시: 

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

심볼 패키지

만약 .nupkg를 푸시하면, .snupkg 형식의 심볼 패키지 파일이 자동으로 업로드됩니다. 매뉴얼으로도 푸시할 수 있습니다: 

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

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

GitLab은 NuGet 패키지 레지스트리에서 심볼 파일을 사용할 수 있도록 지원하므로, 패키지 레지스트리를 심볼 서버로 사용할 수 있습니다.

심볼 서버를 사용하려면:

  1. GraphQl API를 사용하여 nuget_symbol_server_enabled 네임스페이스 설정을 활성화합니다.

  2. 디버거를 심볼 서버로 구성합니다. 예를 들어, Visual Studio를 구성하려면:

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

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

      https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/nuget/symbolfiles
-- or --
https://gitlab.example.com/api/v4/groups/<your_group_id>/-/packages/nuget/symbolfiles
    5. 원본 추가를 선택합니다.

디버거를 구성한 후에는 익숙하게 응용 프로그램을 디버깅할 수 있습니다. 심볼 PDB 파일이 패키지 레지스트리에 있는 한 디버거가 자동으로 이 파일을 다운로드합니다.

심볼 패키지 소비

디버거가 심볼 패키지를 소비하도록 구성되면, 디버거는 다음을 요청으로 보냅니다:

  • Symbolchecksum 헤더: 심볼 파일의 SHA-256 체크섬.
  • file_name 요청 매개변수: 심볼 파일의 이름. 예를 들어, mypackage.pdb.
  • signature 요청 매개변수: PDB 파일의 GUID와 나이.

GitLab 서버는 이 정보를 심볼 파일과 일치시켜 반환합니다.

주의할 점:

  • 포터블 PDB 파일만 지원됩니다.
  • 디버거는 인증 토큰을 제공할 수 없기 때문에, 심볼 서버 엔드포인트는 보통의 인증 방법을 지원하지 않습니다. GitLab 서버는 signature와 Symbolchecksum을 요구하여 올바른 심볼 파일을 반환합니다.

지원되는 CLI 명령

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 패키지를 생성합니다.
  • NuGet 패키지와 관련하여 GitLab 릴리즈 및 release-cli를 사용합니다.
  • 복잡한 리포지터리의 NuGet 패키지 버전을 자동으로 확인하고 증가시키기 위해 GitVersion이라는 도구를 사용합니다.

이 예제 프로젝트를 테스트를 위해 자신의 그룹이나 인스턴스에 복사할 수 있습니다. 프로젝트 페이지를 참조하면 GitLab CI 패턴에 대한 자세한 내용을 확인할 수 있습니다.

문제 해결

NuGet 캐시 지우기

성능을 향상시키기 위해, NuGet은 패키지와 관련된 파일을 캐시합니다. 문제가 발생하면 다음 명령을 사용하여 캐시를 지울 수 있습니다: 

nuget locals all -clear

Docker 기반의 GitLab 설치에서 NuGet 패키지를 게시하려고 시도할 때 Error publishing 또는 Invalid Package: Failed metadata extraction error 메시지가 나타날 때

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