Mongosync uses Semantic Versioning 2.0.0. Version numbers have the form X.Y.Z, where X is the major version, Y is the minor version, and Z is the patch version.
MongoDB は、次のガイドラインを使用して、Mongosync のバージョン番号を増やすタイミングを決定します。
メジャー番号: このリリースは下位互換性を損なう。
マイナー番号: このリリースには、下位互換性のある重要な新機能が含まれています。
パッチ番号: このリリースには、下位互換性のある小さな変更のみが含まれています。
現在サポートされているバージョン
MongoDB は各メジャー バージョンの最新のパッチ リリースのみをサポートしています。 たとえば、 mongosync 1.13.0は1.13の最新のパッチ リリースです。 サポートされていないバージョンのmongosyncを使用している場合は、サポートを受けるためにアップグレードを求められる場合があります。
バージョン関連の考慮事項
Mongosync には、バージョンに関連する次の考慮事項があります。
サポートライフサイクル
メジャー リリースは、そのシリーズの最初のリリースから少なくとも 1 年間サポートされます。
Mongosync のバージョンがサポート対象外のバージョンのMongoDB Serverでのみ動作する場合、そのバージョンの Mongosync もサポート対象外になります。
パッチ リリース
新しいパッチ リリースは、各メジャー リリース シリーズの最新バージョンにのみ適用されます。例、バージョン Mongosync 2.1.0 がリリースされると、バージョン 2.0 はパッチのリリースを受信しなくなります。同時に、バージョン 1.3 は、バージョン 1.4 がリリースされるまで、引き続きパッチを受信し続けます。
ライブ アップグレード
バージョン 1.7.0 の新機能。
mongosync 1.7.0 以降、データ同期操作を最初から再開せずに mongosync をアップグレードできます。
重要
mongosync では、すべてのバージョンへのライブアップグレードをサポートしていません。特定のバージョンへのライブ アップグレードができるかどうかを確認するには、そのバージョンの リリースノートを確認し、「ライブ アップグレード」セクションを参照してください。
ライブ アップグレード後、 mongosyncはアップグレード前に進行中であった操作を続行します。
ライブアップグレードmongosyncを実行するには、次の手順を実行します。
（オプション）mongosync プロセスを一時停止します
mongosyncを一時停止するには、実行中の各mongosyncプロセスでpauseを実行します。
最後のステップに示すように、一時停止状態から後でmongosyncプロセスを再開できます。
Tip
ライブ アップグレード後にデータ同期操作をすぐに再開したくない場合は、 mongosyncプロセスを一時停止することを検討してください。 これは、複数のmongosyncプロセスからの操作を調整する場合に便利です。
新しい バイナリをダウンロードしてインストールmongosync
新しいmongosyncバイナリをダウンロードしてインストールするには、「 mongosync のダウンロードとインストール 」を参照してください。
プロセスを初期化mongosync
mongosyncプロセスを初期化するには、「クイックスタート」を参照してください。 ライブ アップグレード後の初期化中に、 mongosyncは永続的なメタデータをアップデートします。
プロセスを再開するmongosync
任意の最初のステップの前半で任意のmongosyncプロセスを一時停止した場合は、すべてのmongosyncプロセスでresumeを実行します。
ライブ アップグレードの前にデータ同期操作がすでに進行中であった場合、最新の 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 フィールドは変更されません。
誤字を修正しました