attu

ATtu

Attu é uma ferramenta de administração Milvus tudo-em-um.

ATtu foi projetada para gerenciar e interagir com o Milvus, oferecendo recursos como:

• Banco de dados, coleta e gerenciamento de partição: organize e gerencie com eficiência sua configuração de Milvus.
• Inserção, indexação e consulta de incorporações de vetor: lidar facilmente com operações de dados do vetor de Milvus.
• Executando a Pesquisa de Vector: Valide rapidamente seus resultados usando o recurso de pesquisa vetorial.
• Gerenciamento de usuário e função: gerencie facilmente permissões e segurança do MILVUS.
• Visualizando Topologia do Sistema: Visualize a Arquitetura do Sistema Milvus para obter melhor gerenciamento e otimização.

Guias de instalação

Antes de começar, verifique se você tem o Milvus instalado no Zilliz Cloud ou no seu próprio servidor.

Compatibilidade

Versão Milvus	Versão recomendada de attu
2.4.x	v2.4.11
2.3.x	v2.3.5
2.2.x	v2.2.8
2.1.x	v2.2.2

Correndo de docker

Aqui estão as etapas para iniciar um contêiner para correr attu:

 docker run -p 8000:3000 -e MILVUS_URL={milvus server IP}:19530 zilliz/attu:v2.4

Verifique se o contêiner do ATtu pode acessar o endereço IP do MILVUS. Depois de iniciar o contêiner, abra seu navegador da web e digite http://{ Attu IP }:8000 para visualizar a GUI do Attu.

Variáveis ​​de ambiente opcionais para executar o Docker do Attu

Parâmetro	Exemplo	Obrigatório	Descrição
Milvus_url	192.168.0.1:19530	falso	Opcional, URL do servidor Milvus
BANCO DE DADOS	Seu banco de dados	falso	Nome do banco de dados padrão opcional
Attu_log_level	informações	falso	Opcional, define o nível de log para attu
Root_cert_path	/PATH/TO/ROOT/CERT	falso	Opcional, caminho para o certificado raiz
Private_key_path	/caminho/para/privado/key	falso	Opcional, caminho para a chave privada
Cert_chain_path	/caminho/para/cert/cadeia	falso	Opcional, caminho para a cadeia de certificados
Server_name	your_server_name	falso	Opcional, nome do seu servidor
Server_port	Porta de escuta do servidor	falso	Opcional, 3000 por padrão se não for definido

Observe que o MILVUS_URL deve ser um endereço que o contêiner do Docker do Attu pode acessar. Portanto, "127.0.0.1" ou "localhost" não funcionará.

Para executar o contêiner do Docker com essas variáveis ​​de ambiente, use o seguinte comando:

Exemplo de attu ssl

docker run -p 8000:3000 
-v /your-tls-file-path:/app/tls 
-e ATTU_LOG_LEVEL=info  
-e ROOT_CERT_PATH=/app/tls/ca.pem 
-e PRIVATE_KEY_PATH=/app/tls/client.key 
-e CERT_CHAIN_PATH=/app/tls/client.pem 
-e SERVER_NAME=your_server_name 
zilliz/attu:dev

Exemplo de porta de servidor personalizado

Este comando permite executar o contêiner do docker com rede de host, especificando uma porta personalizada para o servidor ouvir

docker run --network host 
-v /your-tls-file-path:/app/tls 
-e ATTU_LOG_LEVEL=info  
-e SERVER_NAME=your_server_name 
-e SERVER_PORT=8080 
zilliz/attu:dev

Correndo de Attu dentro de Kubernetes

Antes de começar, certifique -se de que você tenha o Milvus instalado e executando no cluster do seu K8. Observe que o ATtu suporta apenas o Milvus 2.x.

Aqui estão as etapas para iniciar um contêiner para correr attu:

 kubectl apply -f https://raw.githubusercontent.com/zilliztech/attu/main/attu-k8s-deploy.yaml

Certifique -se de que o pod do ATtu possa acessar o serviço Milvus. No exemplo, isso, isso se conecta diretamente ao my-release-milvus:19530 . Altere isso com base no nome do serviço Milvus. Uma maneira mais flexível de conseguir isso seria introduzir um ConfigMap . Veja este exemplo para obter detalhes.

Correndo por trás de um proxy nginx

Correndo por trás de um proxy nginx

Instale o aplicativo da área de trabalho

Se você preferir usar um aplicativo de desktop, faça o download da versão da área de trabalho do Attu.

Observação:

• Mac M Chip Install App Falha: Attu.App está danificado e não pode ser aberto.

  sudo xattr -rd com.apple.quarantine /Applications/attu.app

Construa a imagem do Docker localmente

• Dev: yarn run build:dev
• Lançamento: yarn run build:release

Perguntas frequentes

• Não consigo fazer login no sistema

  Verifique se o endereço IP do servidor MILVUS pode ser acessado no contêiner do Attu. #161

• Mac M Chip Install App Falha: Attu.App está danificado e não pode ser aberto.

    sudo xattr -rd com.apple.quarantine /Applications/attu.app

• TBD

Mais capturas de tela

Criar coleção	árvore de coleção

Visão geral da coleção	Visualização de dados

Pesquisa de vetor	Visualização do sistema

Código contribuindo

Obrigado pelo seu interesse em contribuir para o ATtu! Veja como você pode construir attu localmente para contribuir com código, testar os recursos mais recentes ou experimentar um PR aberto:

Construir o servidor

1. Garfo e clonar o repositório attu.
2. Navegue até o diretório do servidor executando cd server no terminal.
3. Instale as dependências executando yarn install .
4. Para iniciar o servidor no modo de desenvolvimento, execute yarn start .
5. Crie uma nova filial para o seu PR executando git checkout -b my-branch .

Construir o cliente

1. Garfo e clonar o repositório attu.
2. Navegue até o diretório do cliente executando cd client no terminal.
3. Instale as dependências executando yarn install .
4. Para iniciar o servidor no modo de desenvolvimento, execute yarn start .
5. Crie uma nova filial para o seu PR executando git checkout -b my-branch .

Enviando um pedido de tração

1. Faça alterações e verifique se os testes passam.
2. Compromete mudanças e pressione para o seu garfo.
3. Crie uma solicitação de tração direcionada ao ramo principal do ATTU.

Agradecemos suas contribuições para o Attu, independentemente do tamanho. Obrigado por apoiar o projeto!

❓ Você tem alguma dúvida ou problema?

Se você encontrar bugs ou deseja solicitar um novo recurso, crie um problema do GitHub. É importante verificar se alguém já criou um problema para o mesmo problema antes de enviar um novo.

Exemplos úteis

Milvus TypeScript Exemplos: Este repositório fornece alguns aplicativos de reação simples com base no próximo.js.

Nome	Demonstração	Modelo
Pesquisa semântica-Exemplo	https://zilliz-semantic-search-example.vercel.app	Minilm-L6-V2
pesquisa semântica de imagem		Clip-Vit-Base-Patch16
Pesquisa semântica semântica	https://zilliz-semantic-image-search-client.vercel.app	Clip-Vit-Base-Patch16

Links úteis

Aqui estão alguns recursos úteis para você começar com Milvus:

• Documentação do Milvus: Aqui, você pode encontrar informações detalhadas sobre como usar o MILVUS, incluindo instruções de instalação, tutoriais e documentação da API.
• Milvus Python SDK: O Python SDK permite que você interaja com Milvus usando o Python. Ele fornece uma interface simples e intuitiva para criar e consultar vetores.
• Milvus Java SDK: O Java SDK é semelhante ao Python SDK, mas projetado para desenvolvedores de Java. Ele também fornece uma interface simples e intuitiva para criar e consultar vetores.
• Milvus Go SDK: O Go SDK fornece uma API GO para Milvus. Se você é desenvolvedor, este é o SDK para você.
• Milvus Node SDK: O nó SDK fornece uma API Node.js para Milvus. Se você é um desenvolvedor Node.js, este é o SDK para você.
• Feder: Feder é uma ferramenta JavaScript projetada para ajudar na compreensão da incorporação de vetores.

Comunidade

Junte -se à nossa comunidade vibrante na Discord Milvus, onde você pode compartilhar seu conhecimento, fazer perguntas e participar de conversas significativas. Não se trata apenas de codificar, mas de se conectar com outros indivíduos com idéias semelhantes. Clique no link abaixo para participar agora!