cluster의 주요 MongoDB 버전을 업그레이드합니다.
이 페이지의 내용
클러스터를 수정하여 언제든지 Atlas 클러스터의 메이저 버전을 업그레이드할 수 있습니다.
새로운 MongoDB 버전으로의 전환을 원활하게 수행하고 애플리케이션에 영향을 미치지 않도록, 프로덕션 Atlas 클러스터에서 메이저 버전을 업그레이드하기 전에 다음 절차에 따라 스테이징 클러스터를 생성하고 새로운 MongoDB 버전에 대해 애플리케이션을 테스트하세요.
고려 사항
다음 고려 사항이 적용됩니다.
업그레이드하기 전에 클러스터가 정상 상태여야 합니다.
주요 버전 업그레이드 전에 주문형 스냅샷을 찍는 경우, 스냅샷이 완료될 때까지 기다렸다가 버전을 업그레이드하세요.
Atlas 클러스터는 한 번에 하나의 주요 버전만 업그레이드할 수 있습니다. 클러스터를 업그레이드할 때 주요 버전을 건너뛸 수 없습니다.
각 주요 버전에는 이전 버전과 호환되지 않을 수 있는 일부 기능이 포함되어 있습니다. 새로운 주요 버전으로 업그레이드할 때는 릴리스 노트에서 애플리케이션에 영향을 줄 수 있는 변경 사항을 확인하세요. Stable API를 사용하는 경우, 업그레이드 후 MongoDB 버전 간의 동작 변경으로 인해 애플리케이션이 중단되지 않도록 할 수 있습니다.
MongoDB Stable API는 애플리케이션이 데이터를 읽고 쓰고, 컬렉션과 인덱스를 만들고, 기타 일반적인 작업을 수행하는 데 사용하는 MongoDB 명령 하위 집합을 포함합니다. Stable API를 사용하면 애플리케이션이 실행되는 MongoDB API의 버전을 지정할 수 있으며 애플리케이션에 장기적인 API 안정성을 제공할 수 있습니다. 더 빈번한 릴리스와 자동 서버 업그레이드를 지원하므로 이전 버전과 호환되지 않는 변경 사항의 위험 없이 애플리케이션이 빠르게 릴리스되는 기능을 활용할 수 있습니다.
MongoDB 주요 버전을 업그레이드한 후에는 업그레이드 전에 클러스터의 FCV 고정하지 않는 한 이전 버전으로 다운그레이드할 수 없습니다.
실시간 마이그레이션 위해서는 대부분의 경우 소스 클러스터와 대상 클러스터의 FCV 가 일치해야 합니다. 자세히 학습 데이터 마이그레이션 또는 가져오기를 참조하세요.
MongoDB 6.0부터
$$SEARCH_META집계 변수는$searchMeta단계 이후의 모든 후속 단계에서 사용할 수 없습니다.이전 버전에서 MongoDB 6.0으로 업그레이드하고 Atlas Search
$searchMeta쿼리에$$SEARCH_META집계 변수를 사용하려는 경우, 업그레이드를 진행하기 전에 검토하여 오류를 방지하세요.
필요한 액세스 권한
클러스터를 업그레이드하려면 프로젝트에 대한 Project Owner 이상의 역할이 있어야 합니다.
주요 MongoDB 버전 업그레이드
주요 MongoDB 버전을 업그레이드 하려면 다음을 수행합니다.
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 버전으로 변경합니다.
중요
업그레이드 전에 클러스터의 FCV 이전에 고정하지 않은 경우, Atlas cluster 의 MongoDB 버전을 다운그레이드할 수 없습니다. 스테이징 환경을 원래 MongoDB 버전으로 재배포하려면 클러스터 종료하고 다시 생성해야 합니다.
변경 사항을 배포하려면 Confirm & Deploy를 클릭합니다.
Atlas가 자동으로 클러스터 업그레이드를 시작합니다. Atlas에서 클러스터를 업그레이드하는 데 필요한 시간을 측정하여 프로덕션 클러스터 업그레이드에 대한 일반적인 기대치를 설정하는 것을 고려하세요.
업그레이드된 스테이징 클러스터에서 버전별 문제가 발생하면 지원 티켓을 제출하세요.
업그레이드된 스테이징 클러스터에 대해 애플리케이션을 테스트하세요.
스테이징 클러스터에 필요한 성능 및 운영 테스트를 수행합니다.
업그레이드된 스테이징 클러스터에서 버전별 문제가 발생하면 지원 티켓을 제출하세요.
중요
주요 버전 업그레이드의 경우 적어도 하나의 복제본 세트 투표가 요구됩니다. 스테이징 클러스터를 프라이머리 페일오버에 대한 애플리케이션의 복원력을 테스트할 기회로 활용하세요. 전체 문서는 프라이머리 페일오버 테스트를 참조하세요.
프로덕션 클러스터를 대상 MongoDB 버전으로 업그레이드하세요.
스테이징 클러스터의 성능과 운영에 확신이 들면 프로덕션 클러스터에 대한 업그레이드 절차를 반복합니다.
Atlas가 업그레이드 프로세스를 완료한 후에는 프로덕션 애플리케이션이 여전히 연결되어 있고 정상적으로 작동하고 있는지 확인합니다.
스테이징 애플리케이션을 최신 MongoDB 드라이버로 업그레이드했으며 그 성능과 작동에 만족하는 경우, 프로덕션 애플리케이션 업그레이드를 위한 유지 관리 기간을 예약하는 것이 좋습니다.
업그레이드된 프로덕션 클러스터에 문제가 발생하면 다음 섹션의 절차에 따라 우선 순위가 높게 설정된 지원 티켓을 제출하세요.
업그레이드 중 기능 호환성(FCV) 관리
MongoDB 주요 버전 업그레이드는 Atlas 배포와 온프레미스 배포 모두에서 지원됩니다. FCV 이전 버전의 MongoDB 와 호환되지 않는 데이터를 유지하는 기능을 활성화하거나 비활성화합니다. Atlas 에서 업그레이드하기 전에 클러스터의 FCV 고정할 수 있으며, 이를 통해 업그레이드 후 버전 호환성 문제 없이 MongoDB 이전 버전으로 되돌릴 수 있습니다.
다음 절차를 통해 클러스터 의 FCV 고정 및 고정 해제하거나, 클러스터 한 주요 버전으로 다운그레이드하거나, 지원 티켓 파일 .
경고
FCV 는 고정 날짜 이후 최대 주 동안만 지속되는 단기 조치이며 이전 바이너리 버전의 동작을 시뮬레이션하지 않습니다. 4 새로운 서버 기능을 허용하는 특정 내부 데이터 구조의 업그레이드만 연기합니다. 이전 버전으로 다운그레이드할 필요가 없다고 판단되면 현재 바이너리 버전과 일치하도록 FCV 고정 해제합니다.
제한 사항
FCV 고정은 전용 클러스터에서만 사용할 수 있습니다.
FCV 핀은 핀 날짜로부터 주를 초과하여 연장할 수 없습니다.4
Rapid 출시하다 의 클러스터에는FCV 고정이 지원되지 않습니다.
클러스터 버전의 수명이 종료되기 전에 클러스터의 FCV 고정해야 합니다.
클러스터에 대한 FCV 고정
클러스터 에 고정된 FCV Version 있는 경우, 클러스터 카드 하단에 있는 클러스터의 옆에 고정 아이콘이 나타납니다. 핀 아이콘 위에 커서 올리면 FCV 와 만료 날짜를 보여주는 툴팁이 나타납니다.
Atlas 만료 날짜 또는 그 이후에 시작되는 다음 유지 관리 기간 에 클러스터의 FCV 고정 해제합니다.
클러스터의 MongoDB 버전을 이미 업그레이드한 경우, 핀이 만료되면 Atlas MongoDB 버전과 일치하도록 FCV 를 업그레이드합니다.
클러스터 의 FCV 고정하려면 다음을 수행합니다.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
클러스터 오른쪽에 있는 아이콘을 클릭합니다.
만료 날짜를 설정합니다.
모든 날짜는 ISO 8601 날짜 및 시간 형식의 UTC 형식의 타임스탬프 MM/DD/YYYY 로 설정하다 됩니다. FCV 만료 날짜를 FCV 고정한 날짜로부터 4주 이내로 설정합니다. 만료 날짜가 지나면 툴팁에 Expired XX/XX/XXXX가 표시됩니다. FCV 핀은 4 주 후에 자동으로 만료됩니다.
FCV 고정이 만료되면 Atlas 만료 날짜 또는 그 이후에 시작되는 다음 유지 관리 기간 에 클러스터의 FCV 고정을 해제합니다. 클러스터의 MongoDB 버전을 이미 업그레이드한 경우, Atlas MongoDB 버전과 일치하도록 FCV 를 업그레이드합니다.
API 사용하여 클러스터 에 대한 FCV 고정하려면 1개의 프로젝트에서 1개의 클러스터에 대한 FCV 고정을 참조하세요.
클러스터에 대한 FCV 고정 해제
클러스터 의 FCV 고정 해제하려면 다음을 수행합니다.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
클러스터 오른쪽에 있는 아이콘을 클릭합니다.
API 사용하여 클러스터 의 FCV 고정을 해제하려면 1개의 프로젝트에서 1개의 클러스터에 대한 FCV고정 해제를 참조하세요.
클러스터를 하나의 주요 버전으로 다운그레이드
클러스터 버전을 다운그레이드할 때는 다음과 같은 제한 사항이 적용 .
업그레이드 전에 클러스터의 FCV 고정한 경우에만 다운그레이드할 수 있습니다.
고정된 FCV 와 일치하는 주요 버전으로만 클러스터 다운그레이드할 수 있습니다.
고정된 FCV 현재 FCV 보다 하나 낮은 주요 버전이고 빠른 출시하다 활성화하지 않은 경우에만 이 조치 수행할 수 있습니다.
수명이 다한 후에는 버전으로 다운그레이드할 수 없습니다.
클러스터 하나의 주요 버전으로 다운그레이드하려면 다음을 수행합니다.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
클러스터 오른쪽에 있는 아이콘을 클릭합니다.
API 사용하여 클러스터 하나의 주요 버전으로 다운그레이드하려면 1개의 프로젝트에서 1개의 클러스터 수정을 참조하세요.
지원 팀에 문의하기
이 문서에서 다룬 내용 외 마이그레이션 지원에 관한 질문이 있거나 마이그레이션 중에 오류가 발생하는 경우, Atlas 사용자 인터페이스를 통해 지원 티켓을 제출하세요.
궁금한 점이 있거나 추가 도움이 필요하면 지원 팀 문의하세요.