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