cluster의 주요 MongoDB 버전을 업그레이드합니다.
이 페이지의 내용
Atlas를 사용하면 클러스터를 수정하여 언제든지 Atlas 클러스터의 주요 버전을 업그레이드할 수 있습니다.
이 절차는 새 MongoDB 버전에 대해 애플리케이션을 테스트하기 위한 목적으로 스테이징 클러스터를 만드는 방법을 안내합니다. 선택 사항이긴 하지만 프로덕션 애플리케이션이 새 MongoDB 버전으로 최대한 원활하게 전환할 수 있도록 이 절차를 사용하는 것이 좋습니다.
고려 사항
업그레이드 절차를 시작하기 전에 몇 가지 주의해야 할 사항이 있습니다:
업그레이드하기 전에 클러스터가 정상 상태여야 합니다.
Atlas 클러스터는 한 번에 하나의 주요 버전만 업그레이드할 수 있습니다. 클러스터를 업그레이드할 때 주요 버전을 건너뛸 수 없습니다.
각 주요 버전에는 이전 버전과 호환되지 않을 수 있는 일부 기능이 포함되어 있습니다. 새로운 주요 버전으로 업그레이드할 때는 릴리스 노트 에서 애플리케이션에 영향을 줄 수 있는 변경 사항을 확인하세요.
MongoDB 주요 버전을 업그레이드한 후에는 이전 버전으로 다운그레이드할 수 없습니다.
MongoDB 4 에서 업그레이드.4 을(를) MongoDB 5 으)로 설정합니다.0 은(는) 성능에 잠재적인 영향을 미칠 수 있습니다. 자세한 내용은 성능 고려 사항 을 참조하세요.
MongoDB 6.0부터
$$SEARCH_META애그리게이션 변수는$searchMeta단계 이후의 그 어떤 단계에서도 사용할 수 없습니다.이전 버전에서 MongoDB 6.0으로 업그레이드하고 Atlas Search
$searchMeta쿼리에$$SEARCH_META애그리게이션 변수를 사용하려는 경우, 업그레이드를 진행하기 전에 검토하여 오류를 방지하세요.
필요한 액세스 권한
클러스터를 업그레이드하려면 프로젝트에 대한 Project Owner 이상의 액세스 권한이 있어야 합니다.
절차
Atlas에
로그인합니다.
로그인한 후 조직을 열고 프로젝트를 찾습니다.
스테이징 환경에 맞는 Atlas cluster를 생성합니다.
참고
이미 Atlas 클러스터를 스테이징 환경으로 사용하고 있는 경우 이 단계를 건너뛸 수 있습니다.
Clusters 페이지가 아직 표시되지 않은 경우 사이드바에서 Database 를 클릭합니다.
Clusters 보기에서 Create 버튼을 클릭하여 클러스터 생성 모달을 엽니다. 프로덕션 클러스터와 일치하도록 스테이징 클러스터를 구성합니다. 스테이징 클러스터에 대한 백업을 활성화할 필요는 없습니다.
새 클러스터를 만드는 방법을 알아보려면 클러스터 만들기를 참조하세요.
중요
스테이징 클러스터에 대해 더 작은 클러스터 계층을 선택하는 경우 실행한 성능 테스트가 업그레이드된 운영 클러스터의 성능을 대표하지 않을 수 있다는 점을 고려합니다. 스테이징 클러스터에 미러링하려는 데이터의 양에 따라 더 큰 스토리지 크기를 선택해야 할 수도 있습니다.
프로덕션 클러스터 데이터로 스테이징 클러스터를 새로 고칩니다.
참고
이미 최신 Atlas 클러스터를 스테이징 환경으로 사용하고 있는 경우 이 단계를 건너뛸 수 있습니다.
프로덕션 클러스터에 대해 백업을 활성화한 경우, 가장 최근 스냅샷을 복원하고 스테이징 클러스터를 대상 위치로 선택합니다.
프로덕션 클러스터에 대해 백업을 사용하지 않는 경우, Atlas Live Import(실시간 가져오기)를 사용하여 프로덕션 클러스터에서 스테이징 클러스터로 데이터를 미러링할 수 있습니다. 실시간 마이그레이션 설명서에는 스테이징 환경 생성에 대한 구체적인 지침이 포함되어 있습니다.
스테이징 애플리케이션을 스테이징 클러스터로 지정합니다.
스테이징 클러스터를 향하도록 스테이징 애플리케이션을 업데이트합니다. 스테이징 cluster에 대한 MongoDB 드라이버 친화적인 연결 문자열 검색에 대한 지침은 드라이버를 통한 연결을 참조하세요.
애플리케이션이 스테이징 클러스터에 성공적으로 연결할 수 있는지 그리고 애플리케이션이 예상대로 작동하는지 확인합니다.
(선택 사항) 애플리케이션을 최신 MongoDB 드라이버로 업그레이드합니다.
애플리케이션을 클러스터 MongoDB 버전의 최신 MongoDB 드라이버로 업그레이드하면 최신 MongoDB 버전에서 제공하는 기능에 완전히 액세스할 수 있습니다. 최신 드라이버 버전을 사용하면 성능이나 안정성이 향상될 수도 있습니다. 특정 MongoDB 버전에 권장되는 MongoDB 드라이버에 대한 설명서 및 연결 예제는 드라이버를 통한 연결을 참조하세요.
애플리케이션을 업그레이드한 후 버그가 발생하면 MongoDB 드라이버의 JIRA 프로젝트에서 티켓을 제출하세요.
스테이징 클러스터를 새로운 주요 MongoDB 버전으로 업데이트하세요.
Clusters 페이지에서 Edit Config를 클릭하고 드롭다운 메뉴에서 스테이징 클러스터를 선택합니다.
클러스터 버전을 원하는 주요 MongoDB 버전으로 변경합니다.
중요
Atlas 클러스터의 MongoDB 버전은 다운그레이드할 수 없습니다. 스테이징 환경을 원래 MongoDB 버전으로 재배포하려면 클러스터를 종료하고 다시 생성해야 합니다.
변경 사항을 배포하려면 Confirm & Deploy를 클릭합니다.
Atlas가 자동으로 클러스터 업그레이드를 시작합니다. Atlas에서 클러스터를 업그레이드하는 데 필요한 시간을 측정하여 프로덕션 클러스터 업그레이드에 대한 일반적인 기대치를 설정하는 것을 고려하세요.
업그레이드된 스테이징 클러스터에서 버전별 문제가 발생하면 지원 티켓을 제출하세요.
업그레이드된 스테이징 클러스터에 대해 애플리케이션을 테스트하세요.
스테이징 클러스터에 필요한 성능 및 운영 테스트를 수행합니다.
업그레이드된 스테이징 클러스터에서 버전별 문제가 발생하면 지원 티켓을 제출하세요.
중요
주요 버전 업그레이드의 경우 적어도 하나의 복제본 세트 투표가 요구됩니다. 스테이징 클러스터를 프라이머리 페일오버에 대한 애플리케이션의 복원력을 테스트할 기회로 활용하세요. 전체 문서는 프라이머리 페일오버 테스트를 참조하세요.
프로덕션 클러스터를 대상 MongoDB 버전으로 업그레이드하세요.
스테이징 클러스터의 성능과 운영에 확신이 들면 프로덕션 클러스터에 대한 업그레이드 절차를 반복합니다.
Atlas가 업그레이드 프로세스를 완료한 후에는 프로덕션 애플리케이션이 여전히 연결되어 있고 정상적으로 작동하고 있는지 확인합니다.
스테이징 애플리케이션을 최신 MongoDB 드라이버로 업그레이드했으며 그 성능과 작동에 만족하는 경우, 프로덕션 애플리케이션 업그레이드를 위한 유지 관리 기간을 예약하는 것이 좋습니다.
업그레이드된 프로덕션 클러스터에 문제가 발생하면 다음 섹션의 절차에 따라 우선 순위가 높게 설정된 지원 티켓을 제출하세요.
주요 버전 업그레이드 지원
이 문서에서 다룬 내용 외 마이그레이션 지원에 관한 질문이 있거나 마이그레이션 중에 오류가 발생하는 경우, Atlas 사용자 인터페이스를 통해 지원 티켓을 제출하세요.
지원 티켓을 제출하려면 다음을 수행합니다.
왼쪽 탐색에서 Support을 클릭합니다.
Atlas Issue Category에서
Other를 선택합니다.Priority에서
Medium Priority를 선택합니다. 문제가 프로덕션 클러스터에 영향을 미치는 경우High Priority를 선택합니다.Request Summary의 경우 요약에
Major Version Upgrade를 포함합니다.More details에는 질문이나 메이저 버전 업그레이드 오류에 대한 기타 세부 정보를 포함합니다.