Mongoid のアップグレード

項目一覧

Mongoid は、新しいバージョンに移行するユーザーのための安定したアップグレードパスを提供します。

バージョン管理

各 Mongoid リリースには、 major.minor.patch形式のバージョン番号があります。 Mongoid 7.4以降、 Mongoid はセマンティックバージョン管理（SemVer）を使用しますは、通常、次のことを意味します。

重大な変更、新機能の有効化、非推奨機能の削除は、メジャーバージョンリリースでのみ行われます。
新しい機能は機能フラグを使用して追加されます。このフラグは、オプトイン構成の変更によって有効にする必要があります。これらの機能フラグは、メジャーリリースまたはマイナーリリースのいずれかで追加される可能性があります。
機能は、メジャーリリースまたはマイナーリリースで非推奨としてマークされる場合がありますが、少なくとも次のメジャーリリースまで機能は削除されません。
パッチバージョンリリースには、重大じゃない修正とセキュリティ更新のみが含まれます。

Mongoid 7.3以前とこれらのバージョンにアップグレードする際には、さらに注意が必要です。

テスト範囲:アップグレード後もアプリケーションが引き続き動作することを確認する最良の方法は、プロセスを開始する前に適切なテストカバレッジを確保することです。
Ruby と Rails をアップグレードする: 「Rails で Ruby をアップグレードする」を参照してください詳細については、

以下は、新しい Mongoid バージョンにアップグレードするための推奨手順の概要です。

各マイナーバージョンに個別にアップグレードします。
たとえば、Mongoid 7.4から8.1にアップグレードする場合、各マイナーバージョンの最新のパッチバージョンについて次の手順に従うことをお勧めします。例: 最初は7.5 .x に、次に8.0 .x に、最後に8.1 .x に設定します。
アップグレードする前に、 load_defaultsが現在のバージョンに設定されていることを確認してください。
現在のバージョンで最新の動作を有効にしていない場合は、アップグレードする前に有効にする必要があります。
アップグレードする際には、リリースノートを慎重に確認してください。
新しいバージョンでアプリをテストします。
アプリは、 load_defaultsまたは機能フラグを調整せずに、新しい Mongoid バージョンで「そのまま」でテストおよびリリースする必要があります。
ステップ4が安定していることが確認されたら、 load_defaultsを新しいバージョンに設定して新しい機能を有効にします。この時点で非推奨警告も修正します。
機能フラグを使用して、新しい機能を 1 つずつ有効にすることもできます。

機能フラグが導入されると、以前の（レガシー）機能を保持するデフォルト値になります。現時点では、ユーザーは、新しい機能を試すために、フラグを新しい値に手動で設定することをお勧めします。

次のメジャーバージョンリリースでは、フラグのデフォルト値が反転され、新しい機能が有効になります。この時点で、フラグ自体は非推奨としてマークされます。最後に、非推奨フラグは、その後のメジャーバージョンリリースで構成から完全に削除されます。

機能フラグはアップグレードを容易にするために追加されていますが、永続的にサポートされることを意図したものではありません。

Mongoid は、機能、機能、メソッド、定数などを時々非推奨にする可能性があります。そのために、Mongoid は次のアクションの 1 つ以上を実行する可能性があります。

Mongoid は、次のメジャーバージョンリリースで非推奨の機能を削除する可能性があります。

@api privateでマークされたメソッドは、Ruby でpublicであっても非推奨なしに削除される場合があります。

戻る

リリースノート

Mongoid 9.0