Geo 용어집
GitLab v19.4Offering: GitLab Self-Managed
요약
GitLab은 이러한 변경 사항을 반영하기 위해 Geo 문서, 사용자 인터페이스, 명령을 업데이트하고 있습니다. 다음은 Geo의 모든 측면을 설명하기 위해 정의한 용어입니다. 용어의 올바른 사용법을 보여주는 예시 다이어그램과 문장을 제공합니다.
GitLab은 이러한 변경 사항을 반영하기 위해 Geo 문서, 사용자 인터페이스, 명령을 업데이트하고 있습니다. 아직 모든 페이지가 이 정의를 따르지는 않습니다.
다음은 Geo의 모든 측면을 설명하기 위해 정의한 용어입니다. 명확하게 정의된 용어를 사용하면 효율적으로 소통할 수 있고 혼선을 줄일 수 있습니다. 이 페이지의 표현은 어디에서나 통용되고 최대한 단순하도록 작성했습니다.
주요 용어#
용어의 올바른 사용법을 보여주는 예시 다이어그램과 문장을 제공합니다.
| 용어 | 정의 | 범위 | 권장하지 않는 동의어 |
|---|---|---|---|
| Node | 특정 역할로 또는 전체적으로 GitLab을 실행하는 개별 서버(예: Rails 애플리케이션 노드). 클라우드 환경에서는 특정 머신 유형일 수 있습니다. | GitLab | instance, server |
| Site | 단일 GitLab 애플리케이션을 실행하는 하나 또는 여러 노드의 모음. 사이트는 단일 노드 또는 다중 노드로 구성할 수 있습니다. | GitLab | deployment, installation instance |
| Single-node site | 정확히 하나의 노드를 사용하는 GitLab의 특정 구성. | GitLab | single-server, single-instance |
| Multi-node site | 둘 이상의 노드를 사용하는 GitLab의 특정 구성. | GitLab | multi-server, multi-instance, high availability |
| Primary site | 데이터가 하나 이상의 보조 사이트로 복제되는 GitLab 사이트. 기본 사이트는 하나만 존재할 수 있습니다. | Geo-specific | Geo deployment, Primary node |
| Secondary site | 기본 사이트의 데이터를 복제하도록 구성된 GitLab 사이트. 보조 사이트는 하나 이상 존재할 수 있습니다. | Geo-specific | Geo deployment, Secondary node |
| Geo deployment | 정확히 하나의 기본 사이트가 하나 이상의 보조 사이트로 복제되는, 두 개 이상의 GitLab 사이트 모음. | Geo-specific | |
| Reference architecture | 여러 노드와 여러 사이트를 포함할 수 있는 초당 요청 수 또는 사용자 수를 기준으로 지정된 GitLab 구성. | GitLab | |
| Promoting | 사이트의 역할을 보조에서 기본으로 변경하는 것. | Geo-specific | |
| Demoting | 사이트의 역할을 기본에서 보조로 변경하는 것. | Geo-specific | |
| Failover | 사용자를 기본 사이트에서 보조 사이트로 이동시키는 전체 절차. 보조 사이트 승격을 포함하며, 유지 관리 일정 수립 등 다른 단계도 포함합니다. | Geo-specific | |
| Replication | "동기화"라고도 합니다. 보조 사이트의 리소스를 기본 사이트의 리소스와 일치하도록 업데이트하는 단방향 절차. | Geo-specific | |
| Replication slot | 데이터베이스와의 지속적인 연결 지점을 보장하고 대기 서버에 아직 필요한 WAL 세그먼트를 추적하는 PostgreSQL 복제 기능. 복제 슬롯 이름을 사이트의 geo_node_name과 일치시키면 도움이 되지만 필수는 아닙니다. |
PostgreSQL | |
| Verification | 기본 사이트에 있는 데이터를 보조 사이트에 복제된 데이터와 비교하는 절차. 복제된 데이터의 무결성을 보장하는 데 사용합니다. | Geo-specific | |
| Unified URL | 모든 Geo 사이트에 사용하는 단일 외부 URL. 요청을 기본 Geo 사이트 또는 보조 Geo 사이트 어느 쪽으로든 라우팅할 수 있습니다. | Geo-specific | |
| Geo proxying | 보조 사이트에서 로컬로 처리할 수 있는 일부 작업을 제외하고, 보조 Geo 사이트가 작업을 기본 사이트로 투명하게 전달하는 메커니즘. | Geo-specific | |
| Blob | 다양한 GitLab 구성 요소를 포괄하도록 복제할 수 있는 Geo 관련 데이터 유형. | Geo-specific | file |
복제기 용어#
Geo는 복제기를 사용하여 개별 GitLab 구성 요소의 데이터를 기본 사이트와 보조 사이트 사이에서 복제합니다. 복제기는 해당 구성 요소의 개별 데이터 유형을 어떻게 처리하고 검증할지 정의합니다. 예를 들어 GitLab 컨테이너 레지스트리의 데이터는 CI job 아티팩트와 다른 방식으로 처리해야 합니다. 구성 요소에 따라 복제기가 둘 이상일 수 있고 이름도 서로 다를 수 있습니다. 따라서 다음 표에 복제기 이름과 해당 복제기가 속한 GitLab 구성 요소를 정리했습니다.
동일한 복제기 이름은 Admin 영역의 Geo 섹션이나 Geo 관련 콘솔 명령에서도 확인할 수 있습니다.
| Geo 복제기 이름 | GitLab 구성 요소 이름 |
|---|---|
| CI Secure Files | CI Secure Files |
| Container Repositories | Container registry |
| Dependency Proxy Blobs | Dependency Proxy Images |
| Dependency Proxy Manifests | Dependency Proxy Images |
| Design Management Repositories | Project designs repository |
| Group Wiki Repositories | Group wiki repository |
| CI Job Artifacts | CI job artifacts |
| LFS Objects | LFS objects |
| Merge Request Diffs | External merge request diffs |
| Package Files | Package registry |
| Pages Deployments | Pages |
| Pipeline Artifacts | Pipeline artifacts |
| Project Repositories | Project repository |
| Project Wiki Repositories | Project wiki repository |
| Snippet Repositories | Personal Snippets and Project Snippets |
| Terraform State Versions | Versioned Terraform State |
| Uploads | User uploads |
예시#
단일 노드 사이트#
GitLab을 실행하는 노드 하나로 구성된 사이트입니다.
- GitLab 노드
다중 노드 사이트#
서로 다른 GitLab 구성 요소를 실행하는 여러 노드로 구성된 사이트입니다.
- 애플리케이션 노드
- 데이터베이스 노드
- Gitaly 노드
Geo 배포 - 단일 노드 사이트#
이 Geo 배포는 단일 노드 기본 사이트와 단일 노드 보조 사이트로 구성됩니다.
기본 사이트(단일 노드):
- GitLab 노드
보조 사이트 1(단일 노드):
- GitLab 노드
Geo 배포 - 다중 노드 사이트#
이 Geo 배포는 다중 노드 기본 사이트와 다중 노드 보조 사이트로 구성됩니다.
기본 사이트(다중 노드):
- 애플리케이션 노드
- 데이터베이스 노드
보조 사이트 1(다중 노드):
- 애플리케이션 노드
- 데이터베이스 노드
Geo 배포 - 혼합 사이트#
이 Geo 배포는 다중 노드 기본 사이트, 다중 노드 보조 사이트, 단일 노드 보조 사이트로 구성됩니다.
기본 사이트(다중 노드):
- 애플리케이션 노드
- 데이터베이스 노드
- Gitaly 노드
보조 사이트 1(다중 노드):
- 애플리케이션 노드
- 데이터베이스 노드
보조 사이트 2(단일 노드):
- 단일 GitLab 노드