파일 업로드 관리
파일 업로드는 사용자 데이터를 한 파일로 GitLab에 보낼 수 있는 모든 것을 나타냅니다. 예를 들어, 아바타와 노트 첨부 파일이 파일 업로드에 해당됩니다. 업로드는 GitLab 기능에 불가결하며 따라서 비활성화할 수 없습니다.
로컬 저장소 사용
이것은 기본 구성입니다. 업로드가 로컬로 저장되는 위치를 변경하려면 설치 방법에 따라 이 섹션의 단계를 사용하세요:
uploads/-/system
입니다. 기존의 GitLab 설치에서 기본 디렉토리를 변경하는 것은 강력히 권장하지 않습니다.Linux 패키지 설치의 경우:
기본적으로 업로드는 /var/opt/gitlab/gitlab-rails/uploads
에 저장됩니다.
-
예를 들어 저장 경로를
/mnt/storage/uploads
로 변경하려면/etc/gitlab/gitlab.rb
를 편집하고 다음 라인을 추가하세요:gitlab_rails['uploads_directory'] = "/mnt/storage/uploads"
이 설정은
gitlab_rails['uploads_storage_path']
디렉토리를 변경하지 않은 경우에만 적용됩니다. -
변경 사항이 적용되려면 파일을 저장하고 GitLab을 다시 구성하세요.
자체 컴파일 설치의 경우:
기본적으로 업로드는 /home/git/gitlab/public/uploads
에 저장됩니다.
-
예를 들어 저장 경로를
/mnt/storage/uploads
로 변경하려면/home/git/gitlab/config/gitlab.yml
을 편집하고 다음 라인을 추가하거나 수정하세요:uploads: storage_path: /mnt/storage base_dir: uploads
-
변경 사항이 적용되려면 파일을 저장하고 GitLab을 다시 시작하세요.
객체 저장소 사용
GitLab이 설치된 로컬 디스크를 사용하지 않고 업로드를 저장하려면 AWS S3와 같은 객체 저장소 공급자를 대신 사용할 수 있습니다. 이 구성은 이미 유효한 AWS 자격 증명이 구성되어 있는 것을 가정합니다.
GitLab에서 객체 저장소 사용에 대해 자세히 알아보기.
객체 저장소 설정
GitLab 13.2 이상에서는 통합된 객체 저장소 설정을 사용해야 합니다. 이 섹션은 초기 구성 형식을 설명합니다.
자체 컴파일 설치의 경우, 다음 설정은 uploads:
그리고 object_store:
의 하위에 중첩되어 있습니다. Linux 패키지 설치의 경우, uploads_object_store_
로 접두어가 붙습니다.
설정 | 설명 | 기본값 |
---|---|---|
enabled
| 객체 저장소 사용 여부 | false
|
remote_directory
| 업로드가 저장된 버킷 이름 | |
proxy_download
| 모든 파일 프록시 다운로드를 활성화하려면 true 로 설정합니다. 이 옵션은 클라이언트가 모든 데이터를 프록시하는 대신 원격 저장소에서 직접 다운로드할 수 있도록 하여 전송 트래픽을 줄일 수 있습니다
| false
|
connection
| 아래에 설명된 다양한 연결 옵션 |
연결 설정
다양한 공급자에 대한 사용 가능한 연결 설정을 확인하세요(object_storage.md#configure-the-connection-settings).
Linux 패키지 설치의 경우:
기본적으로 업로드는 /var/opt/gitlab/gitlab-rails/uploads
에 저장됩니다.
-
원하는 값으로 대체하여 다음 라인을 추가하여
/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 }
- 변경 사항이 적용되려면 파일을 저장하고 GitLab을 다시 구성하세요.
- 기존 로컬 업로드를 모두 객체 저장소로 이전하려면
gitlab:uploads:migrate:all
Rake 작업을 수행하세요.
자체 컴파일 설치의 경우:
기본적으로 업로드는 /home/git/gitlab/public/uploads
에 저장됩니다.
-
적절한 값으로 appropriate ones for your provider 사용하여 다음 라인을 추가하거나 수정하고, 파일을 저장하세요:
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
- 변경 사항이 적용되려면 파일을 저장하고 GitLab을 다시 시작하세요.
- 기존 로컬 업로드를 모두 객체 저장소로 이전하려면
gitlab:uploads:migrate:all
Rake 작업을 수행하세요.