GitLab 패키지 레지스트리 관리

여러 일반 패키지 관리자를 이용하여 GitLab을 개인 저장소로 사용하려면 패키지 레지스트리를 사용하십시오. 패키지를 빌드하고 게시할 수 있으며 하류 프로젝트에서 종속성으로 사용될 수 있습니다.

지원되는 형식

패키지 레지스트리는 다음 형식을 지원합니다:

기여 수락

아래 테이블은 지원되지 않지만 커뮤니티 기여를 수락하고 있는 형식을 나열하고 있습니다. GitLab에 기여하는 것을 고려해 보세요. 개발 문서를 통해 프로세스를 안내받을 수 있습니다.

속도 제한

하류 프로젝트에서 종속성으로 패키지를 다운로드할 때, 많은 요청이 패키지 API를 통해 이루어집니다. 그러므로 강제된 사용자 및 IP 속도 제한에 도달할 수 있습니다. 이 문제를 해결하려면 패키지 API에 대한 특정 속도 제한을 정의할 수 있습니다. 자세한 내용은 패키지 레지스트리 속도 제한을 참조하세요.

패키지 레지스트리 활성화 또는 비활성화

패키지 레지스트리는 기본적으로 활성화되어 있습니다. 비활성화하려면 다음을 수행하십시오:

저장 경로 변경

기본적으로 패키지는 로컬에 저장되지만 기본 로컬 위치를 변경하거나 객체 저장소를 사용할 수 있습니다.

로컬 저장 경로 변경

기본적으로 패키지는 GitLab 설치와 관련된 로컬 경로에 저장됩니다:

• Linux 패키지 (Omnibus): /var/opt/gitlab/gitlab-rails/shared/packages/
• Self-compiled (source): /home/git/gitlab/shared/packages/

로컬 저장 경로를 변경하려면 다음을 수행하십시오:

기존 저장 경로에 패키지가 이미 저장되어 있는 경우, 기존 패키지가 접근 가능하도록 이전 위치에서 모든 것을 새 위치로 이동합니다:

mv /var/opt/gitlab/gitlab-rails/shared/packages/* /mnt/packages/

도커와 쿠버네티스는 로컬 저장을 사용하지 않습니다.

• Helm 차트 (Kubernetes)의 경우: 대신 객체 저장소를 사용합니다.
• 도커의 경우: /var/opt/gitlab/ 디렉토리가 이미 호스트의 디렉토리에 마운트되어 있습니다. 컨테이너 내부의 로컬 저장 경로를 변경할 필요가 없습니다.

객체 스토리지 사용

로컬 스토리지에 의존하는 대신, 객체 스토리지를 사용하여 패키지를 저장할 수 있습니다.

자세한 내용은 통합된 객체 스토리지 설정을 참조하십시오.

로컬 패키지를 객체 스토리지로 이관

객체 스토리지 구성을 한 후, 기존 패키지를 로컬 스토리지에서 원격 스토리지로 이관하는 작업을 수행합니다. 처리는 백그라운드 워커에서 이뤄지며 다운타임이 필요하지 않습니다.

1. 패키지를 이관합니다.

   • Linux 패키지 (Omnibus)
   • 자체 컴파일 (원본)

   sudo gitlab-rake "gitlab:packages:migrate"
   

   RAILS_ENV=production sudo -u git -H bundle exec rake gitlab:packages:migrate
   

2. 진행 상황을 추적하고, 모든 패키지가 성공적으로 이관되었는지를 PostgreSQL 콘솔을 사용하여 확인합니다.

   • Linux 패키지 (Omnibus) 14.1 이전
   • Linux 패키지 (Omnibus) 14.2 이후
   • 자체 컴파일 (원본)

   sudo gitlab-rails dbconsole
   

   sudo gitlab-rails dbconsole --database main
   

   RAILS_ENV=production sudo -u git -H psql -d gitlabhq_production
   

3. 모든 패키지가 객체 스토리지로 이관되었는지 다음 SQL 쿼리를 사용하여 확인합니다. objectstg의 수는 total과 동일해야 합니다:

   gitlabhq_production=# SELECT count(*) AS total, sum(case when file_store = '1' then 1 else 0 end) AS filesystem, sum(case when file_store = '2' then 1 else 0 end) AS objectstg FROM packages_package_files;
   
   total | filesystem | objectstg
   ------+------------+-----------
    34   |          0 |        34
   

4. 마지막으로, packages 디렉토리에 디스크에 파일이 없는지 확인합니다.

   • Linux 패키지 (Omnibus)
   • 자체 컴파일 (원본)

   sudo find /var/opt/gitlab/gitlab-rails/shared/packages -type f | grep -v tmp | wc -l
   

   sudo -u git find /home/git/gitlab/shared/packages -type f | grep -v tmp | wc -l