mongosync バージョン管理
項目一覧
Cluster-to-Cluster Sync で使用 セマンティック バージョン管理2.0.0 。バージョン番号の形式はX.Y.Zで、 Xはメジャー バージョン、 Yはマイナー バージョン、 Zはパッチのバージョンです。
MongoDB は、次のガイドラインを使用して、Cluster-to-Cluster Sync のバージョン番号を増やすタイミングを決定します。
メジャー番号: このリリースは下位互換性を損なう。
マイナー番号: このリリースには、下位互換性のある重要な新機能が含まれています。
パッチ番号: このリリースには、下位互換性のある小さな変更のみが含まれています。
現在サポートされているバージョン
MongoDB は各メジャー バージョンの最新のパッチ リリースのみをサポートしています。 たとえば、 mongosync 1.9.0は1.9の最新のパッチ リリースです。 サポートされていないバージョンの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 は引き続きパッチを受信します。
ライブアップグレード
バージョン 1.7.0 の新機能。
mongosync 1.7.0以降、 データ同期操作を最初から再開せずにmongosyncをアップグレードできます。 mongosync 1からmongosync 1.7.3以降へのライブ アップグレードのみが可能です。 7 。 2 以降に更新します。
ライブ アップグレード後、 mongosyncはアップグレード前に進行中であった操作を続行します。
ライブアップグレードmongosyncを実行するには、次の手順を実行します。
（オプション）mongosync プロセスを一時停止します
mongosyncを一時停止するには、実行中の 各mongosyncプロセスで pauseを実行します。
最後のステップに示すように、一時停止状態から後でmongosyncプロセスを再開できます。
Tip
ライブ アップグレード後にデータ同期操作をすぐに再開したくない場合は、 mongosyncプロセスを一時停止することを検討してください。 これは、複数のmongosyncプロセスからの操作を調整する場合に便利です。
新しい バイナリをダウンロードしてインストールmongosync
新しいmongosyncバイナリをダウンロードしてインストールするには、「 mongosync のダウンロードとインストール 」を参照してください。
プロセスを初期化mongosync
mongosyncプロセスを初期化するには、「クイックスタート」を参照してください。 ライブ アップグレード後の初期化中に、 mongosyncは永続的なメタデータをアップデートします。
プロセスを再開するmongosync
任意の最初のステップの前半で任意のmongosyncプロセスを一時停止した場合は、すべてのmongosyncプロセスでresumeを実行します。
ライブ アップグレードの前にデータ同期操作がすでに進行中であった場合、最新のmongosyncバージョンで追加された新機能は、ライブ アップグレード後にすべてサポートされなくなる可能性があります。 パフォーマンスの向上とバグ修正は、ライブ アップグレード後も常にサポートされます。 ライブ アップグレード後にサポートされる可能性のある新機能の詳細については、 1.7.0 リリース を参照してください。
非ライブアップグレードまたはダウングレード
ライブ アップグレード手順でサポートされていない以前のバージョンのmongosyncを使用している場合、または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 フィールドは変更されません。
誤字を修正しました