지원되는 Geo 데이터 유형

### Git 리포지터리

GitLab 인스턴스에는 하나 이상의 리포지터리 샤드가 있을 수 있습니다. 각 샤드에는 지탈리(Gitaly) 인스턴스가 있어 로컬에 저장된 Git 리포지터리에 대한 액세스 및 작업을 담당합니다. 이것은 다음과 같은 머신에서 실행할 수 있습니다.

- 단일 디스크로.
- 하나의 마운트 포인트로 연결된 여러 디스크로(예: RAID 배열과 같이).
- LVM을 사용하여.

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

Geo는 Geo 보조 사이트에서 forked 리포지터리의 중복을 제거하기 위해 Gitaly의 가비지 수집을 트리거합니다. [fork된 리포지터리를 중복으로 제거하는 기능](../../../development/git_object_deduplication.md#git-object-deduplication-and-gitlab-geo)입니다.

Gitaly gRPC API는 통신을 담당하며 동기화하는 방법은 다음과 같습니다.

- Geo 사이트에서 다른 Geo 사이트로 일반적인 Git clone/fetch를 사용하여(특별한 인증을 사용).
- 리포지터리 스냅샷을 사용합니다(첫 번째 방법이 실패하거나 리포지터리가 손상된 경우).
- 관리 영역에서 매뉴얼 트리거(위의 두 가지의 조합).

각 프로젝트는 최대 3개의 다른 리포지터리를 가질 수 있습니다.

- 프로젝트 리포지터리, 소스 코드가 저장되는 곳.
- 위키 리포지터리, 위키 콘텐츠가 저장되는 곳.
- 디자인 리포지터리, 디자인 자산이 색인화되는 곳(실제로 자산은 LFS에 저장됩니다).

모두 동일한 샤드에 있으며 위키 및 디자인 리포지터리의 경우 `-wiki` 및 `-design` 접미사가 있는 동일한 기본 이름을 공유합니다.

이외에도, 스니펫 리포지터리가 있습니다. 이것은 프로젝트 또는 특정 사용자에 연결될 수 있습니다. 두 유형 모두 보조 사이트에 동기화됩니다.

### 블롭

GitLab은 파일 및 블롭(예: 이슈 첨부 파일 또는 LFS 객체)을 다음 중 하나로 저장합니다.

- 특정 위치(파일 시스템 내).
- [오브젝트 스토리지](../../object_storage.md) 솔루션. 객체 리포지터리 솔루션은 다음과 같습니다.
  - 클라우드 기반(예: Amazon S3 및 Google Cloud Storage).
  - 사용자가 호스팅하는 것(예: MinIO).
  - 오브젝트 스토리지과 호환되는 API를 노출하는 스토리지 앱.

오브젝트 스토리지을 사용할 때, 하나 이상의 노드를 사용할 때 GitLab을 실행하는 데 네트워크 마운트된 파일 시스템을 사용해야 합니다.

복제 및 확인에 관해서:

- 내부 API 요청을 사용하여 파일과 블롭을 전송합니다.
- 오브젝트 스토리지을 사용할 때, 다음 중 하나를 사용할 수 있습니다.
  - 클라우드 공급업체의 복제 기능을 사용합니다.
  - GitLab이 대신 복제하도록 할 수 있습니다.

### 데이터베이스

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

PostgreSQL은 HTML로 렌더링된 Markdown 및 캐시된 머지 요청의 몇 가지 수준의 캐시된 데이터를 보유할 수도 있습니다. 이것 또한 오브젝트 스토리지으로 오프로드하도록 설정할 수 있습니다.

우리는 PostgreSQL의 복제 기능을 사용하여 **기본**에서 **보조** 사이트로 데이터를 복제합니다.

우리는 Redis를 캐시 스토어로 사용하며 백그라운드 작업 시스템의 지속 데이터를 보관합니다. 두 사용 사례 모두 동일한 Geo 사이트에 대한 배타적인 데이터를 가지고 있기 때문에 우리는 사이트 간에 복제하지 않습니다.

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

## 복제/확인에 대한 제한

다음 표는 **보조** 사이트에서 GitLab 기능과 그들의 복제 및 확인 상태를 보여줍니다.

실현되지 않은 항목들을 구현하기 위한 진척 상황은 다음 에픽/이슈를 통해 추적할 수 있습니다.

- [Geo: 자체 서비스 Geo 복제 프레임워크 개선](https://gitlab.com/groups/gitlab-org/-/epics/3761)
- [Geo: 기존 블롭을 프레임워크로 이동](https://gitlab.com/groups/gitlab-org/-/epics/3588)

### 피처 플래그 뒤에 있는 복제

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

> - 피처 플래그 뒤에 배포되어 있으며 기본적으로 활성화됩니다.
> - GitLab.com에서 활성화됩니다.
> - 프로젝트 당으로 활성화 또는 비활성화할 수 없습니다.
> - 프로덕션 환경에서 권장됩니다.
> - Self-managed GitLab 인스턴스에서 GitLab 관리자는 [비활성화](#일부-데이터-유형에-대한-복제를-활성화-또는-비활성화)할 수 있습니다.

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

일부 데이터 유형의 복제는 피처 플래그 뒤에 배포되어 있고 **기본적으로 활성화**되어 있습니다. [GitLab Rails 콘솔에 액세스할 수 있는 GitLab 관리자](../../feature_flags.md)는 인스턴스에 대해 비활성화할 수 있습니다. 해당 데이터 유형의 피처 플래그 이름을 아래 표의 노트 열에서 찾을 수 있습니다.

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

```ruby
Feature.disable(:geo_package_file_replication)