Geo 사이트 관리 영역
GitLab v19.5Offering: GitLab Self-Managed
요약
GitLab Geo 사이트의 여러 설정을 구성할 수 있습니다. 기본 사이트 또는 보조 사이트에서 다음을 수행합니다. 모든 Geo 사이트에는 다음 설정이 있습니다. Allowed 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#
Allowed Geo IP 설정은 보조 사이트가 기본 사이트로 요청을 보낼 수 있는 IP 주소를 제어합니다. 기본 사이트는 이 설정을 사용해 다음을 검증합니다.
- 보조 사이트에서 오는 Git HTTP 요청.
- 보조 사이트에서 오는 Geo API 요청.
Allowed Geo IP 설정의 특징은 다음과 같습니다.
- 보조 사이트에는 영향을 주지 않습니다. 이 설정은 데이터베이스를 통해 보조 사이트로 복제되지만 그곳에서는 사용되지 않습니다.
192.168.1.1, 10.0.0.0/8, 2001:db8::/32와 같이 쉼표로 구분한 IP 주소 및 CIDR 블록 목록을 받습니다.- 기본값은
0.0.0.0/0, ::/0이며, 모든 IP 주소의 요청을 허용합니다. - 보조 사이트의 데이터베이스는 읽기 전용이므로 보조 사이트에서는 수정할 수 없습니다.
보조 사이트 설정#
보조 사이트에서는 다음과 같은 추가 설정을 사용할 수 있습니다.
| 설정 | 설명 |
|---|---|
| Selective synchronization | 이 보조 사이트에 Geo 선택적 동기화를 활성화합니다. |
| Repository sync capacity | 리포지터리를 백필할 때 이 보조 사이트가 기본 사이트로 보내는 동시 요청 수입니다. |
| File sync capacity | 파일을 백필할 때 이 보조 사이트가 기본 사이트로 보내는 동시 요청 수입니다. |
Geo 백필#
보조 사이트는 리포지터리와 파일의 변경 사항을 기본 사이트로부터 통지받으며, 항상 그 변경 사항을 최대한 빠르게 동기화하려고 시도합니다.
백필은 보조 사이트가 데이터베이스에 추가되기 전부터 존재하던 리포지터리와 파일로 보조 사이트를 채우는 작업입니다. 리포지터리와 파일의 수가 매우 많을 수 있으므로 한 번에 전부 내려받으려 시도하는 것은 현실적이지 않습니다. 따라서 GitLab은 이러한 작업의 동시 실행 수에 상한을 둡니다.
백필에 걸리는 시간은 최대 동시 실행 수에 따라 달라지며, 값이 클수록 기본 사이트의 부하가 커집니다. 이 한도는 구성할 수 있습니다. 기본 사이트에 여유 용량이 많다면 값을 높여 백필을 더 짧은 시간에 완료할 수 있습니다. 기본 사이트가 과부하 상태이고 백필 때문에 일반 요청에 대한 가용성이 떨어진다면 값을 낮출 수 있습니다.
내부 URL 설정#
기본 사이트와 보조 사이트 간 동기화에 서로 다른 URL을 설정할 수 있습니다.
기본 사이트의 내부 URL은 보조 사이트가 기본 사이트에 연결할 때 사용합니다. 예를 들어 리포지터리를 동기화할 때 사용합니다. 내부 URL이라는 이름은 사용자가 사용하는 외부 URL과 구분하기 위한 것입니다. 내부 URL 이 사설 주소여야 하는 것은 아닙니다.
보조 사이트의 내부 URL은 기본 사이트가 보조 사이트에 연결할 때 사용합니다. 예를 들어 Admin Area의 Geo > Sites > Project Repositories에 표시할 동기화 또는 검증 추적 메타데이터를 가져올 때 사용합니다.
내부 URL은 기본적으로 외부 URL로 설정됩니다. 변경하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Geo > Sites를 선택합니다.
- 사용자 지정하려는 사이트에서 Edit를 선택합니다.
- 내부 URL을 편집합니다.
- Save changes를 선택합니다.
활성화하면 Geo의 Admin 영역에서 각 사이트의 복제 세부 정보를 기본 사이트 UI에서 직접 확인할 수 있으며, Geo 보조 프록시가 활성화된 경우 프록시를 통해서도 확인할 수 있습니다.
Geo 사이트를 구성할 때는 HTTPS 연결을 사용하기를 권장합니다. HTTPS를 사용할 때 기본 사이트와 보조 사이트 간 통신이 끊어지지 않도록 하려면, 내부 URL을 TLS가 로드 밸런서에서 종료되는 로드 밸런서를 가리키도록 사용자 지정합니다.