Обновление автономной версии Milvus с помощью Docker Compose
В данном руководстве описано, как обновить автономную установку Milvus 2.6.x до версии v3.0.1 с помощью Docker Compose.
Эта процедура проверена на официальной конфигурации автономной версии Milvus 2.6.20 для Docker Compose. В ходе обновления были сохранены etcd, MinIO, Woodpecker и существующие каталоги данных, а изменен был только образ Milvus на milvusdb/milvus:v3.0.1.
Необходимые условия
- Docker Engine и Docker Compose V2
- Существующий автономный дистрибутив Milvus 2.6.x, управляемый с помощью Docker Compose
- Файл Docker Compose и конфигурация, используемые для существующей развертки
- Актуальная резервная копия метаданных и постоянных данных Milvus
Ограничения, связанные сочередью сообщений: при обновлении до Milvus v3.0.1 необходимо сохранить текущий выбор системы очереди сообщений. Переключение между различными системами очередей сообщений во время обновления не поддерживается. Поддержка смены систем очередей сообщений будет доступна в будущих версиях.
Не заменяйте текущий файл Compose и не изменяйте версии зависимостей в рамках этой процедуры. Сохраните существующие etcd, объектное хранилище, очередь сообщений, тома и конфигурацию. Обновите только тег образа Milvus.
Данная процедура не предусматривает переход на более раннюю версию или откат с возвратом образа Milvus к версии 2.6.x. После того как версия v3.0.1 запишет данные, откат, выполняемый только для образа, может не смочь прочитать обновлённое состояние. Если обновление завершится неудачей, остановите запись данных и воспользуйтесь планом восстановления, который восстанавливает метаданные, существовавшие до обновления, и резервные копии постоянных данных. Сначала проверьте план восстановления в тестовой среде.
Процесс обновления
Шаг 1: Сделайте резервную копию текущей конфигурации
Сохраните копию текущего файла Compose и всех смонтированных файлов конфигурации Milvus:
cp docker-compose.yml docker-compose-before-upgrade.yml
Перед началом обновления убедитесь, что текущие контейнеры находятся в рабочем состоянии:
docker compose ps
Шаг 2: Обновите образ Milvus
В существующем файле Compose обновите только образ для службы « standalone »:
services:
standalone:
image: milvusdb/milvus:v3.0.1
Загрузите целевой образ и пересоздайте только контейнер Milvus:
docker compose pull standalone
docker compose up --detach standalone
Docker Compose сохраняет работу существующих контейнеров etcd и object-storage и повторно использует настроенные каталоги данных.
Проверьте обновление
Проверьте состояние контейнера и образ, используемый контейнером Milvus:
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
Убедитесь, что служба standalone работает исправно, её образ — milvusdb/milvus:v3.0.1, а существующие коллекции по-прежнему доступны для запросов и поиска. Выполните эти проверки, прежде чем включать какие-либо функции, специфичные для версии v3.0.1.
