Geo 마이그레이션 프로세스
GitLab v19.6Offering: GitLab Dedicated
요약
마이그레이션은 GitLab Dedicated 인스턴스가 생성될 때 시작됩니다. 마이그레이션 중에는 프리프로덕션 테넌트와 프로덕션 테넌트, 두 개의 GitLab Dedicated 테넌트가 단일 원본 인스턴스에 연결됩니다.
마이그레이션은 GitLab Dedicated 인스턴스가 생성될 때 시작됩니다. 이후 준비 기간, 복제 기간, 두 번의 전환(프리프로덕션 전환, 그다음 프로덕션 전환)을 거칩니다. 프리프로덕션 전환은 프로세스를 예행연습하며, 프로덕션 전환으로 마이그레이션이 완료되기 전에 통합을 테스트할 수 있는 환경을 제공합니다.
마이그레이션 아키텍처#
마이그레이션 중에는 프리프로덕션 테넌트와 프로덕션 테넌트, 두 개의 GitLab Dedicated 테넌트가 단일 원본 인스턴스에 연결됩니다. 데이터베이스 읽기 복제본 두 개와 AWS 연결은 사용자 쪽에서 제공하며, 두 테넌트는 같은 경로를 사용합니다.
소스 코드 보기
flowchart TB
accTitle: GitLab Dedicated Geo migration connectivity
accDescr: In a customer AWS account, a primary database feeds a production read replica and a pre-production read replica. A network load balancer fronts both replicas, GitLab, and the container registry, and publishes them through a VPC endpoint service. Two GitLab Dedicated accounts, production and pre-production, each connect through a VPC endpoint to reach the database, GitLab, and the container registry.
subgraph customer["Customer AWS account"]
primary[("Primary database")]
prod_replica[("Production replica")]
preprod_replica[("Pre-production replica")]
gitlab["GitLab"] --> nlb
registry["Container registry"] --> nlb
nlb["Network Load Balancer"]
vpce_svc["VPC endpoint service"]
primary --> prod_replica --> nlb
primary --> preprod_replica --> nlb
nlb --> vpce_svc
end
subgraph dedicated_prod["GitLab Dedicated production"]
prod_vpce["VPC endpoint"]
prod_rds["Database"]
prod_gl["GitLab"]
prod_reg["Container registry"]
prod_vpce --- prod_rds
prod_vpce --- prod_gl
prod_vpce --- prod_reg
end
subgraph dedicated_preprod["GitLab Dedicated pre-production"]
preprod_vpce["VPC endpoint"]
preprod_rds["Database"]
preprod_gl["GitLab"]
preprod_reg["Container registry"]
preprod_vpce --- preprod_rds
preprod_vpce --- preprod_gl
preprod_vpce --- preprod_reg
end
vpce_svc --> prod_vpce
vpce_svc --> preprod_vpce
다이어그램에는 GitLab Dedicated 테넌트 두 개가 나타나지만, 사용자는 단일 프로덕션 인스턴스만 제공합니다. 두 테넌트는 GitLab이 프로비저닝하고 유지 관리합니다. 자세한 내용은 마이그레이션 단계를 참고합니다.
다이어그램은 원본이 AWS에서 실행되는 경우에 해당하는 AWS RDS 읽기 복제본을 보여 줍니다. 원본이 다른 클라우드나 온프레미스에서 실행된다면 읽기 복제본을 사용자 환경에 만들고 인터넷 또는 IPsec 사이트 간 VPN으로 연결을 제공합니다.
탐색, 계획, 인스턴스 생성#
GitLab Dedicated 구매를 확정하기 전에 솔루션 아키텍트 또는 어카운트 이그제큐티브가 GitLab Discovery Toolkit, GitLab Evaluate, GitLabSOS 같은 로그 번들로 현재 환경에 관한 정보를 수집하도록 돕습니다. GitLab은 이 결과를 바탕으로 마이그레이션 가능성, 규모 산정, 일정을 평가하고 충족해야 할 요구 사항을 파악합니다.
구매가 완료된 뒤에는 GitLab Dedicated 인스턴스를 직접 만들거나, 원하면 GitLab Professional Services가 함께 만들어 줍니다. AWS 리전과 접근 방식처럼 인스턴스를 만들 때 내리는 결정은 마이그레이션에 영향을 주므로 먼저 마이그레이션 팀과 확정합니다. 자세한 내용은 GitLab Dedicated 인스턴스 만들기와 Geo 마이그레이션 요구 사항을 참고합니다.
준비#
준비는 복제가 의존하는 모든 것을 구축하는 단계입니다. 이 작업은 직접 하거나 GitLab Professional Services와 함께 할 수 있습니다. 자세한 내용은 Geo 마이그레이션 요구 사항을 참고합니다.
다음 항목을 완료하기 전에는 복제를 시작할 수 없습니다.
- 검증이 기존 데이터의 체크섬 생성을 시작할 수 있도록 GitLab Self-Managed 인스턴스를 Geo 기본 사이트로 구성합니다.
- 사용 중인 모든 데이터 유형을 오브젝트 스토리지로 옮깁니다.
- Gitaly 스토리지 이름을 GitLab Dedicated가 지원하는 이름과 맞춥니다.
- 데이터베이스 읽기 복제본 두 개를 만들고, GitLab Dedicated에서 이 복제본과 GitLab 인스턴스로 연결되도록 합니다. 원본이 AWS에 있다면 Terraform 모듈 하나로 둘 다 처리됩니다.
다음 항목은 병렬로 진행할 수 있으며, 복제 전이 아니라 프리프로덕션 전환 전에 완료하면 됩니다.
- 프라이빗 대상에 접근하는 통합을 위한 아웃바운드 연결. 엔드포인트가 10개를 넘어야 하면 아웃바운드 프록시를 포함합니다.
- GitLab Dedicated가 지원하지 않는 기능의 대체 수단. 해당하는 경우 LDAP에서의 이전을 일찍 시작합니다.
이 단계는 보통 가장 오래 걸리며, 소요 기간은 데이터 규모보다 사용자 환경에 훨씬 더 크게 좌우됩니다.
Geo 복제#
연결이 갖춰지고 인스턴스가 Geo 기본 사이트로 구성된 뒤에 GitLab Dedicated 보조 사이트로의 복제가 시작됩니다.
원본 인스턴스는 전 과정에서 계속 사용자를 서비스합니다. 복제 중에는 다운타임이 발생하지 않습니다. GitLab Self-Managed 인스턴스의 Admin 영역에 있는 Geo 사이트 섹션에서 진행 상황을 모니터링합니다. 자세한 내용은 Geo를 참고합니다.
복제는 보수적인 동시성 제한으로 시작됩니다. Admin 영역의 보조 사이트 항목에서 조정 설정을 사용해, 기본 사이트의 부하를 지켜보며 안정성을 확인한 뒤 제한을 늘립니다. 자세한 내용은 동기화 및 검증 동시성 값 변경을 참고합니다.
소요 기간은 주로 오브젝트 스토리지의 데이터 양에 따라 정해집니다. 초기 계획에는 주당 오브젝트 스토리지 데이터 약 10TB라는 대략적인 속도를 가정한 다음, 복제가 실행되면 관찰된 속도를 사용합니다. 네트워크 대역폭, 오브젝트 수, 구성된 속도 제한도 소요 기간에 영향을 주므로 마이그레이션 팀이 사용자의 데이터에 맞는 추정치를 확인합니다.
일시적인 동기화 오류는 대부분 복제가 계속되면서 해결됩니다.
Admin 영역의 Geo 사이트 섹션에서 모든 데이터 유형이 99.9% 이상 동기화 및 검증된 것으로 보고되면 프리프로덕션 전환을 위한 복제가 준비된 것입니다. 남은 항목은 완전한 동기화를 목표로 하는 프로덕션 전환 전에 사용자와 GitLab Professional Services가 함께 조사하고 해결합니다. 자세한 내용은 동기화 및 검증 문제 해결을 참고합니다.
버전 정렬#
복제가 시작될 무렵에는 원본 인스턴스와 두 GitLab Dedicated 테넌트가 같은 GitLab 버전을 실행합니다.
복제 중에는 마이그레이션 팀이 사용자와 업그레이드를 조율하여, 원본 인스턴스와 GitLab Dedicated 테넌트가 함께 이동하며 정렬된 상태를 유지하게 합니다. 이 기간에는 보통 한 번의 조율된 업그레이드가 이루어집니다.
프리프로덕션 전환부터 프로덕션 전환까지는 테스트 중에 아무것도 바뀌지 않도록 양쪽의 업그레이드가 동결됩니다.
프로덕션 전환 후에는 남은 업그레이드로 인스턴스를 나머지 GitLab Dedicated 플릿이 실행하는 버전으로 맞춥니다. 자세한 내용은 버전 따라잡기를 참고합니다. GitLab Dedicated는 현재 GitLab 릴리스를 기준으로 이전 마이너 버전을 실행합니다. 자세한 내용은 버전 관리 모델을 참고합니다. 예정된 업그레이드 날짜는 GitLab Dedicated 정보 포털을 참고합니다.
프리프로덕션 전환#
프리프로덕션 전환은 GitLab Dedicated 프리프로덕션 테넌트를 대상으로 실행하는 프로덕션 전환의 전체 예행연습입니다.
이 예행연습에는 두 가지 목적이 있습니다. 프로세스를 처음부터 끝까지 검증하고 실제 전환에 걸리는 시간을 측정하여 프로덕션 전환에 예상치 못한 일이 없도록 합니다. 또한 프로덕션 전환 전에 통합을 테스트할 수 있는 작동하는 인스턴스를 제공합니다.
예행연습은 프리프로덕션 테넌트를 대상으로 프로덕션 전환과 같은 순서를 따르므로 원본 인스턴스는 계속 사용자를 서비스하고 프로덕션 DNS는 변경되지 않습니다. 프리프로덕션 테넌트에 접속할 때 사용할 호스트 이름과 필요한 ID 공급자 구성은 마이그레이션 팀이 사용자와 함께 확인합니다.
프리프로덕션 전환은 프로덕션 전환이 목표로 하는 100%가 아니라 99.9%의 데이터 완전성을 목표로 합니다. 따라서 예행연습에서는 경미한 동기화 실패를 제쳐 둘 수 있으며, 이는 프로덕션 전환 전에 해결합니다.
업그레이드 동결은 이 시점에 시작되어 프로덕션 전환까지 이어집니다.
테스트 기간#
프리프로덕션 전환 후에는 마이그레이션된 인스턴스를 검증합니다. 이 기간은 보통 몇 주 동안 이어집니다.
다음 항목을 검증합니다.
- ID 공급자를 통한 로그인
- 프로젝트 탐색 및 생성
- HTTPS와 SSH 모두에서의 클론 및 푸시
- CI/CD 파이프라인 실행
docker login, 풀, 푸시를 통한 컨테이너 레지스트리 접근- 내부 대상으로의 웹훅 전달
- 이메일 전달
- 프라이빗 대상에 접근하는 모든 통합
- 서로 다른 사내 또는 VPN 위치에서의 연결
전환일 전에 마이그레이션 팀과 프로덕션 전환의 진행 또는 중단(go/no-go) 기준에 합의합니다.
동결 기간 동안에는 인스턴스가 업그레이드를 받지 못하므로 동결 기간을 현실적으로 가능한 한 짧게 유지합니다.
프로덕션 전환#
프로덕션 전환은 사용자와 일정을 조율해 진행하며, 이 시간 동안 데이터를 쓸 수 없으므로 다운타임 기간이 필요합니다.
전환은 다음 순서로 진행됩니다.
- 원본 인스턴스를 유지 관리 모드로 전환하여 새 데이터가 기록되지 않도록 합니다.
- 복제가 남은 항목을 마무리합니다.
- GitLab이 원본 데이터베이스를 GitLab Dedicated 데이터베이스로 복사합니다. 소요 시간은 데이터베이스 규모에 따라 달라지며 프리프로덕션 예행연습에서 측정됩니다.
- GitLab이 테넌트를 재구성하고 기본 사이트로 승격합니다.
- 사용자 지정 도메인을 사용한다면 DNS 레코드가 GitLab Dedicated를 가리키도록 업데이트합니다.
- GitLab이 사이트를 재구성하여 사용자 지정 도메인의 인증서 발급이 완료되도록 합니다.
- 사이트에 접속해 ID 공급자를 통해 로그인합니다. 인스턴스는 여전히 유지 관리 모드이므로, 데이터가 기록되기 전에 접근을 확인하고 프로젝트와 리포지터리를 읽을 수 있습니다.
- 유지 관리 모드를 비활성화합니다.
- 리포지터리에 푸시, 파이프라인 실행, 컨테이너 레지스트리에 푸시와 같은 쓰기 검사를 수행합니다.
유지 관리 모드가 해제되면 인스턴스에 쓰기가 활성화됩니다. 원본 인스턴스로 되돌아가면 그 시점 이후에 기록된 데이터가 손실됩니다. 이러한 이유로 진행 또는 중단(go/no-go) 결정은 전환 전에 이루어집니다.
마이그레이션 후 관리#
마이그레이션 후에도 애플리케이션 관리는 사용자가 유지합니다.
- GitLab UI를 통한 관리자 접근
- 사용자 및 그룹 관리
- 프로젝트 및 리포지터리 관리
- CI/CD 구성
인프라 관리는 GitLab이 맡습니다.
- 기반 인프라 관리. 서버에 대한 셸 접근 권한은 없습니다.
- 업그레이드. 인스턴스는 지정된 유지 관리 기간에 업그레이드되며 업그레이드 날짜를 선택할 수 없습니다. 자세한 내용은 유지 관리와 릴리스를 참고합니다.
- 일부 설정은 Admin 영역이 아니라 Switchboard에서 관리됩니다. 자세한 내용은 테넌트 개요를 참고합니다.