Geo 마이그레이션 요구 사항
GitLab v19.6Offering: GitLab Dedicated
요약
GitLab Self-Managed 인스턴스에서 GitLab Dedicated로 Geo 복제를 시작하려면 먼저 다음 요구 사항을 충족해야 합니다. 아래의 각 요구 사항은 무엇이 충족되어야 하는지와 충족하는 방법을 설명합니다.
GitLab Self-Managed 인스턴스에서 GitLab Dedicated로 Geo 복제를 시작하려면 먼저 다음 요구 사항을 충족해야 합니다. GitLab 마이그레이션 팀이 탐색 단계에서 각 요구 사항을 함께 확인합니다.
아래의 각 요구 사항은 무엇이 충족되어야 하는지와 충족하는 방법을 설명합니다. 요구 사항을 완료하는 순서와 마이그레이션에서 차지하는 위치는 준비를 참고합니다. 일부 요구 사항은 완료하는 데 몇 주가 걸리므로 가능한 한 일찍 시작합니다.
인스턴스 결정 사항#
표준 인스턴스 결정 사항은 GitLab Dedicated 인스턴스를 만들 때 정하며, 해당 문서에 각 필드와 허용되는 값이 나와 있습니다. 이 결정 중 두 가지는 Geo 마이그레이션에서 특히 중요합니다.
- AWS 리전. 원본 인스턴스가 이미 AWS에서 실행 중이면 기본 리전을 원본과 같은 AWS 리전에 두어 마이그레이션 연결을 단순하게 합니다.
- 지속적인 접근 방식. 연결에 AWS PrivateLink를 사용하는 경우 기존 AWS 인프라와 일치하는 가용 영역 ID 두 개를 선택합니다. IPsec 사이트 간 VPN은 마이그레이션 기간에는 사용할 수 있지만 지속적인 접근에는 지원되지 않습니다. 자세한 내용은 네트워크 보안을 참고합니다.
GitLab이 인스턴스를 프로비저닝한 뒤에는 AWS 리전, 가용 영역 ID, 고객 관리형 암호화 키 구성을 변경할 수 없습니다. 프로비저닝을 시작하기 전에 이러한 결정을 확정합니다.
도메인 전략#
사용자 지정 도메인을 사용할지 GitLab 제공 도메인을 사용할지 결정합니다.
- 사용자 지정 도메인을 사용하면 마이그레이션 후에도 사용자가 같은 호스트 이름을 계속 사용합니다. 이슈와 머지 리퀘스트 설명, 코멘트, 러너 구성, 스크립트, 사용자가 설정해 둔 Git 리모트를 포함해 해당 호스트 이름을 가리키는 기존 참조가 계속 확인됩니다. KAS와 GitLab Pages처럼 자체 호스트 이름이 있는 엔드포인트는 여전히 변경됩니다.
- GitLab 제공 도메인을 사용하면 호스트 이름이 바뀌며, 이전 호스트 이름을 가리키는 참조는 전환 후 확인되지 않습니다. 이를 업데이트할 계획을 세웁니다.
- 사용자 지정 도메인을 사용하려면 인증서를 발급할 수 있도록 도메인이 공개적으로 확인될 수 있어야 합니다. IP 허용 목록으로 접근을 제한할 수는 있습니다. 공개 DNS 레코드 자체가 접근 권한을 부여하지는 않습니다.
- GitLab 인스턴스에 사용자 지정 도메인을 사용한다면 호스트 이름의 일관성을 위해 컨테이너 레지스트리와 Kubernetes용 GitLab 에이전트 서버(KAS)에도 사용합니다.
- GitLab Pages는 사용자 지정 도메인을 지원하지 않습니다. Pages 콘텐츠는 GitLab Dedicated Pages 도메인에서 제공됩니다.
자세한 내용은 사용자 지정 도메인과 전달 키트 사용자 지정 도메인의 DNS 요구 사항을 참고합니다.
원본 인스턴스 요구 사항#
GitLab Dedicated로 복제를 시작하기 전에 인스턴스를 Geo 기본 사이트로 구성합니다. 검증은 기존 데이터의 체크섬을 생성하여 데이터 문제를 초기에 드러내므로 가능한 한 빨리 시작합니다.
자세한 내용은 Geo와 전달 키트 고객 기본 인스턴스에서 Geo 활성화를 참고합니다.
데이터베이스 읽기 복제본#
GitLab Dedicated는 원본 데이터베이스의 PostgreSQL 읽기 복제본에 접근할 수 있어야 합니다. Geo가 GitLab Dedicated 프리프로덕션 테넌트와 프로덕션 테넌트에 병렬로 동기화하므로, 프로덕션 경로용 하나와 프리프로덕션 경로용 하나, 총 두 개의 복제본을 제공합니다.
각 복제본은 마이그레이션 연결을 통해 GitLab Dedicated에서 접근할 수 있어야 하며, 정상적인 원본에서 스트리밍해야 합니다.
복제본을 제공하는 방법은 원본 데이터베이스가 실행되는 위치에 따라 다릅니다. 원본이 AWS에 있다면 공개 마이그레이션 PrivateLink Terraform 모듈이 읽기 복제본 두 개를 모두 만들고 PrivateLink를 통한 접근을 제공하므로 가장 간단한 방법입니다.
자세한 내용은 전달 키트 RDS 읽기 복제본과 GitLab으로의 아웃바운드 PrivateLink를 참고합니다.
원본이 이미 AWS RDS에 있는 경우#
RDS 읽기 복제본 두 개를 직접 만듭니다.
원본이 RDS 없이 AWS에서 실행되는 경우#
마이그레이션 전에 원본 데이터베이스를 백업해 AWS RDS for PostgreSQL로 복원한 다음 그곳에서 읽기 복제본 두 개를 만들기를 권장합니다. RDS 네이티브 읽기 복제본이 만들고 관리하기가 더 간단합니다.
RDS로 옮기려면 덤프와 복원이 실행되는 동안 다운타임이 있는 계획된 유지 관리 기간이 필요합니다. 데이터베이스 규모에 맞게 이 기간을 산정합니다.
원본이 다른 클라우드에 있거나 AWS에 없는 경우#
AWS RDS는 필요하지 않습니다. Google Cloud SQL이나 Azure Database for PostgreSQL처럼, 접근 가능한 읽기 복제본 두 개를 사용자 환경에 제공합니다.
오브젝트 스토리지#
Geo 복제를 시작하기 전에 사용 중인 모든 데이터 유형이 오브젝트 스토리지에 있어야 합니다. GitLab Dedicated는 오브젝트 스토리지를 사용하고 Geo 보조 사이트는 기본 사이트와 같은 스토리지 방식을 사용해야 하므로, 로컬 스토리지에 남아 있는 파일은 마이그레이션할 수 없습니다. 자세한 내용은 Geo의 오브젝트 스토리지를 참고합니다.
대부분의 데이터 유형은 오브젝트 스토리지로 마이그레이션할 때 다운타임이 필요하지 않습니다.
각 데이터 유형의 마이그레이션 절차는 오브젝트 스토리지로 마이그레이션을 참고합니다. 마이그레이션 순서는 전달 키트 오브젝트 스토리지 마이그레이션을 참고합니다.
오브젝트 스토리지 비공개 접근#
오브젝트 스토리지가 프록시 다운로드를 사용한다면 공개 오브젝트 스토리지 비공개 접근 도구로 비공개 Amazon S3 인터페이스 엔드포인트를 구성할 수 있습니다.
리포지터리 스토리지#
GitLab Dedicated는 default, storage2, storage3의 세 가지 Gitaly 스토리지 이름을 지원합니다.
인스턴스가 다른 스토리지 이름을 사용한다면 전환 전에 리포지터리를 지원되는 이름으로 옮깁니다.
자세한 내용은 리포지터리 스토리지와 전달 키트 Gitaly 리포지터리 스토리지 변경을 참고합니다.
마이그레이션 연결#
마이그레이션 중에 GitLab Dedicated는 원본 GitLab 인스턴스와 데이터베이스 읽기 복제본 두 개에 접근할 수 있어야 합니다.
원본이 AWS에 있다면 공용 인터넷 대신 AWS PrivateLink로 연결하고, GitLab Dedicated 기본 리전을 원본과 같은 AWS 리전에 둡니다. PrivateLink 경로는 사용자의 AWS 계정에 직접 구성합니다. 이 경로는 프로덕션 경로와 프리프로덕션 경로 각각에 대한 Network Load Balancer와 VPC 엔드포인트 서비스로 구성됩니다. 공개 인바운드 PrivateLink Terraform 모듈이 인바운드 PrivateLink를 만들고, 마이그레이션 PrivateLink Terraform 모듈이 마이그레이션 연결을 준비합니다.
원본이 AWS에 없다면 다음을 사용할 수 있습니다.
- 소유한 AWS 계정에 브리지로 연결한 뒤 그곳에서 AWS PrivateLink를 사용합니다.
- 마이그레이션 기간에 IPsec 사이트 간 VPN을 사용합니다.
- 원본 인스턴스와 읽기 복제본에 인터넷 접근을 제공합니다.
마이그레이션 팀과 설계를 확인합니다.
자세한 내용은 전달 키트 Geo 동기화 연결을 참고합니다.
IPsec site-to-site VPN#
PrivateLink를 사용할 수 없는 경우 GitLab이 마이그레이션 기간 동안 사용자의 네트워크와 GitLab Dedicated 테넌트 사이에 AWS 사이트 간 VPN을 설정할 수 있습니다. VPN은 마이그레이션이 완료된 뒤의 지속적인 접근에는 지원되지 않습니다.
VPN은 정적 라우팅을 사용합니다. BGP 동적 라우팅은 지원되지 않으므로, 접근이 필요한 서브넷을 미리 파악해 VPN 엔드포인트의 공인 IP 주소와 함께 제공해야 합니다. GitLab은 이중화를 위한 IPsec 터널 두 개를 포함해 연결의 AWS 쪽을 만든 다음, 사용자의 VPN 장치에 적용할 구성을 보냅니다.
준비하려면 다음을 수집합니다.
- VPN 엔드포인트의 공인 IP 주소
- GitLab Dedicated에 접근해야 하는 서브넷
- GitLab이 구성을 생성할 수 있도록 VPN 장치의 제조사와 모델
GitLab은 GitLab Dedicated 쪽에서 네트워크 주소 변환(NAT)을 적용하지 않습니다. GitLab은 GitLab Dedicated가 연결하는 IP 범위를 공유하며, 주소 체계상 필요하다면 사용자의 네트워크에서 이를 변환할 수 있습니다. 마이그레이션은 GitLab Dedicated에서 사용자의 인스턴스와 읽기 복제본으로 향하는 한 방향의 연결만 필요하므로, 들어오는 원본 주소만 변환하면 됩니다.
설정 절차는 전달 키트 IPsec VPN 접근을 참고합니다.
통합을 위한 아웃바운드 연결#
아웃바운드 대상을 다음과 같이 준비합니다.
- 웹훅과 통합이 IP 주소가 아니라 호스트 이름을 대상으로 하도록 구성합니다.
- 모든 프라이빗 주소에 연결이 필요하다고 가정하기 전에 아웃바운드 대상 목록을 검토합니다. 루프백 주소, 자기 참조, 클러스터 내부 주소는 실제 외부 엔드포인트가 아닌 경우가 많습니다.
GitLab Dedicated는 아웃바운드 PrivateLink 엔드포인트를 최대 10개까지 지원합니다. 더 많은 프라이빗 대상에 접근해야 한다면 공개 아웃바운드 프록시 Terraform 모듈로 여러 백엔드를 하나의 연결 뒤로 통합합니다. 이 모듈은 Network Load Balancer 뒤에 고가용성 NGINX 프록시를 배포하며 HTTPS, HTTP, SMTP 백엔드를 통합할 수 있습니다.
아웃바운드 대상을 목록으로 정리하려면 공개 GitLab 탐색 툴킷을 사용합니다.
테스트 기간에 모든 아웃바운드 대상을 테스트합니다. 아웃바운드 연결 문제는 가장 흔한 발견 사항에 속하며, 테스트 기간이 그 문제를 드러낼 시점입니다.
자세한 내용은 아웃바운드 PrivateLink 연결과 전달 키트 웹훅과 통합을 참고합니다.
SaaS 통합을 위한 인바운드 접근#
IP 허용 목록을 사용한다면 티켓 시스템, 채팅 통합, GitLab API를 호출하는 CI/CD 서비스처럼 GitLab Dedicated 인스턴스에 접근해야 하는 모든 외부 SaaS 서비스에 대해 허용 목록 예외를 추가합니다.
전환 전에 이러한 서비스를 목록으로 정리합니다. 허용 목록에 없는 서비스의 요청은 차단됩니다.
자세한 내용은 IP 허용 목록을 참고합니다.
해결해야 할 기능#
인스턴스를 사용할 수 없는 기능 목록과 대조해 확인하고, 사용 중인 기능이 있다면 전환 전에 대체 수단을 마련합니다. 목록을 처리하는 방법은 전달 키트 남은 미지원 기능을 참고합니다.
두 항목은 나머지보다 계획에 더 많은 시간이 필요하며, GitLab이 각각에 대한 도구나 절차를 제공합니다.
- LDAP에서 SAML 또는 OpenID Connect(OIDC) ID 공급자로 이전하는 작업은 준비 항목 중 가장 오래 걸리는 단일 항목인 경우가 많습니다. 자세한 내용은 LDAP에서 SAML로 전환을 참고합니다.
- GitLab Dedicated가 지원하지 않는 GitLab Pages 사용자 지정 도메인. Pages 콘텐츠는 GitLab Dedicated Pages 도메인에서 제공됩니다. 임시 전환에는 공개 Pages 리디렉션 Terraform 모듈을 사용할 수 있으며, 이 모듈은 기존 인증서와 DNS 이름을 유지하고 새 URL로 리디렉션을 반환합니다. 이 모듈은 영구적인 해결책이 아니라 임시 보조 수단입니다.
기본 /-/kubernetes-agent 경로가 GitLab Dedicated에 없으므로
Kubernetes용 GitLab 에이전트를 새 KAS URL로 다시 등록해야 합니다.
LDAP에서 SAML로 전환#
LDAP에서 이전하는 작업은 준비 항목 중 가장 오래 걸리는 단일 항목인 경우가 많으므로 일찍 시작합니다.
GitLab Dedicated에서 ID 공급자를 구성하려면 SAML 또는 OpenID Connect를 참고합니다.
LDAP 그룹 동기화를 사용한다면 SAML 그룹 동기화로 전환하여 그룹 멤버십을 유지할 수 있습니다. 전환 절차와 GitLab Professional Services가 사용하는 스크립트는 전달 키트 SSO 구성을 참고합니다.