Cluster-to-Cluster Sync で使用 セマンティック バージョン管理2.0.0 。バージョン番号の形式はX.Y.Zで、 Xはメジャー バージョン、 Yはマイナー バージョン、 Zはパッチのバージョンです。
MongoDB は、次のガイドラインを使用して、Cluster-to-Cluster Sync のバージョン番号を増やすタイミングを決定します。
メジャー番号: このリリースは下位互換性を損なう。
マイナー番号: このリリースには、下位互換性のある重要な新機能が含まれています。
パッチ番号: このリリースには、下位互換性のある小さな変更のみが含まれています。
現在サポートされているバージョン
MongoDB は各メジャー バージョンの最新のパッチ リリースのみをサポートしています。 たとえば、 mongosync 1.15.0は1.15の最新のパッチ リリースです。 サポートされていないバージョンの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.4 がリリースされるまで、バージョン 1.3 は引き続きパッチを受信します。
アップグレードまたはダウングレード
注意
mongosync は、v1.12 から v1.13 へのライブ アップグレードをサポートしています。
mongosync をアップグレードまたはダウングレードするには、次の手順に従います。
現在実行中のすべての
mongosyncプロセスを停止します。宛先クラスター内のすべての非システム データベースを削除します。
新しい
mongosyncバイナリをインストールします。新しいバイナリを使用して
mongosyncプロセスを開始します。
警告
新しいmongosyncプロセスでは、進行中の可能性のある作業は再開されません。 新しいプロセスを開始すると、同期操作は最初から再開されます。
永続的メタデータ
通常の操作中に、 mongosyncは宛先データベースのディスクに永続化されるメタデータを作成します。 このメタデータはバージョン管理されておらず、いつでも変更される可能性があります。
ログ メッセージ
ログ メッセージの形式はバージョン管理されておらず、いつでも変更される可能性があります。 これには、メッセージテキストの変更だけでなく、メッセージ内の他のフィールドの存在、不在、または内容の変更が含まれます。
ユーザー スクリプトとアプリケーションはログ出力に依存すべきではありません。 スクリプトとアプリケーションは、モニタリング APIを使用して、 mongosyncの現在の状態を判断する必要があります。
例
次の例は、各タイプのバージョン番号更新につながる変更の種類を示しています。
メジャー リリース
mongosyncの新しいバージョンと古いバージョンで同じ入力セットの宛先クラスターで異なる結果が生じます。 ただし、mongosyncの古いバージョンがデータのレプリケートに失敗する場合のバグ修正。前の動作がサポートされていないことが明示的にドキュメント化されている場合。
ドキュメント化された CLI パラメータまたは構成キーを変更して、
mongosyncが以前は有効だった入力を拒否するようにします。 ただし、やタイプ エラーの解析などのバグ修正。
CLI パラメーターまたは構成キーは非推奨になる場合でも、文書化された CLI パラメーターや構成キーの意味は変更されません。 必要に応じて、新しいパラメータまたはキーが、古い、非推奨のエンティティを置き換えます。
MongoDB Server のサポートされているバージョンとの互換性を損なう変更。
REST API のバージョンを削除します。
mongosyncは、新しいバージョンの API を優先するために、古いエンドポイントをすべて削除する可能性があります。 REST API では、これ以外のタイプの下位互換性のない変更は存在しません。以前にサポートされていた MongoDB Server 機能のサポートを、
mongosyncが引き続き機能をサポートするバージョンの MongoDB Server をサポートしている場合、廃止します。mongosyncがすでに MongoDB Server のメジャー バージョンをサポートしている場合、そのバージョンの MongoDB Server を引き続きサポートするために新しいアクセス特権を必要とする変更。
マイナー リリース
以前は互換性のなかった MongoDB Server バージョンのサポートを追加します。
以前はサポートされていない MongoDB Server のメジャー リリースに新しいアクセス特権が必要です。
以前はサポートされていないコレクション タイプのサポートを追加しました。
以前はサポートされていないインデックス タイプのサポートを追加しました。
REST API に新しいエンドポイント、新しいフィールド、または新しく許容された入力を追加します。
新しいドキュメント化された CLI オプションを追加しました。
新しい構成キーまたは許容値の追加。
パッチ リリース
下位互換性のあるバグ修正。
パフォーマンス回帰の問題を修正しました。
パフォーマンスの向上。
テキスト string をヘルプする変更。
ログ テキスト string の変更。
API レスポンスの情報テキストは変更されますが、"date" のような列挙形式の string フィールドは変更されません。
誤字を修正しました