Actualización de Milvus independiente con Docker Compose
Esta guía describe cómo actualizar una implementación independiente de Milvus 2.6.x a la versión 3.0.1 con Docker Compose.
Este procedimiento se ha validado con la configuración oficial de Docker Compose para Milvus 2.6.20 independiente. La actualización conservó etcd, MinIO, Woodpecker y los directorios de datos existentes, y solo cambió la imagen de Milvus a milvusdb/milvus:v3.0.1.
Requisitos previos
- Docker Engine y Docker Compose V2
- Una implementación independiente existente de Milvus 2.6.x gestionada por Docker Compose
- El archivo Docker Compose y la configuración utilizados para la implementación existente
- Una copia de seguridad actualizada de los metadatos y los datos persistentes de Milvus
Limitaciones de la cola de mensajes: al actualizar a Milvus v3.0.1, debes mantener tu elección actual de cola de mensajes. No se admite el cambio entre diferentes sistemas de colas de mensajes durante la actualización. La compatibilidad con el cambio de sistemas de colas de mensajes estará disponible en futuras versiones.
No sustituya su archivo Compose actual ni modifique las versiones de las dependencias como parte de este procedimiento. Mantenga el etcd, el almacenamiento de objetos, la cola de mensajes, los volúmenes y la configuración existentes. Actualice únicamente la etiqueta de la imagen de Milvus.
Este procedimiento no valida una degradación o una reversión que implique volver a la imagen de Milvus 2.6.x. Una vez que la v3.0.1 haya escrito datos, una reversión que afecte únicamente a la imagen podría no leer correctamente el estado actualizado. Si la actualización falla, detén las escrituras y utiliza un plan de recuperación que restaure los metadatos previos a la actualización y las copias de seguridad de los datos persistentes. Valida primero el plan de recuperación en un entorno que no sea de producción.
Proceso de actualización
Paso 1: Realizar una copia de seguridad de la configuración actual
Guarde una copia del archivo Compose actual y de cualquier archivo de configuración de Milvus montado:
cp docker-compose.yml docker-compose-before-upgrade.yml
Comprueba que los contenedores actuales estén en buen estado antes de iniciar la actualización:
docker compose ps
Paso 2: Actualizar la imagen de Milvus
En el archivo Compose existente, actualiza únicamente la imagen del servicio « standalone »:
services:
standalone:
image: milvusdb/milvus:v3.0.1
Descarga la imagen de destino y vuelve a crear únicamente el contenedor de Milvus:
docker compose pull standalone
docker compose up --detach standalone
Docker Compose mantiene en ejecución los contenedores existentes de etcd y de almacenamiento de objetos, y reutiliza los directorios de datos configurados.
Verifica la actualización
Comprueba el estado del contenedor y la imagen utilizada por el contenedor de Milvus:
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
Comprueba que el servicio standalone esté en buen estado, que su imagen sea milvusdb/milvus:v3.0.1 y que las colecciones existentes sigan siendo consultables y buscables. Realiza estas comprobaciones antes de habilitar cualquier función específica de la versión 3.0.1.
