Geo는 관리자가 보조 사이트에서 동기화할 프로젝트를 선택할 수 있는 선택적 동기화를 지원합니다. 프로젝트의 하위 집합은 그룹 또는 스토리지 샤드로 선택할 수 있습니다. 전자는 사용자의 하위 집합에 속하는 데이터만 복제하여 전송 및 스토리지 비용을 줄이는 데 이상적입니다. 후자는 대규모 GitLab 인스턴스에 Geo를 점진적으로 롤아웃하는 데 더 적합합니다.

선택적 동기화:

1. 보조 사이트의 권한을 제한하지 않습니다.
2. 선택적 동기화에 포함되지 않은 프로젝트 저장소를 사용자가 보고, 상호작용하고, 클론하고, 푸시하는 것을 방지하지 않습니다.
   • 자세한 내용은 보조 사이트를 위한 Geo 프록시를 참조하세요.
3. 보조 사이트에서 프로젝트 메타데이터를 숨기지 않습니다.
   • Geo가 PostgreSQL 복제에 의존하므로 모든 프로젝트 메타데이터는 보조 사이트에 복제되지만, 선택되지 않은 저장소는 보조 사이트에 존재하지 않습니다.
4. Geo 이벤트 로그에 대해 생성되는 이벤트 수를 줄이지 않습니다.
   • 기본 사이트는 보조 사이트가 있는 한 이벤트를 생성합니다. 선택적 동기화 제한은 기본 사이트가 아닌 보조 사이트에서 구현됩니다.

선택적 동기화 활성화#

기본적으로 선택적 동기화는 비활성화되어 있습니다. 활성화하려면:

• 오른쪽 상단 모서리에서 Admin을 선택합니다.

• 왼쪽 사이드바에서 Geo > Sites를 선택합니다.

• 편집할 보조 사이트 옆에서 연필 아이콘을 선택합니다.

• Selective synchronization 드롭다운 목록에서 Projects in certain groups 또는 Projects in certain storage shards를 선택합니다.

• 선택에 따라 Groups to synchronize 또는 Shards to synchronize를 구성합니다.

• Save changes를 선택합니다.

선택적 동기화가 활성화된 보조 사이트 승격#

보조 사이트에 선택적 동기화가 구성된 경우, 데이터의 일부만 복제됩니다:

• 그룹으로 동기화하는 경우: 선택한 그룹의 프로젝트만 복제됩니다.

• 스토리지 샤드로 동기화하는 경우: 선택한 샤드의 프로젝트만 복제됩니다.

• 조직으로 동기화하는 경우: 선택한 조직의 프로젝트만 복제됩니다.

나머지 모든 데이터는 원래 기본 사이트에만 존재합니다. 선택적 동기화가 적용된 보조 사이트를 새 기본 사이트로 승격하면:

• 복제 대상으로 선택되지 않은 데이터는 영구적으로 접근 불가 상태가 됩니다.

• 사용자는 선택적 동기화에서 제외된 프로젝트, 저장소 및 관련 데이터에 접근할 수 없게 됩니다.

• 원래 기본 사이트에 여전히 접근할 수 있는 경우를 제외하고 이 데이터는 복구할 수 없습니다.

권장 사항#

선택적 동기화가 적용된 보조 사이트를 승격하기 전:

• 승격할 보조 사이트에서 선택적 동기화를 비활성화합니다.

• 전체 복제가 완료될 때까지 기다립니다. Geo 대시보드를 모니터링하여 모든 데이터 유형이 100% 동기화된 것을 확인합니다.

• 복제가 완료되었는지 확인한 후 승격을 진행합니다.

• 그런 다음 계획된 장애 조치 프로세스를 진행합니다.

긴급 상황 등으로 인해 선택적 동기화가 활성화된 보조 사이트를 승격해야 하는 경우:

• 손실될 데이터를 문서화합니다.

• 이해 관계자들이 데이터 손실을 이해하고 수용하도록 합니다.

• 원래 기본 사이트가 다시 사용 가능한 경우 백업 또는 원래 기본 사이트에서 누락된 데이터를 복원할 계획을 수립합니다.

복제되지 않은 저장소의 Git 작업#

HTTP(S) 및 SSH를 통한 Git clone, pull, push 작업은 기본 사이트에는 존재하지만 보조 사이트에는 없는 저장소에 대해 지원됩니다. 이 상황은 다음과 같은 경우에 발생할 수 있습니다:

• 선택적 동기화가 저장소에 연결된 프로젝트를 포함하지 않는 경우.
• 저장소가 활발하게 복제 중이지만 아직 완료되지 않은 경우.