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

프라이머리 페일오버 테스트

참고

이 기능은 M10 클러스터 이상에서 사용할 수 있습니다. Free 클러스터에서 사용할 수 있는 기능에 대한 자세한 내용은 Atlas Free 클러스터 제한을 참조하고, Flex 클러스터에 대한 자세한 내용은 Atlas Flex 제한을 참조하세요.

사용자의 애플리케이션은 다운타임 없이 프라이머리 변경을 처리해야 합니다.

Atlas Core 클러스터의 경우:

  • Atlas conducts replica set elections when it makes configuration changes, such as patch updates and scaling events, and when failures occur.

Atlas Infinite 클러스터의 경우:

  • 저장 계층은 컴퓨팅 노드 간의 투표 대신 페일오버를 조정합니다. 대기 컴퓨팅 노드는 oplog 재생이나 콜드 스타트 없이 프라이머리 노드가 됩니다.

  • 프라이머리 노드는 운영 체제 또는 VM 유지 관리, 수직 확장 또는 축소, MongoDB 버전 업그레이드 및 장애 발생 시 변경될 수 있습니다.

  • Atlas는 롤링 재시작 중에도 가용성을 유지합니다.

복원력이 뛰어난 애플리케이션을 빌드하는 방법은 MongoDB Atlas로 복원력이 뛰어난 애플리케이션 빌드하기를 참조하세요.

You can enable retryable writes by adding retryWrites=true to your Atlas URI connection string. To learn more, see Retryable Writes.

Atlas UI 및 API 사용하여 Atlas cluster 에서 프라이머리 복제본 세트 프라이머리 장애를 테스트하고 애플리케이션 복제본 세트 페일오버 처리하는 방법을 관찰할 수 있습니다.

페일오버 테스트를 시작하려면 프로젝트 에 대한 Organization Owner, Project Owner, Project Cluster Manager 또는 Project Stream Processing Owner 액세스 이 있어야 합니다.

Before you test the failure of the replica set primary, you must meet the following conditions:

  • cluster의 보류 중인 변경 사항이 모두 완료되어야 합니다.

  • cluster의 모든 멤버는 최신 모니터링 데이터가 있는 정상 상태여야 합니다.

  • 각 복제본 세트 또는 샤드에는 프라이머리 노드가 있어야 합니다.

  • cluster의 모든 노드는 복제 지연 시간이 10초 미만이어야 합니다.

  • cluster의 모든 멤버는 사용 가능한 디스크 공간이 5% 이상 남아 있어야 합니다.

  • 모든 프라이머리 노드 조작 로그(oplog)에는 3시간 동안 작동할 수 있는 충분한 공간이 있어야 합니다.

중요

프라이머리 페일오버를 테스트하기 전에 Atlas 클러스터가 정상인지 확인하세요. 그렇지 않으면 Atlas가 귀하의 요청을 거부할 수 있습니다.

프라이머리 페일오버를 테스트하기 위한 요청을 제출하면 Atlas는 페일오버 이벤트를 시뮬레이션합니다. 이 프로세스에서

  1. Atlas shuts down the current primary.

  2. The members of the replica set hold an election to choose which of the secondaries will become the new primary. On average, an election takes approximately five seconds.

  3. Atlas brings the original primary back to the replica set as a secondary. When the old primary rejoins the replica set, it will sync with the new primary to catch up any writes that occurred during its downtime.

다음 설명은 롤오버와 샤딩된 클러스터에서 페일오버를 테스트할 때 Atlas 동작을 설명합니다.

  • Atlas Core 클러스터에서 원래의 프라이머리는 세컨더리로 성공적으로 복제되지 않은 쓰기 (write) 작업을 수락했을 수 있습니다. 해당 프라이머리가 복제본 세트에 다시 참여하고 동기화를 시작하면 복제되지 않은 쓰기 (write)를 롤백합니다. 학습 내용은 Atlas에서 페일오버 중 롤백을 참조하세요.

  • Atlas Infinite 클러스터에서는 롤백이 발생하지 않습니다. 저장 계층이 쓰기 (write) 작업을 커밋하므로 이전 프라이머리 노드에는 되돌릴 복제되지 않은 쓰기 (write)가 없습니다.

  • Only the mongos processes that are on the same instances as the primaries of the replica sets in the sharded cluster are restarted.

  • 샤딩된 클러스터에 있는 복제본 세트의 프라이머리가 병렬로 재시작됩니다.

Atlas CLI를 사용하여 프로젝트에서 지정된 클러스터에 대한 장애 조치 테스트를 시작하려면 다음 명령을 실행합니다.

atlas clusters failover <clusterName> [options]

To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas clusters failover.

페일오버에 성공했는지 확인하는 방법:

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 사이드바에서 Database 제목 아래의 Clusters를 클릭합니다.

Clusters(클러스터) 페이지가 표시됩니다.

2
  1. 페일오버를 수행한 cluster의 이름을 클릭합니다.

  2. Overview 탭의 노드 목록에서 다음과 같은 변경 사항을 확인하세요.

    • 원래 PRIMARY 노드는 이제 SECONDARY 노드입니다.

    • 이전 SECONDARY 노드는 이제 PRIMARY 노드입니다.

애플리케이션이 페일오버를 정상적으로 처리하지 못하는 경우 다음 사항을 확인하세요.

  • You are using the SRV Connection Format.

  • 최신 버전의 드라이버를 사용하고 있는지 여부

  • 애플리케이션에서 적절한 재시도 논리를 구현했는지 여부