Upgrade von Milvus Standalone mit Docker Compose
In dieser Anleitung wird beschrieben, wie Sie eine Milvus 2.6.x-Standalone-Bereitstellung mit Docker Compose auf Version 3.0.1 aktualisieren.
Dieses Verfahren wurde mit der offiziellen Milvus 2.6.20 Standalone-Docker-Compose-Konfiguration getestet. Bei der Aktualisierung blieben etcd, MinIO, Woodpecker und die vorhandenen Datenverzeichnisse erhalten; lediglich das Milvus-Image wurde auf „ milvusdb/milvus:v3.0.1 “ geändert.
Voraussetzungen
- Docker Engine und Docker Compose V2
- Eine bestehende Milvus 2.6.x-Standalone-Bereitstellung, die von Docker Compose verwaltet wird
- Die für die bestehende Bereitstellung verwendete Docker-Compose-Datei und -Konfiguration
- Ein aktuelles Backup der Milvus-Metadaten und der persistenten Daten
Einschränkungen bei der Nachrichtenwarteschlange: Beim Upgrade auf Milvus v3.0.1 müssen Sie Ihre aktuelle Wahl der Nachrichtenwarteschlange beibehalten. Ein Wechsel zwischen verschiedenen Nachrichtenwarteschlangensystemen während des Upgrades wird nicht unterstützt. Die Unterstützung für den Wechsel des Nachrichtenwarteschlangensystems wird in zukünftigen Versionen verfügbar sein.
Ersetzen Sie im Rahmen dieses Vorgangs nicht Ihre aktuelle Compose-Datei und ändern Sie keine Abhängigkeitsversionen. Behalten Sie das vorhandene etcd, den Objektspeicher, die Nachrichtenwarteschlange, die Volumes und die Konfiguration bei. Aktualisieren Sie lediglich den Milvus-Image-Tag.
Dieses Verfahren validiert kein Downgrade oder Rollback durch die Rückführung des Milvus-Images auf 2.6.x. Nachdem v3.0.1 Daten geschrieben hat, kann es bei einem reinen Image-Rollback vorkommen, dass der aktualisierte Zustand nicht gelesen werden kann. Wenn das Upgrade fehlschlägt, stoppen Sie Schreibvorgänge und wenden Sie einen Wiederherstellungsplan an, der die Metadaten und die Backups der persistenten Daten aus der Zeit vor dem Upgrade wiederherstellt. Testen Sie den Wiederherstellungsplan zunächst in einer Nicht-Produktionsumgebung.
Upgrade-Prozess
Schritt 1: Sichern Sie die aktuelle Konfiguration
Speichern Sie eine Kopie der aktuellen Compose-Datei und aller eingebundenen Milvus-Konfigurationsdateien:
cp docker-compose.yml docker-compose-before-upgrade.yml
Stellen Sie vor Beginn des Upgrades sicher, dass die aktuellen Container fehlerfrei sind:
docker compose ps
Schritt 2: Milvus-Image aktualisieren
Aktualisieren Sie in der vorhandenen Compose-Datei nur das Image für den Dienst „ standalone “:
services:
standalone:
image: milvusdb/milvus:v3.0.1
Laden Sie das Ziel-Image herunter und erstellen Sie nur den Milvus-Container neu:
docker compose pull standalone
docker compose up --detach standalone
Docker Compose hält die vorhandenen etcd- und Object-Storage-Container am Laufen und verwendet die konfigurierten Datenverzeichnisse weiter.
Überprüfen Sie das Upgrade
Überprüfen Sie den Containerstatus und das vom Milvus-Container verwendete Image:
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
Stellen Sie sicher, dass der Dienst „ standalone “ ordnungsgemäß funktioniert, sein Image „ milvusdb/milvus:v3.0.1 “ lautet und die vorhandenen Sammlungen weiterhin abfragbar und durchsuchbar sind. Führen Sie diese Überprüfungen durch, bevor Sie v3.0.1-spezifische Funktionen aktivieren.
