업그레이드 전 확인 사항

업그레이드 전에 수행할 단계를 설명합니다.

GitLab 인스턴스를 업그레이드하기 전에 다음을 수행해야 합니다. 업그레이드 전 정보를 수집해 업그레이드를 준비합니다. GitLab 자체를 업그레이드하기 전에 사전 단계를 수행합니다. 업그레이드 전 정보 수집 # 업그레이드를 계획할 때 다음을 수행합니다. GitLab 릴리스 및 유지 관리 정책 을 검토합니다. 호환성을 보장하기 위해 GitLab 여러 버전에 대한 GitLab 업그레이드 노트 를 참고합니다. 관련이 있다면 대상 GitLab 버전과의 OS 호환성 을 확인합니다. Geo를 사용 중이라면 다음을 수행합니다. Geo 업그레이드 문서 를 검토합니다. GitLab 업그레이드 노트 에서 Geo 관련 정보를 검토합니다. 데이터베이스 업그레이드 시 Geo 관련 단계를 검토합니다. 각 Geo 사이트(프라이머리와 각 세컨더리)에 대한 업그레이드 및 롤백 계획을 작성합니다. 필요한 업그레이드 정지 지점을 포함해 인스턴스에 적합한 업그레이드 경로 를 결정합니다. 업그레이드 정지 지점이 있으면 여러 차례 업그레이드를 수행해야 할 수 있습니다. 업그레이드 상태 점검 을 실행해 잠재적 문제를 조기에 찾아 해결합니다. 다음을 문서화한 업그레이드 계획을 작성합니다. 인스턴스를 업그레이드하는 단계. 가능하고 필요하다면 무중단 업그레이드 를 포함합니다. 업그레이드가 순조롭게 진행되지 않을 경우의 단계. 필요 시 GitLab 롤백 방법 을 포함합니다. 업그레이드 계획을 운영 환경의 복제본에서 테스트합니다. 이렇게 하면 예기치 않은 중단의 위험을 줄일 수 있고 잠재적으로 장시간 실행되는 마이그레이션 의 소요 시간을 측정하는 데 도움이 됩니다. 업그레이드 전 정보를 모두 수집했다면 사전 단계 수행으로 넘어갈 수 있습니다. 롤백 계획 및 백업 작성 # 업그레이드 중에는 문제가 발생할 수 있으므로 롤백 계획을 마련하는 것이 중요합니다. 적절한 롤백 계획은 GitLab 인스턴스를 마지막으로 정상 작동하던 상태로 되돌리는 명확한 경로를 제공하며 다음으로 구성됩니다. 인스턴스를 백업하는 절차. 인스턴스를 복원하는 절차. 필요해지기 전에 롤백 계획을 테스트해야 합니다. 롤백에 필요한 단계에 대한 개요는 이전 GitLab 버전으로 롤백하기 를 참고합니다. GitLab 백업 만들기 # 업그레이드에 문제가 발생했을 때 GitLab을 롤백할 수 있도록 다음 중 하나를 수행합니다. GitLab 백업 을 만듭니다. 설치 방법에 따른 안내를 따라야 하며 시크릿 및 설정 파일 을 반드시 백업해야 합니다. 인스턴스의 스냅샷을 만듭니다. 인스턴스가 멀티 노드 설치라면 모든 노드의 스냅샷을 만들어야 합니다. 이 과정은 GitLab Support의 지원 범위에 포함되지 않습니다. GitLab 롤백 # 운영 환경을 모사한 테스트 환경이 있다면 예상대로 모두 정상 작동하는지 확인하기 위해 복원을 테스트합니다. GitLab 백업을 복원하려면 다음을 수행합니다. 복원 사전 요구 사항 을 참고합니다. 가장 중요한 점은 백업된 GitLab 인스턴스와 새 GitLab 인스턴스의 버전이 동일해야 한다는 것입