AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

MongoDB 버전 및 업그레이드 경로

MongoDB는 정기적으로 새 버전을 출시합니다. 해당 버전을 수신하는 방법과 타이밍에 대한 제어 수준은 MongoDB를 실행하는 방식에 따라 다릅니다. 배포서버 유형에 따라 새 버전을 실행하기 위해 준비해야 하는 방법이 다릅니다.

이 페이지에서는 MongoDB 버전 번호의 MEAN, 릴리스 유형, 그리고 일반적인 텀에서 업그레이드 방식에 대해 설명합니다. 귀하의 배포서버에 특정한 절차 및 정책은 전체 링크를 참조하십시오.

MongoDB 버전 번호는 X.Y.Z 형식을 따릅니다.

  • X는 주요 버전입니다. 여기에서의 변경은 이전 버전에서 읽을 수 없는 형식으로 데이터를 유지하는 새로운 기능과 이전 버전과 호환되지 않는 변경 사항이 포함될 수 있는 릴리스를 나타냅니다.

  • Y는 마이너 버전입니다. 마이너 릴리스는 메이저 릴리스 사이에 점진적인 기능을 제공하며, 가용성은 배포서버 유형에 따라 다릅니다.

  • Z는 패치 버전입니다. 패치 릴리스에는 수정 사항이 포함되어 있으며 릴리스 시리즈 내에서 이전 버전과 호환됩니다.

드라이버, MongoDB Shell 및 MongoDB Database Tools는 데이터베이스 서버와 독립적으로 버전이 지정됩니다. 드라이버 버전 번호는 서버 버전 번호와 일치하지 않습니다. 어떤 드라이버 버전이 어떤 서버 버전과 호환되는지 알아보려면 드라이버 호환성 페이지를 참조하세요.

메이저 릴리스는 새로운 기능을 도입하며 이전 버전과 호환되지 않는 변경 사항이 포함될 수 있습니다. MongoDB는 Atlas 및 자체 관리형 배포서버 모두에 대해 메이저 릴리스를 지원합니다.

마이너 릴리스는 메이저 릴리스 사이의 더 빠른 주기로 기능을 제공합니다. 새로운 마이너 릴리스가 제공되면 MongoDB는 이전 마이너 릴리스에 대한 패치를 중단합니다. 보안 업데이트 및 버그 수정을 계속 받으려면 최신 마이너 릴리스의 최신 패치 릴리스로 업그레이드하십시오.

MongoDB 8.2부터는 자동 업그레이드를 통해 Atlas 클러스터에서 마이너 릴리스를 사용할 수 있습니다. 또한 Enterprise Advanced 및 Community 자체 관리형 배포서버에서도 사용할 수 있습니다.

MongoDB 9.0부터:

  • 자동 업그레이드가 활성화된 Atlas 클러스터에는 마이너 릴리스가 제공됩니다.

  • 마이너 릴리스는 수동 업그레이드 상태의 Atlas 클러스터나 자체 관리형 배포서버에서는 사용할 수 없습니다.

점진적 기능 릴리스에 대한 자세한 내용은 기능 업데이트 릴리스를 참조하세요.

참고

마이너 릴리스는 모든 기능을 지원하지 않을 수 있으며, 특히 Atlas 실시간 마이그레이션 및 mongosync은 지원하지 않을 수 있습니다.

MongoDB 9.0부터, 기능 업데이트 릴리스는 연간 마이너 릴리스로, 번호는 x.5이며 Atlas 및 자체 관리형 배포서버에서 사용할 수 있습니다. 수동 업그레이드 및 자체 관리형 배포서버의 Atlas 클러스터는 기능 업데이트 릴리스를 사용하여 다음 메이저 버전을 기다리지 않고도 증분 기능을 얻을 수 있습니다.

기능 업데이트 릴리스는 해당 릴리스가 확장하는 메이저 버전과 동일한 수명 종료(EOL) 일정 및 Extended Lifecycle Support 자격을 갖습니다.

중요

MongoDB 9.0 이상에서 모든 마이너 릴리스를 받으려면 Atlas 클러스터를 Latest Version With Auto Upgrades로 구성하세요. 다른 모든 배포서버는 기능 업데이트 릴리스에만 적합하며 다른 마이너 릴리스에는 적합하지 않습니다.

패치 릴리스에는 수정 사항이 포함되어 있으며 동일한 메이저 및 마이너 릴리스 시리즈 내에서만 이전 버전과 호환됩니다. 항상 메이저 및 마이너 버전에 대한 최신 패치 릴리스를 실행해야 합니다.

릴리스 후보는 새로운 기능을 평가하기 위한 사전 릴리스 빌드입니다. 프로덕션 배포서버에는 적합하지 않습니다.

MongoDB 릴리스는 자체 관리형 배포서버에서 사용할 수 있게 되기 전에 Atlas에 먼저 제공됩니다.

참고

Free 및 Flex 클러스터는 메이저 버전을 유지합니다. 릴리스 주기를 선택할 수 없으며 Atlas가 자동으로 업그레이드합니다.

Atlas는 배포서버에 업그레이드를 제공하기 위해 Atlas의 수동 업그레이드와 Atlas의 자동 업그레이드라는 두 가지 고유한 방법을 사용합니다.

  • Atlas에서의 수동 업그레이드: 새로운 메이저 버전으로 업그레이드할 시기를 직접 제어할 수 있습니다.

    • Atlas Core 클러스터: 특정 메이저 버전을 선택하고 업그레이드 시기를 제어할 수 있습니다.
  • Atlas 자동 업그레이드: Atlas는 새로운 릴리스를 자동으로 제공합니다.

    • Atlas Infinite 클러스터: Atlas Infinite 클러스터는 항상 자동 업그레이드를 사용합니다. Atlas Infinite 클러스터의 경우 Atlas UI의 Latest Version With Auto Upgrades 옵션이 항상 활성화되어 있습니다.

    • Atlas Core 클러스터: Atlas Core 클러스터는 자동 업그레이드를 사용할 수 있습니다. 이 동작을 활성화하려면 Atlas UI에서 Latest Version With Auto Upgrades 옵션을 선택하세요.

중요

자동 업그레이드가 설정된 Atlas 클러스터는 자체 관리형 배포서버에서 직접 다운로드하여 설치할 수 있는 릴리스보다 먼저 해당 릴리스를 실행할 수 있습니다.

자체 관리형 배포서버(Enterprise Advanced 또는 Community)의 수동 업그레이드의 경우, 각 릴리스를 다운로드하고 설치할 시기를 선택합니다. 사용자가 조치를 취하기 전까지는 아무것도 변경되지 않습니다.

MongoDB 바이너리를 업그레이드하는 것과 새 버전의 기능을 활성화하는 것은 별개의 단계입니다.

기능 호환성 버전(FCV)은 이전 버전에서 읽을 수 없는 형식으로 데이터를 쓰기 (write) 기능을 활성화할지 여부를 제어합니다. 바이너리를 업그레이드한 후에도 배포서버는 이전 FCV에서 계속 실행되며, 사용자가 FCV를 높일 때까지 유지됩니다. 이는 의도적인 것으로, 기능 호환성 버전가 이전 버전으로 유지되는 동안에는 다운그레이드할 수 있는 기능이 유지됩니다.

참고

자동 업그레이드가 설정된 Atlas 클러스터의 경우, Atlas는 새로운 주요 MongoDB 버전이 출시될 때마다 해당 버전에 맞춰 FCV를 상향 조정합니다. Atlas는 먼저 MongoDB 바이너리에 대한 롤아웃 신호를 자동으로 검토합니다. 사용자는 FCV를 제어할 수 없습니다.

FCV를 높이는 것은 되돌릴 수 없는 지점입니다. 새로운 형식으로 데이터를 유지하는 기능이 활성화되면 Atlas에서 다운그레이드할 수 없습니다.

명령 참조는 MongoDB 매뉴얼의 setFeatureCompatibilityVersion을 참조하세요. 업그레이드 전 기능 호환성 버전 고정을 포함하여 Atlas에서 기능 호환성 버전가 작동하는 방식에 대한 자세한 내용은 클러스터의 주요 MongoDB 버전 업그레이드를 참조하세요.

각 MongoDB 주 버전은 5년 동안 지원됩니다. Enterprise Advanced 고객에게 선택 사항인 2년 기간의 확장 사용 지원(ELS) 기간이 제공됩니다. 버전이 지원 종료 시점에 도달하면, 해당 버전은 더 이상 보안 패치를 포함하여 수정 사항을 제공받지 않습니다. 또한 MongoDB도 더 이상 해당 버전의 문서를 유지 관리하지 않습니다.

배포서버 유형에 따라 처리 방식이 다릅니다.

  • Atlas의 경우, MongoDB는 버전의 사용 기한이 만료되기 최소 6개월 전에 이메일 알림을 보냅니다. 알림에는 클러스터를 직접 업그레이드하는 방법에 대한 지침이 포함되어 있습니다. 알림이 전송된 후 몇 개월이 지나면 Atlas는 해당 버전에서 새로운 배포서버를 허용하지 않습니다. 알림에 명시된 날짜까지 업그레이드하지 않으면 Atlas는 기존 클러스터를 현재 MongoDB의 기본값 대상 버전으로 업그레이드합니다. Atlas는 구성된 유지 관리 기간이 있는 경우 해당 기간 동안 업그레이드를 수행합니다.

    중요

    MongoDB의 현재 기본값 대상 버전이 항상 바로 다음 메이저 버전인 것은 아닙니다.

  • 자체 관리형 배포서버는 수명이 다하기 전에 업그레이드해야 합니다.

현재 어떤 플랫폼에서 어떤 버전이 지원되는지 확인하려면 MongoDB Enterprise 지원 플랫폼 또는 MongoDB Community 지원 플랫폼을 참조하세요.

실행 경우
버전 주기
여기에서 시작하세요

Atlas의 수동 업그레이드

다음 메이저 버전으로 언제 전환할지는 사용자가 결정합니다.

Atlas의 자동 업그레이드

Atlas는 자동으로 업그레이드됩니다. 유지 관리 웨이브를 사용하여 환경 전반의 순서를 제어하세요.

자체 관리형 배포서버(Enterprise Advanced 및 Community)의 업그레이드

시기는 직접 결정하세요.

자체 관리형 배포서버의 경우 업그레이드 절차는 토폴로지에 따라 다릅니다. 각 릴리스의 업그레이드 페이지는 독립형, 복제본 세트 및 샤딩된 클러스터 절차로 연결됩니다.

9.0 이전의 MongoDB 버전에서는 마이너 릴리스를 건너뛸 수 없습니다. 마이너 릴리스 간에 이동하려면 각 릴리스를 순서대로 업그레이드하세요.

마이너 릴리스에서 다음 메이저 릴리스로 이동하려면 다음을 수행할 수 있습니다.

  • 각 마이너 릴리스를 순차적으로 업그레이드한 다음, 다음 메이저 릴리스로 업그레이드하세요.

  • 이전 메이저 릴리스로 다운그레이드한 다음 다음 메이저 릴리스로 업그레이드하십시오.

각 업그레이드 또는 다운그레이드 단계에는 바이너리 업그레이드와 기능 호환성 버전(FCV) 업그레이드가 모두 필요합니다.

MongoDB 9.0부터, Enterprise Advanced 배포서버는 메이저 릴리스 외에 연간 기능 업데이트 릴리스만 제공받습니다. 이제 릴리스 주기 내에서 건너뛸 마이너 릴리스 시퀀스가 없습니다.

MongoDB의 메이저 버전을 업그레이드하기 전에 선택한 업그레이드 유형에 관계없이 다음 조치를 취하는 것이 좋습니다.

1

각 메이저 릴리스는 이전 버전에 대해 작성된 애플리케이션에 영향을 줄 수 있는 변경 사항을 문서화합니다.

2

이러한 조치를 수행하는 방법은 배포서버에 따라 다릅니다.

  • 자체 관리형: 비운영 배포서버를 먼저 업그레이드하세요.

  • Atlas의 수동 업그레이드: 대상 버전을 실행하는 스테이징 클러스터를 생성하고 테스트합니다. 클러스터의 주요 MongoDB 버전 업그레이드를 참조하세요.

  • Atlas의 자동 업그레이드: 유지 관리 웨이브를 사용하여 스테이징 및 프로덕션 환경을 순차적으로 업그레이드합니다. 유지 관리 웨이브는 롤아웃을 중단하지 않을 수 있으며 업그레이드 타이밍에 대한 완전한 제어 권한을 제공하지 않습니다. Atlas Core 클러스터의 경우 릴리스를 검증할 시간이 더 필요한 경우 수동 업그레이드로 전환할 수 있습니다. 유지 관리 웨이브에 대한 자세한 내용은 클러스터 유지 관리 관리를 참조하세요.

3

다운그레이드에는 제약이 있으며, 이러한 제약은 배포서버에 따라 다릅니다. 배포서버와 일치하는 옵션을 선택하여 적용되는 제약을 확인하세요.

다운그레이드는 인접한 버전 간에만 지원되며 클러스터 구성에 특정한 절차가 필요합니다.

  • 다운그레이드를 수행하려면 FCV를 상향 조정하지 않았거나 원래 업그레이드 전에 고정되어 있어야 합니다.

  • 클러스터는 바로 이전 릴리스(이전 메이저 버전 또는 해당 메이저 버전의 기능 업데이트 릴리스)로만 다운그레이드할 수 있으며, 여러 버전에 걸쳐 다운그레이드를 연결할 수는 없습니다.

  • 기능 업데이트 릴리스의 클러스터는 자체 메이저 버전으로 다운그레이드할 수 있습니다.

  • 거의 모든 경우에 다운그레이드는 대상 버전의 최신 패치 릴리스로 적용됩니다.

  • 다운그레이드 후에는 최신 버전에서 도입된 기능을 더 이상 사용할 수 없으며, MongoDB는 새로운 하위 버전에서 두 번째 다운그레이드를 지원하지 않습니다.

참고

Free 및 Flex 클러스터는 다운그레이드할 수 없습니다.