InfoGrab DocsInfoGrab Docs

마이그레이션 후 작업

요약

GitLab Dedicated 인스턴스를 기본 사이트로 승격하면, 사용자와 협의한 일정에 따라 여러 기능이 예약된 작업으로 차례대로 활성화됩니다. 라이선스 추가는 사용자가 직접 수행하며, 이를 제외한 각 작업은 GitLab이 수행합니다.

GitLab Dedicated 인스턴스를 기본 사이트로 승격하면, 사용자와 협의한 일정에 따라 여러 기능이 예약된 작업으로 차례대로 활성화됩니다. 이 작업은 승격 전이 아니라 승격 후에 진행합니다. 인스턴스가 Geo 보조 사이트인 동안에는 실행할 수 없거나, 마이그레이션이 성공했음을 확인할 때까지 의도적으로 보류하기 때문입니다.

라이선스 추가는 사용자가 직접 수행하며, 이를 제외한 각 작업은 GitLab이 수행합니다. 각 작업은 전환 후 검증을 통과하고, 인스턴스가 전환에서 비롯된 미해결 문제 없이 사용자에게 서비스를 제공한 뒤에만 시작됩니다. Professional Services 마이그레이션 팀이 사용자와 일정을 조율합니다.

버전 따라잡기#

프리프로덕션 전환부터 프로덕션 전환까지는 업그레이드가 중지됩니다. 이 중지는 두 환경을 동일한 버전으로 유지하여, 테스트한 환경이 그대로 운영 환경이 되도록 합니다.

업그레이드가 중지되었기 때문에, 인스턴스를 승격하면 나머지 GitLab Dedicated 플릿보다 한 버전 뒤처진 버전으로 실행됩니다. GitLab Dedicated는 현재 GitLab 릴리스보다 이전 마이너 버전(N-1)을 실행합니다. 자세한 내용은 버전 관리 모델을 참조합니다.

따라잡기는 의도적으로 순차적으로 진행하는 작업입니다. 인스턴스는 한 번에 건너뛰는 것이 아니라 여러 유지 관리 기간에 걸쳐 중간 버전을 거쳐 업그레이드됩니다. 이러한 업그레이드는 각각 무중단 업그레이드이므로, 따라잡는 동안 사용자에게 반복적으로 중단이 발생하는 것은 아닙니다.

업그레이드 경로에는 필수 중간 버전이 포함될 수 있습니다. 경로에 포함된 버전을 확인하려면 업그레이드 경로 도구를 사용합니다.

GitLab은 따라잡기가 끝난 후 주간 유지 관리 기간을 다시 활성화합니다. 이후부터 인스턴스는 다른 GitLab Dedicated 인스턴스와 마찬가지로 표준 월간 릴리스 주기를 따릅니다. 자세한 내용은 유지 관리 기간과 릴리스 롤아웃 일정을 참조합니다.

GitLab Dedicated 버전 일정을 추적하려면 GitLab Dedicated 정보 포털을 사용합니다.

Note

따라잡는 기간에는 인스턴스가 다른 GitLab Dedicated 인스턴스보다 이전 버전을 실행할 수 있습니다. 이 차이는 예상된 것이며 일시적입니다.

고급 검색#

GitLab Dedicated는 고급 검색을 완전히 지원하며, GitLab이 검색 인프라를 프로비저닝하고 관리합니다.

Geo는 고급 검색 인덱스를 복제하지 않으므로, 인스턴스가 Geo 보조 사이트인 동안에는 인덱스를 구축할 수 없습니다. 따라서 GitLab은 승격 후 사용자와 협의한 시점에 고급 검색을 활성화하고, 그때 콘텐츠를 인덱싱합니다. 원본 인스턴스의 기존 검색 클러스터는 마이그레이션되지 않습니다. 인덱싱이 진행되는 동안에도 기본 검색을 사용할 수 있습니다.

자세한 내용은 고급 검색을 참조합니다.

고급 분석#

고급 분석 기능은 ClickHouse Cloud를 기반으로 합니다. 이 기능은 인스턴스를 승격할 때는 활성화되지 않습니다. GitLab은 전환 후 별도의 예약된 단계에서 이 기능을 활성화합니다.

ClickHouse Cloud는 지원되는 리전에서만 사용할 수 있으므로, 사용 가능 여부는 기본 리전에 따라 달라집니다. 자세한 내용은 ClickHouse Cloud 리전을 참조합니다.

통합이 제공하는 기능은 ClickHouse를 참조합니다.

재해 복구용 Geo 보조 사이트#

마이그레이션 중에 GitLab Dedicated 인스턴스는 단일 사이트로 실행됩니다. 인스턴스 자체가 원본 인스턴스의 Geo 보조 사이트 역할을 하므로 보조 리전은 구성되지 않습니다. 따라서 마이그레이션 중에는 표준 GitLab Dedicated Geo 재해 복구 토폴로지가 적용되지 않습니다.

GitLab은 마이그레이션이 완료된 후 보조 사이트를 추가합니다. 보조 사이트를 추가하면 이전 복제 구성으로 돌아갈 수 없으므로, 보조 사이트 추가는 의도적으로 진행하는 단계입니다. 보조 사이트를 추가하면 인스턴스는 다른 모든 GitLab Dedicated 인스턴스와 같은 재해 복구 태세를 갖춥니다.

자세한 내용은 재해 복구를 위한 Geo 복제를 참조합니다.

Note

마이그레이션 중을 포함하여 항상 자동 백업이 적용됩니다. 자세한 내용은 자동 백업을 참조합니다.

러너 및 CI/CD#

러너 등록 레코드는 데이터베이스에 저장되고 데이터베이스가 마이그레이션되므로, 기존 러너는 그대로 유지됩니다.

자체 도메인을 유지하면 인스턴스 호스트 이름이 바뀌지 않으며, 러너는 구성을 변경하지 않고 GitLab Dedicated에 다시 연결됩니다. GitLab에서 제공하는 도메인으로 옮기는 경우에는 러너 구성의 인스턴스 URL을 업데이트합니다.

훨씬 오래된 GitLab 버전의 러너는 재연결이 지연될 수 있습니다. 전환을 원활하게 진행하려면 마이그레이션 기간 전에 자체 관리 러너를 최신 버전으로 올립니다.

자세한 내용은 장애 조치 중 러너 연결을 참조합니다.

GitLab 관리형 러너는 호스티드 러너를 참조합니다.

통합 및 인증#

통합, 웹훅, 아웃바운드 연결은 프리프로덕션 테스트 기간에 검증합니다. 프로덕션 전환 후에는 프로덕션 인스턴스에서 같은 통합을 다시 확인합니다.

다음 항목을 확인합니다.

  • 싱글 사인온(SSO)
  • 내부 대상으로의 웹훅 전달
  • 이메일 전달
  • 러너와 Kubernetes 클러스터에서의 컨테이너 레지스트리 접근
  • 아웃바운드 AWS PrivateLink를 통해 프라이빗 대상에 연결하는 모든 통합
  • 인스턴스를 호출하는 모든 외부 SaaS 서비스. 허용 목록을 사용하는 경우 IP 허용 목록 예외가 필요합니다.

Kubernetes용 GitLab 에이전트를 새 Kubernetes용 GitLab 에이전트 서버(KAS) URL에 다시 등록해야 합니다.

GitLab Dedicated 라이선스 추가#

전환 후에 GitLab Dedicated 라이선스를 추가해야 합니다.

마이그레이션 중에는 GitLab이 라이선스 정보를 나머지 데이터베이스와 함께 복제하므로, 데이터베이스에 GitLab Self-Managed 인스턴스의 라이선스가 들어 있습니다. 이 라이선스는 GitLab Dedicated 구독을 포함하지 않습니다.

라이선스 담당자가 GitLab Dedicated 활성화 코드를 받으며, 이를 승격된 인스턴스에서 활성화해야 합니다. 자세한 내용은 라이선스 키 추가를 참조합니다.

활성화 코드를 받지 못했거나 활성화에 실패하면 GitLab 계정 팀에 문의합니다.

관련 항목#

마이그레이션 후 작업

GitLab v19.6
Tier: Ultimate
Offering: GitLab Dedicated
원문 보기

요약

GitLab Dedicated 인스턴스를 기본 사이트로 승격하면, 사용자와 협의한 일정에 따라 여러 기능이 예약된 작업으로 차례대로 활성화됩니다. 라이선스 추가는 사용자가 직접 수행하며, 이를 제외한 각 작업은 GitLab이 수행합니다.

GitLab Dedicated 인스턴스를 기본 사이트로 승격하면, 사용자와 협의한 일정에 따라 여러 기능이 예약된 작업으로 차례대로 활성화됩니다. 이 작업은 승격 전이 아니라 승격 후에 진행합니다. 인스턴스가 Geo 보조 사이트인 동안에는 실행할 수 없거나, 마이그레이션이 성공했음을 확인할 때까지 의도적으로 보류하기 때문입니다.

라이선스 추가는 사용자가 직접 수행하며, 이를 제외한 각 작업은 GitLab이 수행합니다. 각 작업은 전환 후 검증을 통과하고, 인스턴스가 전환에서 비롯된 미해결 문제 없이 사용자에게 서비스를 제공한 뒤에만 시작됩니다. Professional Services 마이그레이션 팀이 사용자와 일정을 조율합니다.

버전 따라잡기#

프리프로덕션 전환부터 프로덕션 전환까지는 업그레이드가 중지됩니다. 이 중지는 두 환경을 동일한 버전으로 유지하여, 테스트한 환경이 그대로 운영 환경이 되도록 합니다.

업그레이드가 중지되었기 때문에, 인스턴스를 승격하면 나머지 GitLab Dedicated 플릿보다 한 버전 뒤처진 버전으로 실행됩니다. GitLab Dedicated는 현재 GitLab 릴리스보다 이전 마이너 버전(N-1)을 실행합니다. 자세한 내용은 버전 관리 모델을 참조합니다.

따라잡기는 의도적으로 순차적으로 진행하는 작업입니다. 인스턴스는 한 번에 건너뛰는 것이 아니라 여러 유지 관리 기간에 걸쳐 중간 버전을 거쳐 업그레이드됩니다. 이러한 업그레이드는 각각 무중단 업그레이드이므로, 따라잡는 동안 사용자에게 반복적으로 중단이 발생하는 것은 아닙니다.

업그레이드 경로에는 필수 중간 버전이 포함될 수 있습니다. 경로에 포함된 버전을 확인하려면 업그레이드 경로 도구를 사용합니다.

GitLab은 따라잡기가 끝난 후 주간 유지 관리 기간을 다시 활성화합니다. 이후부터 인스턴스는 다른 GitLab Dedicated 인스턴스와 마찬가지로 표준 월간 릴리스 주기를 따릅니다. 자세한 내용은 유지 관리 기간과 릴리스 롤아웃 일정을 참조합니다.

GitLab Dedicated 버전 일정을 추적하려면 GitLab Dedicated 정보 포털을 사용합니다.

Note

따라잡는 기간에는 인스턴스가 다른 GitLab Dedicated 인스턴스보다 이전 버전을 실행할 수 있습니다. 이 차이는 예상된 것이며 일시적입니다.

고급 검색#

GitLab Dedicated는 고급 검색을 완전히 지원하며, GitLab이 검색 인프라를 프로비저닝하고 관리합니다.

Geo는 고급 검색 인덱스를 복제하지 않으므로, 인스턴스가 Geo 보조 사이트인 동안에는 인덱스를 구축할 수 없습니다. 따라서 GitLab은 승격 후 사용자와 협의한 시점에 고급 검색을 활성화하고, 그때 콘텐츠를 인덱싱합니다. 원본 인스턴스의 기존 검색 클러스터는 마이그레이션되지 않습니다. 인덱싱이 진행되는 동안에도 기본 검색을 사용할 수 있습니다.

자세한 내용은 고급 검색을 참조합니다.

고급 분석#

고급 분석 기능은 ClickHouse Cloud를 기반으로 합니다. 이 기능은 인스턴스를 승격할 때는 활성화되지 않습니다. GitLab은 전환 후 별도의 예약된 단계에서 이 기능을 활성화합니다.

ClickHouse Cloud는 지원되는 리전에서만 사용할 수 있으므로, 사용 가능 여부는 기본 리전에 따라 달라집니다. 자세한 내용은 ClickHouse Cloud 리전을 참조합니다.

통합이 제공하는 기능은 ClickHouse를 참조합니다.

재해 복구용 Geo 보조 사이트#

마이그레이션 중에 GitLab Dedicated 인스턴스는 단일 사이트로 실행됩니다. 인스턴스 자체가 원본 인스턴스의 Geo 보조 사이트 역할을 하므로 보조 리전은 구성되지 않습니다. 따라서 마이그레이션 중에는 표준 GitLab Dedicated Geo 재해 복구 토폴로지가 적용되지 않습니다.

GitLab은 마이그레이션이 완료된 후 보조 사이트를 추가합니다. 보조 사이트를 추가하면 이전 복제 구성으로 돌아갈 수 없으므로, 보조 사이트 추가는 의도적으로 진행하는 단계입니다. 보조 사이트를 추가하면 인스턴스는 다른 모든 GitLab Dedicated 인스턴스와 같은 재해 복구 태세를 갖춥니다.

자세한 내용은 재해 복구를 위한 Geo 복제를 참조합니다.

Note

마이그레이션 중을 포함하여 항상 자동 백업이 적용됩니다. 자세한 내용은 자동 백업을 참조합니다.

러너 및 CI/CD#

러너 등록 레코드는 데이터베이스에 저장되고 데이터베이스가 마이그레이션되므로, 기존 러너는 그대로 유지됩니다.

자체 도메인을 유지하면 인스턴스 호스트 이름이 바뀌지 않으며, 러너는 구성을 변경하지 않고 GitLab Dedicated에 다시 연결됩니다. GitLab에서 제공하는 도메인으로 옮기는 경우에는 러너 구성의 인스턴스 URL을 업데이트합니다.

훨씬 오래된 GitLab 버전의 러너는 재연결이 지연될 수 있습니다. 전환을 원활하게 진행하려면 마이그레이션 기간 전에 자체 관리 러너를 최신 버전으로 올립니다.

자세한 내용은 장애 조치 중 러너 연결을 참조합니다.

GitLab 관리형 러너는 호스티드 러너를 참조합니다.

통합 및 인증#

통합, 웹훅, 아웃바운드 연결은 프리프로덕션 테스트 기간에 검증합니다. 프로덕션 전환 후에는 프로덕션 인스턴스에서 같은 통합을 다시 확인합니다.

다음 항목을 확인합니다.

  • 싱글 사인온(SSO)
  • 내부 대상으로의 웹훅 전달
  • 이메일 전달
  • 러너와 Kubernetes 클러스터에서의 컨테이너 레지스트리 접근
  • 아웃바운드 AWS PrivateLink를 통해 프라이빗 대상에 연결하는 모든 통합
  • 인스턴스를 호출하는 모든 외부 SaaS 서비스. 허용 목록을 사용하는 경우 IP 허용 목록 예외가 필요합니다.

Kubernetes용 GitLab 에이전트를 새 Kubernetes용 GitLab 에이전트 서버(KAS) URL에 다시 등록해야 합니다.

GitLab Dedicated 라이선스 추가#

전환 후에 GitLab Dedicated 라이선스를 추가해야 합니다.

마이그레이션 중에는 GitLab이 라이선스 정보를 나머지 데이터베이스와 함께 복제하므로, 데이터베이스에 GitLab Self-Managed 인스턴스의 라이선스가 들어 있습니다. 이 라이선스는 GitLab Dedicated 구독을 포함하지 않습니다.

라이선스 담당자가 GitLab Dedicated 활성화 코드를 받으며, 이를 승격된 인스턴스에서 활성화해야 합니다. 자세한 내용은 라이선스 키 추가를 참조합니다.

활성화 코드를 받지 못했거나 활성화에 실패하면 GitLab 계정 팀에 문의합니다.

관련 항목#