mongosync 버전 관리
이 페이지의 내용
Cluster-to-Cluster Sync 사용 시맨틱 버전 관리 2.0.0. 버전 번호는 X.Y.Z 형식을 가지며, 여기서 X 은 메이저 버전, Y 마이너 버전, Z 는 패치 버전입니다.
MongoDB는 다음 지침에 따라 Cluster-to-Cluster Sync의 버전 번호를 증가시켜야 하는 시기를 결정합니다.
주요 번호: 이 릴리스는 이전 버전과의 호환성을 중단합니다.
부 번호: 이 릴리스에는 이전 버전과 호환되는 중요한 새 기능이 포함되어 있습니다.
패치 번호: 이 릴리스에는 이전 버전과 호환되는 작은 변경 사항만 포함되어 있습니다.
현재 지원되는 버전
MongoDB는 각 주요 버전의 최신 패치 릴리스만 지원합니다. 예를 들어 mongosync 1.8.0 은 1.8 의 최신 패치 릴리스입니다. 지원되지 않는 mongosync 버전을 사용하는 경우 지원을 받기 위해 업그레이드해야 할 수 있습니다.
버전 관련 고려 사항
Cluster-to-Cluster Sync에는 다음과 같은 버전 관련 고려 사항이 있습니다.
라이프사이클
주요 릴리스는 해당 시리즈의 첫 번째 릴리스로부터 최소 1년 동안 지원됩니다.
Cluster-to-Cluster Sync 버전이 지원되지 않는 MongoDB Server 버전에서만 작동하는 경우, 해당 버전의 Cluster-to-Cluster Sync도 지원되지 않습니다.
패치 릴리스
각 주요 릴리스 시리즈의 최신 버전에만 새로운 패치 릴리스가 제공됩니다. 예를 들어 Cluster-to-Cluster Sync 2.1.0 버전이 출시되면 버전 2.0은 더 이상 패치 릴리스를 제공하지 않습니다. 동시에 버전 1.3은 버전 1.4가 릴리스될 때까지 계속 패치를 받게 됩니다.
라이브 업그레이드
버전 1.7.0에 새로 추가되었습니다.
mongosync 1.7.0 부터 시작, 데이터 동기화 작업을 처음부터 다시 시작하지 않고도 mongosync 를 업그레이드 할 수 있습니다. mongosync 1 에서는 mongosync 1.7.3 이상으로만 실시간 업그레이드 할 수 있습니다.7.2 또는 그 이후 버전.
실시간 업그레이드 후 mongosync 는 업그레이드 전에 진행 중이던 작업을 계속합니다.
mongosync 을(를) 실시간 업그레이드하려면 다음 단계를 수행하세요.
(선택 사항)mongosync 프로세스 일시 중지
mongosync 를 일시 중지하려면 실행 실행 각 mongosync 프로세스 에서 pause 를 실행합니다.
마지막 단계에 표시된 대로 나중에 일시 중지된 상태에서 mongosync 프로세스를 재개할 수 있습니다.
팁
라이브 업그레이드 후 데이터 동기화 작업을 즉시 다시 시작하지 않으려면 mongosync 프로세스를 일시 중지하는 것이 좋습니다. 이는 여러 mongosync 프로세스의 작업을 조정할 때 유용합니다.
새 바이너리 mongosync 다운로드 및 설치
새 mongosync 바이너리를 다운로드하고 설치하려면 mongosync 다운로드 및 설치를 참조하세요.
프로세스 초기화 mongosync
mongosync 프로세스를 초기화하려면 빠른 시작 을 참조하세요. 실시간 업그레이드 후 초기화하는 동안 mongosync 는 영구 메타데이터 를 업데이트합니다.
프로세스 재개 mongosync
선택적 첫 번째 단계 앞부분에서 mongosync 프로세스를 일시 중지한 경우 모든 mongosync 프로세스에서 resume 를 실행합니다.
실시간 업그레이드 전에 데이터 동기화 작업이 이미 진행 중이던 경우, 실시간 업그레이드 후 최신 mongosync 버전에 추가된 새로운 기능이 모두 지원되지 않을 수 있습니다. 성능 개선 및 버그 수정은 실시간 업그레이드 후에도 항상 지원됩니다. 실시간 업그레이드 후 지원될 수 있는 새로운 기능에 대한 자세한 내용은 1.7.0 릴리스를 참조하세요.
라이브 외 업그레이드 또는 다운그레이드
실시간 업그레이드 절차에서 지원하지 않는 이전 mongosync 버전을 사용하거나 mongosync 를 다운그레이드해야 하는 경우 다음 단계를 수행하세요.
현재 실행 중인
mongosync프로세스를 모두 중지합니다.대상 cluster의 모든 비시스템 데이터베이스를 삭제합니다.
새
mongosync바이너리를 설치 합니다.새 바이너리를 사용하여
mongosync프로세스를 시작 합니다.
경고
새 mongosync 프로세스는 진행되었을 수 있는 작업을 재개하지 않습니다. 동기화 작업은 새 프로세스를 시작할 때 처음부터 다시 시작됩니다.
영구 메타데이터
정상 작업 중에 mongosync 는 대상 데이터베이스의 디스크에 유지되는 메타데이터를 생성합니다. 이 메타데이터는 버전이 관리되지 않으며 언제든지 변경될 수 있습니다.
로그 메시지
로그 메시지 형식은 버전이 없으며 언제든지 변경될 수 있습니다. 여기에는 메시지 텍스트의 변경 사항은 물론 메시지 내 다른 필드의 유무 또는 내용도 포함됩니다.
사용자 스크립트와 애플리케이션은 로깅 출력에 의존해서는 안 됩니다. 스크립트와 애플리케이션은 모니터링 API 를 사용하여 mongosync 의 현재 상태를 확인해야 합니다.
예시
다음 예는 각 유형의 버전 번호 업데이트로 인해 발생하는 변경 사항의 종류를 보여줍니다.
Major Releases(주요 릴리스)
mongosync의 신규 버전과 이전 버전을 변경하는 변경은 동일한 입력 세트에 대해 대상 cluster에서 다른 결과를 생성합니다. 제외:이전 버전의
mongosync가 데이터를 복제하지 못하는 경우에 대한 버그 수정.이전 동작이 지원되지 않는 것으로 명시적으로 문서화된 경우.
mongosync가 이전에 유효했던 입력을 거부하는 등 문서화된 Atlas CLI 매개변수 또는 구성 키가 변경되었습니다. 제외:구문 분석 또는 유형 오류와 같은 버그가 수정되었습니다.
Atlas CLI 매개변수 또는 구성 키는 더 이상 사용되지 않을 수 있지만, 문서화된 Atlas CLI 매개변수 또는 구성 키의 의미는 절대 변경되지 않습니다. 필요한 경우 더 이상 사용되지 않는 이전 엔터티를 새 매개 변수 또는 키로 대체합니다.
지원되는 버전의 MongoDB Server와의 호환성을 깨는 변경 사항입니다.
REST API 버전 삭제.
mongosync는 새 버전의 API를 위해 모든 이전 엔드포인트를 삭제할 수 있습니다. REST API에는 이전 버전과 호환되지 않는 다른 유형의 변경 사항이 절대 존재하지 않습니다.mongosync에서 해당 기능을 지원하는 MongoDB Server 버전을 계속 지원하는 경우 이전에 지원되었던 MongoDB Server 기능에 대한 지원을 제거합니다.mongosync에서 MongoDB Server의 주요 버전을 이미 지원하는 경우, 해당 버전의 MongoDB Server를 계속 지원하려면 새로운 권한이 필요한 변경 사항입니다.
마이너 릴리스
이전에 호환되지 않았던 MongoDB Server 버전에 대한 지원 추가.
이전에 지원되지 않았던 MongoDB Server의 주요 릴리스에 대해 새로운 권한이 필요합니다.
이전에 지원되지 않았던 컬렉션 유형에 대한 지원을 추가합니다.
이전에 지원되지 않는 인덱스 유형에 대한 지원 추가.
REST API에 새 엔드포인트, 새 필드 또는 허용되는 새 입력을 추가합니다.
문서화된 새로운 Atlas CLI 옵션 추가.
새 구성 키 또는 허용되는 값 추가.
패치 릴리스
이전 버전과 호환되는 버그 수정.
성능 회귀 수정.
성능 개선.
도움말 텍스트 문자열이 변경되었습니다.
로그 텍스트 문자열을 변경합니다.
API 응답의 정보 텍스트는 변경되지만 '상태'와 같은 열거형 스타일 문자열 필드는 변경되지 않습니다.
오타 수정.