qdrant-version-upgrade について
Qdrant と SDK のバージョン更新を計画するためのガイダンススキルです。互換性、ストレージ移行、クラスタの可用性を扱い、Qdrant Cloud と qcloud CLI の情報も含みます。
主な機能
- 01Qdrant と SDK のバージョン互換性
- 02SDK とサーバーの更新順序
- 03ストレージ移行の段階的手順
- 04レプリカ構成でのローリング更新
- 05Qdrant Cloud と qcloud CLI の案内
活用シーン
- 01Qdrant と SDK の更新計画
- 02複数マイナーバージョンをまたぐ移行
- 03停止時間を避けたクラスタ更新
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ github/ awesome-copilot --skill qdrant-version-upgradeインストール後、Claude Code で/qdrant-version-upgradeを入力して読み込まれたか確認します。
詳細
Qdrant のバージョンアップグレード
Qdrant のバージョン互換性について、以下の保証があります。
-
Qdrant と SDK のメジャーバージョンおよびマイナーバージョンは一致していることが想定されています。たとえば、Qdrant 1.17.x は SDK 1.17.x と互換性があります。
-
Qdrant は、マイナーバージョン間の後方互換性についてテストされています。たとえば、Qdrant 1.17.x は SDK 1.16.x と互換性があるはずです。Qdrant サーバー 1.16.x も SDK 1.17.x と互換性があることが想定されていますが、1.16.x で利用可能だった機能に限られます。
-
次のマイナーバージョンへ移行する場合は、まず SDK を次のマイナーバージョンにアップグレードし、その後 Qdrant サーバーをアップグレードすることをおすすめします。
-
ストレージの互換性は、1 つのマイナーバージョン間でのみ保証されます。たとえば、Qdrant 1.16.x で保存されたデータは、Qdrant 1.17.x と互換性があることが想定されています。複数のマイナーバージョンをまたいで移行する場合は、マイナーバージョンごとに段階的にアップグレードする必要があります。たとえば、1.15.x から 1.17.x に移行するには、まず 1.16.x にアップグレードしてから 1.17.x にアップグレードする必要があります。注:Qdrant Cloud ではこのプロセスが自動化されているため、中間の手順を挟まずに 1.15.x から 1.17.x に直接アップグレードできます。
-
レプリケーション係数が 2 以上の Qdrant クラスターは、ローリングアップグレードを実施することで、ダウンタイムなしでアップグレードできます。つまり、ほかのノードがリクエストを処理し続けている間に、ノードを 1 つずつアップグレードできます。これにより、アップグレード中もアプリケーションの可用性を維持できます。レプリケーション係数の詳細:レプリケーション係数
Qdrant Cloud で Qdrant のバージョンアップグレードを管理するには、qcloud CLI ツールを使用できます。