업로드 관리

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

업로드는 GitLab에 단일 파일로 전송될 수 있는 모든 사용자 데이터를 나타냅니다. 예를 들어, 아바타 및 노트 첨부 파일은 업로드입니다. 업로드는 GitLab 기능에 필수적이므로 비활성화할 수 없습니다.

note
댓글 또는 설명에 추가된 첨부 파일은 부모 프로젝트나 그룹이 삭제될 때만 삭제됩니다. 첨부 파일은 댓글이나 리소스(예: 이슈, 머지 요청, 에픽)에서 삭제되더라도 파일 저장소에 남아 있습니다.

로컬 스토리지 사용

이것은 기본 구성입니다. 업로드가 로컬에 저장되는 위치를 변경하려면 설치 방법에 따라 이 섹션의 단계를 사용하세요:

note
역사적인 이유로 인해 전체 인스턴스의 업로드(예: 파비콘)는 기본 디렉토리에 저장되며, 기본적으로 uploads/-/system입니다. 기존 GitLab 설치에서 기본 디렉토리를 변경하는 것은 강력히 권장되지 않습니다.

Linux 패키지 설치의 경우:

업로드는 기본적으로 /var/opt/gitlab/gitlab-rails/uploads에 저장됩니다.

  1. 저장 경로를 변경하려면, 예를 들어 /mnt/storage/uploads로 변경하려면,
    /etc/gitlab/gitlab.rb를 편집하고 다음 라인을 추가합니다:

    gitlab_rails['uploads_directory'] = "/mnt/storage/uploads"
    

    이 설정은 gitlab_rails['uploads_storage_path'] 디렉토리를 변경하지 않은 경우에만 적용됩니다.

  2. 파일을 저장하고 변경 사항이 적용되도록 GitLab 재구성하기를 수행합니다.

자체 컴파일한 설치의 경우:

업로드는 기본적으로
/home/git/gitlab/public/uploads에 저장됩니다._

  1. 저장 경로를 변경하려면, 예를 들어 /mnt/storage/uploads로 변경하려면,
    /home/git/gitlab/config/gitlab.yml을 편집하고 다음과 같은 행을 추가하거나 수정합니다:

    uploads:
      storage_path: /mnt/storage
      base_dir: uploads
    
  2. 파일을 저장하고 변경 사항이 적용되도록 GitLab 재시작하기를 수행합니다.

객체 스토리지 사용

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

GitLab이 설치된 로컬 디스크를 사용해 업로드를 저장하고 싶지 않다면 대신 AWS S3와 같은 객체 스토리지 공급자를 사용할 수 있습니다. 이 구성은 이미 유효한 AWS 자격 증명이 구성되어 있어야 합니다.

GitLab과 함께 객체 스토지를 사용하는 방법에 대해 더 알아보기.

객체 스토리지 설정

이 섹션은 저장소 특정 구성 형식을 설명합니다.
여러분은 모든 객체 유형에 대한 단일 저장소 연결 구성에 있는 통합된 객체 스토리지 설정을 사용해야 합니다.

자체 컴파일한 설치의 경우, 다음 설정은 uploads: 아래의 object_store:에 중첩되어 있습니다. Linux 패키지 설치에서는 uploads_object_store_로 접두사가 붙습니다.

설정 설명 기본값
enabled 객체 스토리지 활성화/비활성화 false
remote_directory 업로드가 저장되는 버킷 이름  
proxy_download 모든 파일을 제공하는 프록시를 활성화하려면 true로 설정합니다. 이 옵션은 클라이언트가 모든 데이터를 프록시하는 대신 원격 저장소에서 직접 다운로드할 수 있으므로 나가는 트래픽을 줄입니다. false
connection 아래에 설명된 다양한 연결 옵션  

연결 설정

다양한 제공업체에 대한 사용 가능한 연결 설정을 참조하세요.

Linux 패키지 설치의 경우:

업로드는 기본적으로 /var/opt/gitlab/gitlab-rails/uploads에 저장됩니다.

  1. /etc/gitlab/gitlab.rb를 편집하고 원하는 값으로 교체하여 다음 줄을 추가합니다:

    gitlab_rails['uploads_object_store_enabled'] = true
    gitlab_rails['uploads_object_store_remote_directory'] = "uploads"
    gitlab_rails['uploads_object_store_connection'] = {
      'provider' => 'AWS',
      'region' => 'eu-central-1',
      'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
      'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
    }
    

    AWS IAM 프로필을 사용하는 경우, AWS 액세스 키 및 비밀 액세스 키/값 쌍을 생략하세요.

    gitlab_rails['uploads_object_store_connection'] = {
      'provider' => 'AWS',
      'region' => 'eu-central-1',
      'use_iam_profile' => true
    }
    
  2. 파일을 저장하고 GitLab 재구성하여 변경 사항을 적용합니다.

  3. gitlab:uploads:migrate:all Rake 작업을 사용하여 기존 로컬 업로드를 객체 저장소로 마이그레이션합니다.

자체 컴파일 설치의 경우:

업로드는 기본적으로 /home/git/gitlab/public/uploads에 저장됩니다.

  1. /home/git/gitlab/config/gitlab.yml를 편집하고 다음 줄을 추가하거나 수정하며, 제공업체에 맞는 적절한 줄을 사용하세요:

    uploads:
      object_store:
        enabled: true
        remote_directory: "uploads" # 버킷 이름
        connection: # 이 블록의 줄은 제공업체에 따라 다릅니다
          provider: AWS
          aws_access_key_id: AWS_ACCESS_KEY_ID
          aws_secret_access_key: AWS_SECRET_ACCESS_KEY
          region: eu-central-1
    
  2. 파일을 저장하고 GitLab 재시작하여 변경 사항을 적용합니다.

  3. gitlab:uploads:migrate:all Rake 작업을 사용하여 기존 로컬 업로드를 객체 저장소로 마이그레이션합니다.