지원되는 지오 데이터 유형

### Git 저장소

GitLab 인스턴스는 하나 이상의 저장소 샤드를 가질 수 있습니다. 각 샤드에는 로컬로 저장된 Git 저장소에 대한 액세스 및 작업을 허용하는 Gitaly 인스턴스가 있습니다. 이 인스턴스는 다음과 같은 기계에서 실행할 수 있습니다.

- 단일 디스크가 장착된 기기에서.
- 하나로 마운트된 복수 디스크가 있는 기기에서 (RAID 배열과 같이).
- LVM을 사용하여.

GitLab은 특별한 파일 시스템을 필요로 하지 않으며, 마운트된 스토리지 장비와 함께 작동할 수 있습니다. 그러나 원격 파일 시스템을 사용할 때 성능 제약과 일관성 문제가 발생할 수 있습니다.

Geo는 Geo 이차 사이트에서 포크된 저장소를 중복으로 제거하기 위해 Gitaly에서 가비지 수집을 트리거합니다.

Gitaly gRPC API는 세 가지 동기화 방법을 사용하여 통신합니다.

- 특별한 인증을 사용하여 한 Geo 사이트에서 다른 사이트로 정기적으로 Git을 클론/페치하는 방법으로.
- 리포지토리 스냅샷을 사용하여 (첫 번째 방법이 실패하거나 리포지토리가 손상된 경우).
- '관리자' 영역에서의 수동 트리거 (위의 두 가지 방법의 조합).

각 프로젝트는 최대 3개의 다른 저장소를 가질 수 있습니다.

- 프로젝트 저장소: 소스 코드가 저장되는 위치입니다.
- 위키 저장소: 위키 콘텐츠가 저장되는 위치입니다.
- 디자인 저장소: 디자인 자산이 색인화되는 위치입니다 (실제 자산은 LFS에 있음).

모든 저장소는 동일한 샤드에 있으며 위키 및 디자인 저장소 경우에는 `-wiki` 및 `-design` 접미사와 함께 동일한 기본 이름을 공유합니다.

이외에도 스니펫 저장소가 있습니다. 이들은 프로젝트나 특정 사용자에 연결될 수 있습니다. 두 유형 모두 Geo 이차 사이트에 동기화됩니다.

### 블롭

GitLab은 파일 및 LFS 개체와 같은 블롭을 다음과 같이 저장합니다.

- 특정 위치에 파일 시스템.
- [객체 저장](../../object_storage.md) 솔루션. 객체 저장 솔루션은 다음과 같을 수 있습니다.
  - 클라우드 기반으로 Amazon S3 및 Google Cloud Storage와 같이.
  - MinIO와 같이 본인이 호스팅하는 경우.
  - 객체 저장 호환 API를 노출하는 스토리지 장비.

객체 저장을 사용할 때 여러 노드를 사용할 경우 GitLab을 실행하기 위해 네트워크 마운트된 파일 시스템을 사용하세요.

복제 및 검증에 대해:

- 내부 API 요청을 사용하여 파일 및 블롭을 전송합니다.
- 객체 저장을 사용할 경우, 다음 중 하나를 선택할 수 있습니다:
  - 클라우드 제공자 복제 기능을 사용합니다.
  - GitLab이 대신 복제합니다.

### 데이터베이스

GitLab은 다양한 사용 사례에 대해 여러 데이터베이스에 저장된 데이터에 의존합니다. PostgreSQL은 Web 인터페이스에서 사용자가 생성한 콘텐츠(이슈 콘텐츠, 코멘트 및 권한, 자격 증명 등)에 대해 단일 진실의 지점입니다.

PostgreSQL은 HTML로 렌더링된 Markdown과 캐싱된 병합 요청 차이와 같은 일부 수준의 캐시된 데이터도 보유할 수 있습니다. 이 데이터는 객체 저장 장치로 오프로드되도록 구성할 수도 있습니다.

우리는 PostgreSQL의 자체 복제 기능을 사용하여 '주(primary)' 사이트에서 '이차(secondary)' 사이트로부터 데이터를 복제합니다.

우리는 Redis를 캐시 저장소로 사용하고 백그라운드 작업 시스템에서 지속적인 데이터를 보유하기 위해 사용합니다. 두 사용 사례 모두 동일한 Geo 사이트에서만 사용되는 데이터가 있기 때문에, 우리는 이를 사이트 사이에서 복제하지 않습니다.

Elasticsearch는 고급 검색을 위한 선택적 데이터베이스입니다. 이것은 소스 코드 수준뿐만 아니라 이슈, 병합 요청 및 토의에서 사용자 생성 콘텐츠의 검색을 개선할 수 있습니다. Elasticsearch는 Geo에서 지원되지 않습니다.

## 복제된 데이터 유형

### 기능 플래그 뒤에 있는 복제된 데이터 유형

일부 데이터 유형의 복제는 해당 기능 플래그 뒤에 있습니다.

> - 기능 플래그 뒤에 배포되었으며 기본적으로 활성화되어 있습니다.
> - GitLab.com에 활성화되어 있습니다.
> - 프로젝트 단위로 활성화 또는 비활성화할 수 없습니다.
> - 프로덕션 환경에서 추천됩니다.
> - GitLab 셀프 매니지드 인스턴스의 경우, GitLab 관리자는 [비활성화](#enable-or-disable-replication-for-some-data-types)할 수 있습니다.

#### 일부 데이터 유형에 대한 복제 활성화 또는 비활성화

일부 데이터 유형에 대한 복제는 **기본적으로 활성화된** 기능 플래그 뒤에 있습니다. [GitLab 레일즈 콘솔에 액세스](../../feature_flags.md)할 수 있는 GitLab 관리자는 인스턴스에서 이를 비활성화할 수 있습니다. 각 데이터 유형의 기능 플래그 이름은 아래 표의 노트 열에 나와 있습니다.

예를 들어, 패키지 파일 복제를 비활성화하려면:

```ruby
Feature.disable(:geo_package_file_replication)