GitLab 의존성 프록시 관리

Tier: Free, Premium, Ultimate Offering: Self-Managed

GitLab은 다양한 일반 패키지 관리자에 대한 의존성 프록시로 사용할 수 있습니다.

이것은 관리 문서입니다. 의존성 프록시를 사용하는 방법을 알고 싶다면 사용자 안내서를 참조하세요.

GitLab 의존성 프록시:

  • 기본적으로 켜져 있습니다.
  • 관리자가 끌 수 있습니다.
  • Puma 웹 서버가 활성화되어 있어야 합니다. Puma는 GitLab 13.0 이후로 기본적으로 활성화됩니다.

의존성 프록시 끄기

의존성 프록시는 기본적으로 켜져 있습니다. 관리자인 경우에 의존성 프록시를 끌 수 있습니다. 의존성 프록시를 끄려면 GitLab 설치에 해당하는 지침을 따르세요.

Linux 패키지 (Omnibus)
  1. /etc/gitlab/gitlab.rb 파일을 편집하고 다음 라인을 추가하세요:

    gitlab_rails['dependency_proxy_enabled'] = false
    
  2. 파일을 저장하고 변경 사항이 적용되게 하려면 GitLab 재구성을 실행하세요.

Helm 차트 (Kubernetes)

설치가 완료되면 전역appConfig을 업데이틀 의존성 프록시를 끄려면 다음과 같이 수정하세요:

global:
  appConfig:
    dependencyProxy:
      enabled: false
      bucket: gitlab-dependency-proxy
      connection: {}
       secret:
       key:

추가 정보는 Globals를 사용하여 차트 구성을 참조하세요.

직접 컴파일한 경우 (소스)
  1. 설치가 완료된 후 config/gitlab.yml에서 dependency_proxy 섹션을 구성하세요. 의존성 프록시를 끄려면 enabledfalse로 설정하세요:

    dependency_proxy:
      enabled: false
    
  2. 변경 사항이 적용되게 하려면 GitLab 재시작을 실행하세요.

다중 노드 GitLab 설치

각 Web 및 Sidekiq 노드에 대해 Linux 패키지 설치 단계를 따르세요.

의존성 프록시 켜기

의존성 프록시는 기본적으로 켜져 있지만 관리자가 끌 수 있습니다. 수동으로 끄려면 의존성 프록시 끄기의 지침을 따르세요.

저장 경로 변경

기본적으로, 의존성 프록시 파일은 로컬에 저장되지만 기본 로컬 위치를 변경하거나 객체 저장소를 사용할 수 있습니다.

로컬 저장 경로 변경

Linux 패키지 설치의 의존성 프록시 파일은 /var/opt/gitlab/gitlab-rails/shared/dependency_proxy/에 저장되며, 소스 설치의 경우 shared/dependency_proxy/하위에 저장됩니다(Git 홈 디렉터리를 기준으로 함).

Linux 패키지 (Omnibus)
  1. /etc/gitlab/gitlab.rb 파일을 편집하고 다음 라인을 추가하세요:

    gitlab_rails['dependency_proxy_storage_path'] = "/mnt/dependency_proxy"
    
  2. 파일을 저장하고 변경 사항이 적용되게 하려면 GitLab 재구성을 실행하세요.

직접 컴파일한 경우 (소스)
  1. config/gitlab.ymldependency_proxy 섹션을 편집하세요:

    dependency_proxy:
      enabled: true
      storage_path: shared/dependency_proxy
    
  2. 변경 사항이 적용되게 하려면 GitLab 재시작을 실행하세요.

객체 저장소 사용

로컬 저장소 대신 객체 저장소를 사용하여 의존성 프록시의 덩어리를 저장할 수 있습니다. GitLab 13.2에서 이전 구성 형식에도 마이그레이션 단계가 적용됩니다.

GitLab과 객체 저장소를 사용에 대해 더 읽어보세요(../object_storage.md).

Linux 패키지 (Omnibus)
  1. /etc/gitlab/gitlab.rb 파일을 편집하고 다음 라인을 추가하세요 (필요한 곳의 주석을 제거하세요):

    gitlab_rails['dependency_proxy_enabled'] = true
    gitlab_rails['dependency_proxy_storage_path'] = "/var/opt/gitlab/gitlab-rails/shared/dependency_proxy"
    gitlab_rails['dependency_proxy_object_store_enabled'] = true
    gitlab_rails['dependency_proxy_object_store_remote_directory'] = "dependency_proxy" # 버킷 이름.
    gitlab_rails['dependency_proxy_object_store_proxy_download'] = false        # Redirects to Object Storage를 사용하는 대신에 모든 다운로드를 GitLab을 통해 패스스루합니다.
    gitlab_rails['dependency_proxy_object_store_connection'] = {
      ##
      ## AWS S3 공급업체를 사용하는 경우 다음 주석을 제거하세요
      ##
      #'provider' => 'AWS',
      #'region' => 'eu-west-1',
      #'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
      #'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY',
      ##
      ## AWS 이외 (S3와 호환되는 공급업체)를 사용하는 경우 다음 주석을 제거하세요
      ##
      #'host' => 's3.amazonaws.com',
      #'aws_signature_version' => 4             # 서명된 URL을 만들 때 사용합니다. 공급업체가 v4를 지원하지 않으면 2로 설정하세요.
      #'endpoint' => 'https://s3.amazonaws.com' # DigitalOcean Spaces와 같은 S3 호환 서비스에 유용합니다.
      #'path_style' => false                    # true이면 'host/bucket_name/object' 대신에 'bucket_name.host/object'를 사용합니다.
    }
    
  2. 파일을 저장하고 변경 사항이 적용되게 하려면 GitLab 재구성을 실행하세요.

직접 컴파일한 경우 (소스)
  1. config/gitlab.yml에서 dependency_proxy 섹션을 편집하세요 (필요한 곳의 주석을 제거하세요):

    dependency_proxy:
      enabled: true
      ##
      ## 빌드 의존성 프록시가 저장된 위치 (기본값: shared/dependency_proxy).
      ##
      # storage_path: shared/dependency_proxy
      object_store:
        enabled: false
        remote_directory: dependency_proxy  # 버킷 이름.
        #  proxy_download: false     # Redirects to Object Storage를 사용하는 대신에 모든 다운로드를 GitLab을 통해 패스스루합니다.
        connection:
        ##
        ## AWS S3를 사용하는 경우 다음을 사용하세요
        ##
          provider: AWS
          region: us-east-1
          aws_access_key_id: AWS_ACCESS_KEY_ID
          aws_secret_access_key: AWS_SECRET_ACCESS_KEY
          ##
          ## AWS 이외 (S3와 호환되는 공급업체)를 사용하는 경우 이전 4줄을 주석 처리하고 다음을 사용하세요:
          ##
          #  host: 's3.amazonaws.com'             # 기본값: s3.amazonaws.com.
          #  aws_signature_version: 4             # 서명된 URL을 만들 때 사용합니다. 공급업체가 v4를 지원하지 않으면 2로 설정하세요.
          #  endpoint: 'https://s3.amazonaws.com' # DigitalOcean Spaces와 같은 S3 호환 서비스에 유용합니다.
          #  path_style: false                    # true이면 'host/bucket_name/object' 대신에 'bucket_name.host/object'를 사용합니다.
    
  2. 변경 사항이 적용되게 하려면 GitLab 재시작을 실행하세요.

로컬 종속성 프록시 블롭 및 매니페스트를 객체 저장소로 이전

객체 저장소 사용를 구성한 후에, 기존 Dependency Proxy 블롭과 매니페스트를 로컬 저장소에서 원격 저장소로 마이그레이션하는 다음 작업을 사용합니다. 처리는 백그라운드 워커에서 이루어지며 다운타임이 필요하지 않습니다.

  • Linux 패키지 설치의 경우:

    sudo gitlab-rake "gitlab:dependency_proxy:migrate"
    
  • 직접 컴파일한 설치의 경우:

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

옵션으로 진행 상황을 추적하고 모든 종속성 프록시 블롭과 매니페스트가 성공적으로 마이그레이션되었는지 확인할 수 있습니다. PostgreSQL 콘솔을 사용합니다:

  • 버전 14.1 및 그 이전의 Linux 패키지 설치를 실행 중인 경우: sudo gitlab-rails dbconsole
  • 버전 14.2 이상의 Linux 패키지 설치를 실행 중인 경우: sudo gitlab-rails dbconsole --database main
  • 직접 컴파일한 인스턴스의 경우: sudo -u git -H psql -d gitlabhq_production

쿼리별로 모든 Dependency Proxy 블롭과 매니페스트의 수가 objectstg (여기서 file_store = '2')에 있는지 확인하세요:

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 dependency_proxy_blobs;

total | filesystem | objectstg
------+------------+-----------
 22   |          0 |        22

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 dependency_proxy_manifests;

total | filesystem | objectstg
------+------------+-----------
 10   |          0 |        10

dependency_proxy 폴더에 디스크에 파일이 없는지 확인하세요:

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

JWT 만료 기간 변경

Dependency Proxy는 Docker v2 토큰 인증 흐름을 따라 클라이언트에게 풀 요청에 사용할 JWT를 발급합니다. 토큰 만료 시간은 애플리케이션 설정 container_registry_token_expire_delay를 사용하여 구성할 수 있습니다. 레일즈 콘솔에서 변경할 수 있습니다:

# JWT 만료를 30분으로 업데이트
ApplicationSetting.update(container_registry_token_expire_delay: 30)

기본 만료 및 GitLab.com의 만료 시간은 15분입니다.

프록시 뒤에 종속성 프록시 사용

  1. /etc/gitlab/gitlab.rb 파일을 편집하고 다음 라인을 추가합니다:

    gitlab_workhorse['env'] = {
     "http_proxy" => "http://USERNAME:PASSWORD@example.com:8080",
     "https_proxy" => "http://USERNAME:PASSWORD@example.com:8080"
    
  2. 파일을 저장하고 변경 사항이 적용되도록 GitLab을 다시 구성합니다.