Geo 사이트 업그레이드


Tier: 프리미엄, 얼티메이트
Offering: Self-managed
caution

Geo 사이트를 업데이트하기 전에 이 섹션을 주의 깊게 읽으세요. 특정 버전별 업그레이드 단계를 따르지 않으면 예상치 못한 다운타임이 발생할 수 있습니다. 특정 문의 사항이 있을 경우 지원팀에 문의하세요. 데이터베이스 주요 버전 업그레이드는 PostgreSQL 복제를 다시 초기화 해서 Geo secondaries에 적용해야 합니다. 이는 Linux 패키지 및 외부 관리형 데이터베이스 모두에 적용됩니다. 이로 인해 예상보다 긴 다운타임이 발생할 수 있습니다.

Geo 사이트를 업그레이드하는 데는 다음이 필요합니다:

  1. 버전별 업그레이드 단계, 업그레이드 대상 또는 업그레이드 원본에 따라:
  2. 모든 업그레이드에 대한 일반 업그레이드 단계.

일반 업그레이드 단계

note

이러한 일반 업그레이드 단계는 멀티 노드 설정에서 다운타임이 필요합니다. 다운타임을 피하려면 제로 다운타임 업그레이드를 고려해보세요.

새로운 GitLab 버전이 출시되면, 기본 사이트와 모든 보조 사이트를 업그레이드하세요:

  1. 선택 사항. 각 보조 사이트에서 복제를 일시 중지하여 보조 사이트의 재해 복구(DR) 기능을 보호합니다.
  2. 기본 사이트의 각 노드에 SSH로 연결합니다.
  3. 기본 사이트에서 GitLab을 업그레이드하세요.
  4. 특히 DR을 보호하기 위해 단계 1에서 복제를 일시 중지했다면 기본 사이트에서 테스트를 수행하세요. 업그레이드 문서에는 업그레이드 후 테스트에 대한 몇 가지 제안이 있습니다.
  5. 기본 사이트 및 보조 사이트의 /etc/gitlab/gitlab-secrets.json 파일에서 비밀 정보가 동일한지 확인하세요. 해당 파일은 사이트의 모든 노드에서 동일해야 합니다.
  6. 보조 사이트의 각 노드에 SSH로 연결하세요.
  7. 각 보조 사이트에서 GitLab을 업그레이드하세요.

  8. 단계 1에서 복제를 일시 중지했다면, 각 보조에서 복제를 다시 시작하세요. 그런 다음 각 보조 사이트에서 Puma와 Sidekiq를 다시 시작하세요. 이렇게 하면 이전에 업그레이드된 기본 사이트에서 복제된 새로운 데이터베이스 스키마에 대해 초기화됩니다. 

    sudo gitlab-ctl restart sidekiq
sudo gitlab-ctl restart puma
  9. 기본 및 보조 사이트를 테스트하고, 각각의 버전을 확인하세요.

업그레이드 후 상태 확인

이제 업그레이드 프로세스가 완료되었으므로 모든 것이 올바르게 작동하는지 확인하고 싶을 것입니다:

  1. 기본 및 보조 사이트에 대해 애플리케이션 노드에서 Geo Rake 작업을 실행하고 모든 것이 정상적으로 작동하는지 확인하세요: 

    sudo gitlab-rake gitlab:geo:check
  2. 기본 사이트의 Geo 대시보드에서 오류를 확인하세요.
  3. 코드를 기본 사이트에 푸시하여 보조 사이트에서 수신되는지 확인하여 데이터 복제를 테스트하세요.

문제가 발생하는 경우 Geo 문제 해결 가이드를 참조해보세요.