Ejecutar Milvus en Docker (Windows)

Esta página muestra cómo ejecutar Milvus en Windows utilizando Docker Desktop para Windows.

Requisitos previos

• Instale Docker Desktop.

• Instale Windows Subsystem for Linux 2 (WSL 2).

• Instalar Python 3.8+.

Ejecutar Milvus en Docker

Milvus proporciona un script de instalación para instalarlo como un contenedor Docker. Una vez que haya instalado Docker Desktop en Microsoft Windows, puede acceder a la CLI de Docker desde PowerShell o Windows Command Prompt en modo administrador y desde WSL 2.

Desde PowerShell o Símbolo del sistema de Windows

Si estás más familiarizado con PowerShell o Símbolo del sistema de Windows, el símbolo del sistema es el siguiente.

1. Abra Docker Desktop en modo administrador haciendo clic con el botón derecho y seleccionando Ejecutar como administrador.

2. Descargue el script de instalación y guárdelo como standalone.bat.

   C:\>Invoke-WebRequest https://github.com/milvus-io/milvus/blob/master/scripts/standalone_embed.bat -OutFile standalone.bat
   
   

3. Ejecute el script descargado para iniciar Milvus como contenedor Docker.

   C:\>standalone.bat start
   Wait for Milvus starting...
   Start successfully.
   To change the default Milvus configuration, edit user.yaml and restart the service.
   
   

   Después de ejecutar el script de instalación.

   • Se ha iniciado un contenedor Docker llamado milvus-standalone en el puerto 19530.

   • Un embed etcd se instala junto con Milvus en el mismo contenedor y sirve en el puerto 2379. Su archivo de configuración se asigna a embedEtcd.yaml en la carpeta actual.

   • El volumen de datos de Milvus se asigna a volumes/milvus en la carpeta actual.

   Puede utilizar los siguientes comandos para gestionar el contenedor Milvus y los datos almacenados.

   # Stop Milvus
   C:\>standalone.bat stop
   Stop successfully.
   
   # Delete Milvus container
   C:\>standalone.bat delete
   Delete Milvus container successfully. # Container has been removed.
   Delete successfully. # Data has been removed.
   
   

Desde WSL 2

Si prefiere iniciar Milvus utilizando comandos Linux y shell scripts en Windows, asegúrese de que ya tiene instalado el comando WSL 2. Para más detalles sobre cómo instalar el comando WSL 2, puede consultar este artículo de Microsoft.

1. Inicie WSL 2.

   C:\>wsl --install
   Ubuntu already installed.
   Starting Ubuntu...
   
   

2. Descargue el script de instalación

   # Download the installation script
   $ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh
   
   # Start the Docker container
   $ bash standalone_embed.sh start
   
   

3. Inicie Milvus como un contenedor Docker.

   $ bash standalone_embed.sh start
   Wait for Milvus Starting...
   Start successfully.
   To change the default Milvus configuration, add your settings to the user.yaml file and then restart the service.
   
   

   Puede utilizar los siguientes comandos para gestionar el contenedor Milvus y los datos almacenados.

   # Stop Milvus
   $ bash standalone_embed.sh stop
   Stop successfully.
   
   # Delete Milvus data
   $ bash standalone_embed.sh stop
   Delete Milvus container successfully.
   Delete successfully.
   
   

Ejecutar Milvus con Docker Compose

Una vez que haya instalado Docker Desktop en Microsoft Windows, puede acceder a la CLI de Docker desde PowerShell o desde el símbolo del sistema de Windows en modo de administrador. Puede ejecutar Docker Compose en PowerShell, Símbolo del sistema de Windows o WSL 2 para iniciar Milvus.

Desde PowerShell o Símbolo del sistema de Windows

1. Abra Docker Desktop en modo administrador haciendo clic con el botón derecho y seleccionando Ejecutar como administrador.

2. Ejecute los siguientes comandos en PowerShell o Windows Command Prompt para descargar el archivo de configuración Docker Compose para Milvus Standalone e iniciar Milvus.

   # Download the configuration file and rename it as docker-compose.yml
   C:\>Invoke-WebRequest https://github.com/milvus-io/milvus/releases/download/v2.4.15/milvus-standalone-docker-compose.yml -OutFile docker-compose.yml
   
   # Start Milvus
   C:\>docker compose up -d
   Creating milvus-etcd  ... done
   Creating milvus-minio ... done
   Creating milvus-standalone ... done
   
   

   Dependiendo de su conexión de red, la descarga de imágenes para la instalación de Milvus puede tardar un poco. Una vez que los contenedores llamados milvus-standalone, milvus-minio, y milvus-etcd están arriba, puede ser testigo de que

   • El contenedor milvus-etcd no expone ningún puerto al host y mapea sus datos a volúmenes/etcd en la carpeta actual.

   • El contenedor milvus-minio sirve los puertos 9090 y 9091 localmente con las credenciales de autenticación predeterminadas y asigna sus datos a volumes/minio en la carpeta actual.

   • El contenedor milvus-standalone sirve los puertos 19530 localmente con la configuración por defecto y asigna sus datos a volumes/milvus en la carpeta actual.

También puede llamar a la versión Linux de los comandos Docker Compose si tiene WSL 2 instalado.

Desde WSL 2

El procedimiento es similar al uso de Docker Compose para instalar Milvus en sistemas Linux.

1. Inicie WSL 2.

   C:\>wsl --install
   Ubuntu already installed.
   Starting Ubuntu...
   
   

2. Descargue el archivo de configuración de Milvus.

   $ wget https://github.com/milvus-io/milvus/releases/download/v2.4.17/milvus-standalone-docker-compose.yml -O docker-compose.yml
   
   

3. Inicie Milvus.

   $ sudo docker compose up -d
   
   Creating milvus-etcd  ... done
   Creating milvus-minio ... done
   Creating milvus-standalone ... done
   
   

Preguntas frecuentes

¿Cómo puedo solucionar el error Docker Engine stopped?

Una vez que instale Docker Desktop en Windows, puede encontrarse con el error Docker Engine stopped si su equipo no está configurado correctamente. En este caso, puede que necesite realizar las siguientes comprobaciones.

1. Compruebe si la virtualización está activada.

   Puede comprobar si la virtualización está habilitada consultando la pestaña Rendimiento del Administrador de tareas.

   Virtualización en el Administrador de tareas

   Si la virtualización está deshabilitada, puede que necesites comprobar la configuración de la BIOS del firmware de tu placa base. La forma de habilitar la virtualización en la configuración de la BIOS varía según el fabricante de la placa base. Para la placa base ASUS, por ejemplo, puedes consultar este artículo sobre cómo habilitar la virtualización.

   A continuación, es necesario reiniciar el equipo y habilitar Hyper-V. Para más detalles, consulta este artículo de Microsoft.

2. Compruebe si se ha iniciado el servicio Docker Desktop.

   Puede ejecutar el siguiente comando para iniciar el servicio Docker Desktop.

   C:\>net start com.docker.service
   The Docker for Windows Service service is starting.
   The Docker for Windows Service service was started successfully.
   
   

3. Compruebe si WSL se ha instalado correctamente.

   Puede ejecutar el siguiente comando para instalar o actualizar el comando WSL 2.

   C:\>wsl --update
   Checking for updates.
   The most recent version of Windows Subsystem for Linux is already installed.
   
   

4. Compruebe si se ha iniciado Docker Daemon.

   Debe ir al directorio de instalación de Docker Desktop y ejecutar .\DockerCli.exe -SwitchDaemon para iniciar Docker Daemon.

   C:\>cd "C:\Program Files\Docker\Docker"
   C:\Program Files\Docker\Docker>.\DockerCli.exe -SwitchDaemon
   Switching to windows engine: Post "http://ipc/engine/switch": open \\.\pipe\dockerBackendApiServer: The system cannot find the file specified.
   
   

5. Compruebe si ha iniciado Docker Desktop en modo administrador.

   Asegúrese de que ha iniciado Docker Desktop en modo administrador. Para ello, haga clic con el botón derecho en Docker Desktop y seleccione Ejecutar como administrador.

   Iniciar Docker Desktop como administrador

¿Cómo puedo solucionar los problemas relacionados con WSL al desplegar Milvus?

Si ha encontrado problemas relacionados con WSL mientras ejecuta Milvus desde WSL 2, puede que necesite comprobar si ha configurado Docker Desktop para utilizar el motor basado en WSL 2 de la siguiente manera.

1. Asegúrese de que "Usar el motor basado en WSL 2" está marcado en Configuración > General.

   Utilizar el motor basado en WSL 2 en la configuración de Docker Desktop

2. Seleccione de entre sus distribuciones WSL 2 instaladas aquella en la que desea habilitar la integración con Docker yendo a: Configuración > Recursos > Integración WSL.

   Seleccione las distribuciones WSL 2 en la configuración de Docker Desktop .

¿Cómo puedo solucionar los errores relacionados con el volumen que aparecen durante el inicio de Milvus que lee Read config failed?

Error de lectura de configuración en el arranque de Milvus

Para solucionar el error que aparece durante el arranque de Milvus y que dice "Read config failed", debe comprobar si el volumen montado en el contenedor Milvus es correcto. Si el volumen está montado correctamente en el contenedor, puede utilizar el comando docker exec para entrar en el contenedor y listar la carpeta /milvus/configs como se indica a continuación.

Listar los archivos de configuración de Milvus