Executar o Milvus no Docker (Linux)
Esta página explica como iniciar uma instância do Milvus no Docker.
Pré-requisitos
- Instale o Docker.
- Verifique os requisitos de hardware e software antes da instalação.
Instalar o Milvus no Docker
O Milvus fornece um script de instalação para o instalar como um contentor Docker. O script está disponível no repositório do Milvus. Descarregue e verifique o script antes de iniciar uma nova implementação:
# Download the installation script
$ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh
# Inspect the Docker image selected by the script
$ grep -n "milvusdb/milvus:" standalone_embed.sh
# Start the Docker container
$ bash standalone_embed.sh start
O script é descarregado a partir do ramo « master » do Milvus. A etiqueta da imagem do Docker está definida no script e pode diferir da v3.0.5. Para instalar essa versão específica, utilize a configuração com versão indicada em «Executar o Milvus com o Docker Compose».
Esta implementação do Docker executa o Woodpecker com o sistema de ficheiros local como backend WAL, pelo que não é necessário qualquer serviço externo de fila de mensagens. Consulte Woodpecker.
Se pretender utilizar o Backup no modo de implementação autónoma, recomenda-se a utilização do método de implementação Docker Compose.
Se tiver alguma dificuldade ao descarregar a imagem, contacte-nos através do endereço community@zilliz.com com detalhes sobre o problema e iremos prestar-lhe o apoio necessário.
Após executar o script de instalação:
- Foi iniciado um contentor Docker denominado milvus-standalone na porta 19530.
- Um etcd incorporado está instalado juntamente com o Milvus no mesmo contentor e funciona na porta 2379. O seu ficheiro de configuração está mapeado para embedEtcd.yaml na pasta atual.
- Para alterar a configuração predefinida do Milvus, adicione as suas definições ao ficheiro user.yaml na pasta atual e, em seguida, reinicie o serviço.
- O volume de dados do Milvus está mapeado para volumes/milvus na pasta atual.
Verifique a imagem atual e o estado de integridade:
docker inspect --format '{{.Config.Image}}' milvus-standalone
docker inspect --format '{{.State.Health.Status}}' milvus-standalone
Aguarde até que o healthy esteja disponível antes de seguir o Guia de Início Rápido. Ao utilizar este servidor, ligue o SDK a http://localhost:19530; uma URI local .db inicia, em vez disso, o Milvus Lite.
Pode aceder à interface Web do Milvus em http://127.0.0.1:9091/webui/ para saber mais sobre a sua instância do Milvus. Para mais detalhes, consulte a interface Web do Milvus.
(Opcional) Atualizar as configurações do Milvus
Pode modificar as configurações do Milvus no ficheiro user.yaml na pasta atual. Por exemplo, para alterar proxy.healthCheckTimeout para 1000 ms, pode modificar o ficheiro da seguinte forma:
cat << EOF > user.yaml
# Extra config to override default milvus.yaml
proxy:
healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
EOF
Em seguida, reinicie o serviço da seguinte forma:
$ bash standalone_embed.sh restart
Para os itens de configuração aplicáveis, consulte «Configuração do sistema».
Atualizar o Milvus
O comando upgrade do script descarrega o script a partir de master e recria o contentor utilizando a imagem selecionada por esse script. Não valida um caminho de versão de origem para destino suportado e pode recriar ficheiros de configuração gerados. Não considere isto como uma garantia de que uma implementação antiga arbitrária possa ser atualizada com segurança para a v3.0.5.
Antes de uma atualização, faça uma cópia de segurança dos metadados, dos dados persistentes, de embedEtcd.yaml e de user.yaml. Verifique a versão de destino, a fila de mensagens e a compatibilidade de armazenamento, e valide a recuperação num ambiente que não seja de produção. Para implementações geridas com o Docker Compose, siga as instruções em «Atualizar o Milvus Standalone com o Docker Compose»; não aplique esse procedimento diretamente a um contentor gerido por script.
Parar e eliminar o Milvus
Pode parar e eliminar este contentor da seguinte forma
# Stop Milvus
$ bash standalone_embed.sh stop
# Delete Milvus data
$ bash standalone_embed.sh delete
Dependências opcionais
Por predefinição, esta implementação executa o Woodpecker (WAL no sistema de ficheiros local) como fila de mensagens e um etcd incorporado para metadados — não é necessário instalar mais nada. Para utilizar uma fila de mensagens diferente ou ligar armazenamento de objetos/metadados externos, consulte:
- Fila de mensagens: Woodpecker (padrão) · Pulsar · Kafka · RocksMQ
- Armazenamento de objetos: MinIO (padrão) · AWS S3 · Azure Blob · GCP Cloud Storage · Aliyun OSS · Tencent COS · Huawei OBS · Compatível com S3
- Metadados: etcd
O Storage V3 está desativado por predefinição. Ative-o antes de utilizar funcionalidades que dependam dele. Para conhecer os requisitos e as considerações de compatibilidade, consulte Storage V3.
Próximos passos
Depois de instalar o Milvus no Docker, pode:
Consulte o Guia de Início Rápido para ver o que o Milvus pode fazer.
Aprender as operações básicas do Milvus:
Consulte as considerações relativas à atualização nesta página antes de alterar a versão do Milvus.
Implemente o seu cluster Milvus em nuvens:
Explore o Milvus WebUI, uma interface web intuitiva para a monitorização e gestão do Milvus.
Explore o Milvus Backup, uma ferramenta de código aberto para cópias de segurança dos dados do Milvus.
Explore o Birdwatcher, uma ferramenta de código aberto para depuração do Milvus e atualizações dinâmicas de configuração.
Explore o Attu, uma ferramenta GUI de código aberto para a gestão intuitiva do Milvus.
