InfoGrab DocsInfoGrab Docs

선택적 동기화

요약

Geo는 관리자가 보조 사이트에서 동기화할 프로젝트를 선택할 수 있는 선택적 동기화를 지원합니다. Geo의 동기화 로직은 문서에 설명되어 있습니다. 보조 사이트의 권한을 제한하지 않습니다. 선택적 동기화에 포함되지 않은 프로젝트 저장소를 사용자가 보고, 상호작용하고, 클론하고, 푸시하는 것을 방지하지 않습니다.

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

Note

Geo의 동기화 로직은 문서에 설명되어 있습니다. 솔루션과 문서 모두 때때로 변경될 수 있습니다. 개인 정보 보호 및 사이버 보안 법률, 적용 가능한 무역 통제법에 관한 법적 의무를 지속적으로 독립적으로 결정해야 합니다.

선택적 동기화:

  • 보조 사이트의 권한을 제한하지 않습니다.

  • 선택적 동기화에 포함되지 않은 프로젝트 저장소를 사용자가 보고, 상호작용하고, 클론하고, 푸시하는 것을 방지하지 않습니다.

    자세한 내용은 보조 사이트를 위한 Geo 프록시를 참조하세요.

  • 보조 사이트에서 프로젝트 메타데이터를 숨기지 않습니다.

    Geo가 PostgreSQL 복제에 의존하므로 모든 프로젝트 메타데이터는 보조 사이트에 복제되지만, 선택되지 않은 저장소는 보조 사이트에 존재하지 않습니다.

  • Geo 이벤트 로그에 대해 생성되는 이벤트 수를 줄이지 않습니다.

    기본 사이트는 보조 사이트가 있는 한 이벤트를 생성합니다. 선택적 동기화 제한은 기본 사이트가 아닌 보조 사이트에서 구현됩니다.

선택적 동기화 활성화#

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

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

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

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

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

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

  • Save changes를 선택합니다.

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

Warning

선택적 동기화가 활성화된 보조 사이트를 기본 사이트로 승격하면 해당 보조 사이트에 복제되지 않은 모든 데이터가 영구적으로 손실됩니다.

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

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

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

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

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

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

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

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

Warning

승격 프로세스에는 이 시나리오를 방지하는 유효성 검사나 경고가 없습니다.

권장 사항#

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

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

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

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

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

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

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

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

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

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

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

  • 선택적 동기화가 저장소에 연결된 프로젝트를 포함하지 않는 경우.

  • 저장소가 활발하게 복제 중이지만 아직 완료되지 않은 경우.

선택적 동기화

GitLab v19.2
Tier: Premium, Ultimate
Offering: GitLab Self-Managed
원문 보기
요약

Geo는 관리자가 보조 사이트에서 동기화할 프로젝트를 선택할 수 있는 선택적 동기화를 지원합니다. Geo의 동기화 로직은 문서에 설명되어 있습니다. 보조 사이트의 권한을 제한하지 않습니다. 선택적 동기화에 포함되지 않은 프로젝트 저장소를 사용자가 보고, 상호작용하고, 클론하고, 푸시하는 것을 방지하지 않습니다.

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

Note

Geo의 동기화 로직은 문서에 설명되어 있습니다. 솔루션과 문서 모두 때때로 변경될 수 있습니다. 개인 정보 보호 및 사이버 보안 법률, 적용 가능한 무역 통제법에 관한 법적 의무를 지속적으로 독립적으로 결정해야 합니다.

선택적 동기화:

  • 보조 사이트의 권한을 제한하지 않습니다.

  • 선택적 동기화에 포함되지 않은 프로젝트 저장소를 사용자가 보고, 상호작용하고, 클론하고, 푸시하는 것을 방지하지 않습니다.

    자세한 내용은 보조 사이트를 위한 Geo 프록시를 참조하세요.

  • 보조 사이트에서 프로젝트 메타데이터를 숨기지 않습니다.

    Geo가 PostgreSQL 복제에 의존하므로 모든 프로젝트 메타데이터는 보조 사이트에 복제되지만, 선택되지 않은 저장소는 보조 사이트에 존재하지 않습니다.

  • Geo 이벤트 로그에 대해 생성되는 이벤트 수를 줄이지 않습니다.

    기본 사이트는 보조 사이트가 있는 한 이벤트를 생성합니다. 선택적 동기화 제한은 기본 사이트가 아닌 보조 사이트에서 구현됩니다.

선택적 동기화 활성화#

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

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

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

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

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

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

  • Save changes를 선택합니다.

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

Warning

선택적 동기화가 활성화된 보조 사이트를 기본 사이트로 승격하면 해당 보조 사이트에 복제되지 않은 모든 데이터가 영구적으로 손실됩니다.

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

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

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

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

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

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

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

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

Warning

승격 프로세스에는 이 시나리오를 방지하는 유효성 검사나 경고가 없습니다.

권장 사항#

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

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

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

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

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

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

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

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

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

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

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

  • 선택적 동기화가 저장소에 연결된 프로젝트를 포함하지 않는 경우.

  • 저장소가 활발하게 복제 중이지만 아직 완료되지 않은 경우.