Executar o Milvus no Docker (Windows)

Esta página demonstra como executar o Milvus no Windows usando o Docker Desktop para Windows.

Pré-requisitos

• Instalar o Docker Desktop.

• Instalar o Subsistema Windows para Linux 2 (WSL 2).

• Instalar o Python 3.8+.

Executar o Milvus no Docker

O Milvus fornece um script de instalação para instalá-lo como um contêiner do Docker. Depois de instalar o Docker Desktop no Microsoft Windows, pode aceder ao Docker CLI a partir do PowerShell ou do Windows Command Prompt em modo de administrador e do WSL 2.

A partir do PowerShell ou do prompt de comando do Windows

Se estiver mais familiarizado com o PowerShell ou o Prompt de Comando do Windows, o prompt de comando é o seguinte.

1. Abra o Docker Desktop no modo de administrador clicando com o botão direito do rato e selecionando Executar como administrador.

2. Descarregue o script de instalação e guarde-o como standalone.bat.

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

3. Execute o script descarregado para iniciar o Milvus como um contentor Docker.

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

   Depois de executar o script de instalação.

   • Um contentor Docker chamado milvus-standalone foi iniciado na porta 19530.

   • Um etcd incorporado é instalado juntamente com o Milvus no mesmo contentor e serve na porta 2379. O seu ficheiro de configuração é mapeado para embedEtcd.yaml na pasta atual.

   • O volume de dados do Milvus é mapeado para volumes/milvus na pasta atual.

   Pode utilizar os seguintes comandos para gerir o contentor Milvus e os dados armazenados.

   # 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.
   
   

A partir do WSL 2

Se preferir iniciar o Milvus utilizando comandos Linux e scripts shell no Windows, certifique-se de que já instalou o comando WSL 2. Para obter detalhes sobre como instalar o comando WSL 2, pode consultar este artigo da Microsoft.

1. Iniciar o WSL 2.

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

2. Descarregar o script de instalação

   # 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 o Milvus como um contentor 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.
   
   

   Pode utilizar os seguintes comandos para gerir o contentor do Milvus e os dados armazenados.

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

Executar o Milvus com o Docker Compose

Depois de ter instalado o Docker Desktop no Microsoft Windows, pode aceder ao Docker CLI a partir do PowerShell ou do Prompt de Comando do Windows em modo de administrador. É possível executar o Docker Compose no PowerShell, no Prompt de Comando do Windows ou no WSL 2 para iniciar o Milvus.

No PowerShell ou no prompt de comando do Windows

1. Abra o Docker Desktop no modo de administrador clicando com o botão direito do rato e selecionando Executar como administrador.

2. Execute os seguintes comandos no PowerShell ou no prompt de comando do Windows para baixar o arquivo de configuração do Docker Compose para o Milvus Standalone e iniciar o 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
   
   

   Dependendo da sua ligação de rede, a transferência de imagens para a instalação do Milvus pode demorar algum tempo. Assim que os contentores com os nomes milvus-standalone, milvus-minio e milvus-etcd estiverem a funcionar, pode verificar que

   • O contentor milvus-etcd não expõe quaisquer portas ao anfitrião e mapeia os seus dados para volumes/etcd na pasta atual.

   • O contentor milvus-minio serve as portas 9090 e 9091 localmente com as credenciais de autenticação predefinidas e mapeia os seus dados para volumes/minio na pasta atual.

   • O contentor milvus-standalone serve as portas 19530 localmente com as predefinições e mapeia os seus dados para volumes/milvus na pasta atual.

Também pode chamar a versão Linux dos comandos do Docker Compose se tiver a WSL 2 instalada.

A partir da WSL 2

O procedimento é semelhante ao uso do Docker Compose para instalar o Milvus em sistemas Linux.

1. Inicie o WSL 2.

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

2. Baixe o arquivo de configuração do Milvus.

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

3. Inicie o Milvus.

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

Perguntas frequentes

Como posso lidar com o erro Docker Engine stopped?

Depois de instalar o Docker Desktop no Windows, poderá encontrar o erro Docker Engine stopped se o seu computador não estiver configurado corretamente. Nesse caso, pode ser necessário fazer as seguintes verificações.

1. Verificar se a virtualização está activada.

   Pode verificar se a virtualização está activada consultando o separador Desempenho no Gestor de Tarefas.

   Virtualização no Gerenciador de Tarefas

   Se a virtualização estiver desactivada, poderá ser necessário verificar as definições da BIOS do firmware da placa-mãe. A maneira de ativar a virtualização nas configurações do BIOS varia de acordo com os fornecedores de placas-mãe. Para a placa-mãe ASUS, por exemplo, pode consultar este artigo sobre como ativar a virtualização.

   Em seguida, é necessário reiniciar o computador e ativar o Hyper-V. Para obter detalhes, consulte este artigo da Microsoft.

2. Verifique se o Docker Desktop Service foi iniciado.

   Pode executar o seguinte comando para iniciar o Docker Desktop Service.

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

3. Verifique se o WSL foi instalado corretamente.

   Pode executar o seguinte comando para instalar ou atualizar o comando WSL 2.

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

4. Verifique se o Docker Daemon foi iniciado.

   É necessário ir ao diretório de instalação do Docker Desktop e executar .\DockerCli.exe -SwitchDaemon para iniciar o 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. Verifique se iniciou o Docker Desktop no modo de administrador.

   Certifique-se de que iniciou o Docker Desktop no modo de administrador. Para o fazer, clique com o botão direito do rato no Docker Desktop e selecione Executar como administrador.

   Iniciar o Docker Desktop como administrador

Como posso lidar com problemas relacionados com a WSL durante a implementação do Milvus?

Se encontrou problemas relacionados com a WSL enquanto executava o Milvus a partir da WSL 2, poderá ter de verificar se configurou o Docker Desktop para utilizar o motor baseado na WSL 2 da seguinte forma.

1. Certifique-se de que a opção "Usar o mecanismo baseado na WSL 2" está marcada em Configurações > Geral.

   Usar o mecanismo baseado em WSL 2 em Configurações do Docker Desktop

2. Selecione, de entre as distribuições WSL 2 instaladas, aquela em que pretende ativar a integração do Docker, acedendo a: Configurações > Recursos > Integração WSL.

   Selecione as distribuições WSL 2 nas definições do ambiente de trabalho Docker

Como posso lidar com os erros relacionados com o volume apresentados durante o arranque do Milvus que lê Read config failed?

Aviso de erro de falha de configuração de leitura no arranque do Milvus

Para lidar com o erro apresentado durante o arranque do Milvus que diz "Read config failed" (Falha na leitura da configuração), é necessário verificar se o volume montado no contentor do Milvus está correto. Se o volume estiver corretamente montado no contentor, pode utilizar o comando docker exec para entrar no contentor e listar a pasta /milvus/configs da seguinte forma.

Listar ficheiros de configuração do Milvus