Geo 설정

Tier: 프리미엄, 얼티메이트 Offering: Self-managed

전제 조건

  • 독립적으로 작동하는 GitLab 사이트 두 개(또는 그 이상):
    • 하나의 GitLab 사이트는 Geo 주(primary) 사이트로 사용됩니다. 이를 설정하려면 GitLab 참조 아키텍처 문서를 사용하세요. 각 Geo 사이트에 대해 다른 참조 아키텍처 크기를 사용할 수 있습니다. 이미 사용 중인 작동 중인 GitLab 인스턴스가 있는 경우 이를 주(primary) 사이트로 사용할 수 있습니다.
    • 두 번째 GitLab 사이트는 Geo 보조(secondary) 사이트로 사용됩니다. 이를 설정하려면 GitLab 참조 아키텍처 문서를 사용하세요. 로그인하여 테스트하는 것이 좋습니다. 그러나 보조(secondary) 사이트의 모든 데이터가 주(primary) 사이트에서 복제하는 과정의 일부로 손실될 수 있다는 것을 인지하십시오.

    참고: Geo는 여러 보조 사이트를 지원합니다. 동일한 단계를 따르고 필요에 따라 변경할 수 있습니다.

  • 주(primary) 사이트가 Geo를 잠금 해제하려면 GitLab 프리미엄 또는 얼티메이트 구독이 있는지 확인하세요. 모든 사이트에 대해 라이선스가 하나만 필요합니다.
  • Geo 실행을 위한 요구 사항이 모든 사이트에서 충족되었는지 확인하세요. 예를 들어, 사이트는 동일한 GitLab 버전을 사용해야 하며, 특정 포트를 통해 서로 통신할 수 있어야 합니다.
  • 주(primary) 및 보조(secondary) 사이트의 저장 구성이 일치하는지 확인하세요. 주 Geo 사이트가 객체 저장을 사용하는 경우, 보조 Geo 사이트도 사용해야 합니다. 자세한 내용은 객체 저장을 사용한 Geo를 참조하세요.
  • 주(primary) 사이트와 보조(secondary) 사이트 간의 시계가 동기화되어 있는지 확인하세요. 동기화된 시계는 Geo가 올바르게 기능하기 위해 필요합니다. 예를 들어, 주(primary) 사이트와 보조(secondary) 사이트 간의 시계 이격이 1분을 초과하면 복제가 실패합니다.

Linux 패키지 설치 사용

GitLab을 Linux 패키지를 사용하여 설치한 경우(강력히 추천), Geo 설정 프로세스는 단일 노드 Geo 사이트 또는 다중 노드 Geo 사이트를 설정해야 하는지에 따라 다를 수 있습니다.

단일 노드 Geo 사이트

두 Geo 사이트 모두 1K 참조 아키텍처를 기반으로 한 경우 두 개의 단일 노드 사이트를 위한 Geo 설정를 따르세요.

외부 PostgreSQL 서비스(예: Amazon RDS)를 사용하는 경우 외부 PostgreSQL 서비스를 사용한 두 개의 단일 노드 사이트를 위한 Geo 설정를 따르세요.

GitLab 배포에 따라 LDAP, 객체 저장 및 컨테이너 레지스트리에 대한 추가 구성이 필요할 수 있습니다.

다중 노드 Geo 사이트

사이트 중 하나 이상이 2K 참조 아키텍처 이상을 사용하는 경우 여러 노드에 대한 Geo 구성을 참조하세요.

GitLab 배포에 따라 LDAP, 객체 저장 및 컨테이너 레지스트리에 대한 추가 구성이 필요할 수 있습니다.

참조를 위한 일반적인 단계

  1. PostgreSQL 인스턴스의 데이터베이스 복제를 선택한대로 설정하십시오(주(primary) (읽기-쓰기) <-> 보조(secondary) (읽기 전용) 토폴로지):
  2. 주(primary) 및 보조(secondary) 사이트를 설정하기 위해 GitLab을 구성하세요.
  3. Geo 사이트 사용 방법 가이드를 따르세요.

GitLab 배포에 따라 LDAP, 객체 저장 및 컨테이너 레지스트리에 대한 추가 구성이 필요할 수 있습니다.

추가 구성

GitLab 사용 방식에 따라 다음 구성이 필요할 수 있습니다:

모든 Geo 사이트에 대해 단일 통합 URL을 사용하기 위해 단일 통합 URL 설정을 구성해야 합니다.

GitLab Charts 사용

GitLab 차트에 GitLab Geo를 구성하세요.

Geo 및 자체 컴파일 설치

Geo는 자체 컴파일된 GitLab 설치를 사용할 때 지원되지 않습니다.

설치 후 문서

secondary 사이트에 GitLab을 설치한 후 초기 구성을 수행한 경우 다음 설명서를 참조하여 설치 후 정보를 확인하십시오.