About qdrant-version-upgrade
A guidance skill for planning Qdrant and SDK version upgrades, including compatibility, storage migration, and cluster availability. It is intended for teams operating Qdrant, with Qdrant Cloud and qcloud CLI details included.
Key features
- 01Qdrant と SDK のバージョン互換性
- 02SDK とサーバーの更新順序
- 03ストレージ移行の段階的手順
- 04レプリカ構成でのローリング更新
- 05Qdrant Cloud と qcloud CLI の案内
Use cases
- 01Qdrant と SDK の更新計画
- 02複数マイナーバージョンをまたぐ移行
- 03停止時間を避けたクラスタ更新
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ github/ awesome-copilot --skill qdrant-version-upgradeAfter installing, type/qdrant-version-upgradein Claude Code to confirm it loaded.
Details
From the project READMEQdrant Version Upgrade
Qdrant has the following guarantees about version compatibility:
-
Major and minor versions of Qdrant and SDK are expected to match. For example, Qdrant 1.17.x is compatible with SDK 1.17.x.
-
Qdrant is tested for backward compatibility between minor versions. For example, Qdrant 1.17.x should be compatible with SDK 1.16.x. Qdrant server 1.16.x is also expected to be compatible with SDK 1.17.x, but only for the subset of features that were available in 1.16.x.
-
For migration to the next minor version, it is recommended to first upgrade the SDK to the next minor version and then upgrade the Qdrant server.
-
Storage compatibility is only guaranteed for one minor version. For example, data stored with Qdrant 1.16.x is expected to be compatible with Qdrant 1.17.x. If you need to migrate more than one minor version, it is required do the upgrade step by step, one minor version at a time. For example, to migrate from 1.15.x to 1.17.x, you need to first upgrade to 1.16.x and then to 1.17.x. Note: Qdrant Cloud automates this process, so you can directly upgrade from 1.15.x to 1.17.x without intermediate steps.
-
A Qdrant cluster with a replication factor of 2 or higher can be upgraded without downtime by performing a rolling upgrade. This means that you can upgrade one node at a time while the other nodes continue to serve requests. This allows you to maintain availability of your application during the upgrade process. More about replication factor: Replication factor
For managing Qdrant version upgrades in Qdrant Cloud, you can use the qcloud CLI tool.