Geo 사이트 관리 영역
Offering: GitLab Self-Managed
GitLab Geo 사이트의 다양한 설정을 구성할 수 있습니다. 모든 Geo 사이트에는 다음 설정이 있습니다: 허용된 Geo IP 설정은 보조 사이트에서 기본 사이트로 요청할 수 있는 IP 주소를 제어합니다. 보조 사이트에는 사용 가능한 추가 설정이 많이 있습니다:
GitLab Geo 사이트의 다양한 설정을 구성할 수 있습니다. 자세한 내용은 Geo 문서를 참조하세요.
사전 요구 사항:
- 관리자 액세스.
기본 또는 보조 사이트에서:
- 오른쪽 상단 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Geo > Sites를 선택합니다.
공통 설정#
모든 Geo 사이트에는 다음 설정이 있습니다:
| 설정 | 설명 |
|---|---|
| Primary | Geo 사이트를 기본 사이트로 표시합니다. 기본 사이트는 하나만 있을 수 있습니다. |
| Name | Geo 사이트의 고유 식별자입니다. 물리적 위치를 이름으로 사용하는 것을 강력히 권장합니다. 좋은 예는 London Office 또는 us-east-1입니다. primary, secondary, Geo 또는 DR과 같은 단어는 피하세요. 이렇게 하면 물리적 위치는 변경되지 않지만 Geo 사이트 역할은 변경될 수 있으므로 장애 조치 프로세스가 더 쉬워집니다. 단일 Geo 사이트의 모든 노드는 동일한 사이트 이름을 사용합니다. 노드는 /etc/gitlab/gitlab.rb의 gitlab_rails['geo_node_name'] 설정을 사용하여 PostgreSQL 데이터베이스에서 해당 Geo 사이트 레코드를 조회합니다. gitlab_rails['geo_node_name']이 설정되지 않은 경우 노드의 external_url에 후행 슬래시를 붙인 값이 폴백으로 사용됩니다. Name 값은 대소문자를 구분하며 대부분의 문자가 허용됩니다. |
| URL | 인스턴스의 사용자 대면 URL. |
허용된 Geo IP#
허용된 Geo IP 설정은 보조 사이트에서 기본 사이트로 요청할 수 있는 IP 주소를 제어합니다. 기본 사이트는 이 설정을 사용하여 다음을 검증합니다:
- 보조 사이트에서의 Git HTTP 요청.
- 보조 사이트에서의 Geo API 요청.
허용된 Geo IP 설정:
- 보조 사이트에 영향을 미치지 않습니다. 설정은 데이터베이스에서 보조 사이트로 복제되지만 거기서는 사용되지 않습니다.
192.168.1.1, 10.0.0.0/8, 2001:db8::/32와 같이 쉼표로 구분된 IP 주소 및 CIDR 블록 목록을 수락합니다.- 모든 IP 주소의 요청을 허용하는 기본값
0.0.0.0/0, ::/0을 가집니다. - 데이터베이스가 읽기 전용이므로 보조 사이트에서는 수정할 수 없습니다.
보조 사이트 설정#
보조 사이트에는 사용 가능한 추가 설정이 많이 있습니다:
| 설정 | 설명 |
|---|---|
| Selective synchronization | 이 보조 사이트에 대해 Geo 선택적 동기화를 활성화합니다. |
| Repository sync capacity | 저장소를 백필할 때 이 보조 사이트가 기본 사이트에 대해 만드는 동시 요청 수. |
| File sync capacity | 파일을 백필할 때 이 보조 사이트가 기본 사이트에 대해 만드는 동시 요청 수. |
Geo 백필#
보조 사이트는 기본 사이트로부터 저장소 및 파일의 변경사항을 알림 받고, 항상 이러한 변경사항을 가능한 한 빨리 동기화하려고 시도합니다.
백필은 보조 사이트가 데이터베이스에 추가되기 전에 존재했던 저장소 및 파일로 보조 사이트를 채우는 행위입니다. 저장소와 파일 수가 매우 많을 수 있으므로 한 번에 모두 다운로드하려는 것은 실행 가능하지 않습니다. 따라서 GitLab은 이러한 작업의 동시성에 상한을 둡니다.
백필에 걸리는 시간은 최대 동시성에 따라 다르지만 값이 높을수록 기본 사이트에 더 많은 부하가 걸립니다. 이 한도는 구성 가능합니다. 기본 사이트의 여유 용량이 많다면 값을 늘려 더 짧은 시간 내에 백필을 완료할 수 있습니다. 과부하 상태이고 백필로 인해 표준 요청에 대한 가용성이 감소한다면 값을 줄일 수 있습니다.
내부 URL 설정#
기본 및 보조 사이트 간의 동기화를 위해 다른 URL을 설정할 수 있습니다.
기본 사이트의 내부 URL은 보조 사이트가 연락하는 데 사용됩니다. 예를 들어 저장소를 동기화하기 위해서입니다. 내부 URL이라는 이름은 사용자가 사용하는 외부 URL과 구별됩니다. 내부 URL은 개인 주소일 필요가 없습니다.
보조 사이트의 내부 URL은 기본 사이트가 연락하는 데 사용됩니다. 예를 들어 Geo > Sites > Project Repositories의 관리 영역에 표시하기 위해 동기화 또는 검증 추적 메타데이터를 검색하기 위해서입니다.
내부 URL은 기본적으로 외부 URL로 설정됩니다. 변경하려면:
- 오른쪽 상단 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Geo > Sites를 선택합니다.
- 사용자 지정하려는 사이트에서 Edit를 선택합니다.
- 내부 URL을 편집합니다.
- Save changes를 선택합니다.
활성화되면 Geo의 Admin 영역에는 기본 사이트 UI에서 직접, 그리고 Geo 보조 프록시가 활성화된 경우 프록시를 통해 각 사이트에 대한 복제 세부 정보가 표시됩니다.
Geo 사이트를 구성하는 동안 HTTPS 연결을 사용하는 것을 권장합니다. HTTPS를 사용할 때 기본 및 보조 사이트 간의 통신이 중단되지 않도록 하려면 로드 밸런서에서 TLS가 종료된 로드 밸런서를 가리키도록 내부 URL을 사용자 지정하세요.