Geo 사이트 업그레이드

Tier: Premium, Ultimate Offering: Self-Managed
caution
Geo 사이트를 업데이트하기 전에 이 섹션들을 주의 깊게 읽으세요. 버전별 업그레이드 단계를 따르지 않으면 예상치 못한 다운타임이 발생할 수 있습니다. 특별한 질문이 있으면 지원팀에 문의하세요. 데이터베이스 주 버전 업그레이드는 PostgreSQL 복제를 다시 초기화해야 합니다. 이는 Linux 패키지 및 외부 관리 데이터베이스에 모두 적용됩니다. 이로 인해 예상보다 오랜 다운타임이 발생할 수 있습니다.

Geo 사이트를 업그레이드하는 것은 다음을 수행하는 것을 포함합니다:

  1. 버전별 업그레이드 단계 적용(업그레이드 대상 또는 업그레이드 전 버전에 따라 다름).
  2. 일반 업그레이드 단계, 모든 업그레이드에 적용.

일반 업그레이드 단계

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

새 GitLab 버전이 발매될 때 Geo 사이트를 업그레이드하려면 기본과 모든 보조 사이트를 업그레이드하세요:

  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 문제 해결 가이드를 참조하세요.