attu

attu

ATTU是一种多合一的米尔维斯管理工具。

ATTU旨在与Milvus进行管理和互动，提供诸如：

• 数据库，收集和分区管理：有效组织和管理MILVUS设置。
• 向量嵌入的插入，索引和查询：轻松处理MILVUS矢量数据操作。
• 执行矢量搜索：使用矢量搜索功能迅速验证结果。
• 用户和角色管理：轻松管理MILVUS权限和安全性。
• 查看系统拓扑：可视化Milvus系统体系结构，以更好地管理和优化。

安装指南

在开始之前，请确保已在Zilliz Cloud或您自己的服务器上安装了Milvus。

兼容性

Milvus版本	推荐的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

从Docker跑步

这是启动用于运行ATTU的容器的步骤：

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

确保ATTU容器可以访问MILVUS IP地址。启动容器后，打开Web浏览器并输入http://{ Attu IP }:8000以查看ATTU GUI。

可选环境变量用于运行Attu Docker

范围	例子	必需的	描述
MILVUS_URL	192.168.0.1：19530	错误的	可选的Milvus服务器URL
数据库	您的数据库	错误的	可选的默认数据库名称
attu_log_level	信息	错误的	可选，设置ATTU的日志级别
root_cert_path	/path/to/root/cert	错误的	可选的，通往根证书的路径
private_key_path	/path/to/private/键	错误的	可选的，通往私钥的路径
cert_chain_path	/路径/到/cert/链	错误的	可选的，通往证书链的路径
server_name	your_server_name	错误的	可选，服务器的名称
server_port	服务器收听端口	错误的	可选，默认情况下为3000，如果未设置

请注意， MILVUS_URL应该是Attu Docker容器可以访问的地址。因此，“ 127.0.0.1”或“ localhost”将行不通。

要使用这些环境变量运行Docker容器，请使用以下命令：

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

自定义服务器端口示例

此命令使您可以通过主机网络运行Docker容器，为服务器指定一个自定义端口以侦听

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

在Kubernetes中跑步

在开始之前，请确保您在K8的集群中安装了Milvus并运行。请注意，ATTU仅支持Milvus 2.x。

这是启动用于运行ATTU的容器的步骤：

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

确保ATTU POD可以访问Milvus服务。在此提供的示例中，此示例直接连接到my-release-milvus:19530 。根据MILVUS服务名称更改此信息。实现此目的的一种更灵活的方法是引入ConfigMap 。有关详细信息，请参见此示例。

在nginx代理后面跑步

在nginx代理后面跑步

安装桌面应用程序

如果您喜欢使用桌面应用程序，则可以下载ATTU的桌面版本。

笔记：

• Mac M芯片安装应用程序失败：attu.app已损坏，无法打开。

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

在本地构建Docker图像

• 开发： yarn run build:dev
• 发布： yarn run build:release

常问问题

• 我无法登录系统

  确保可以从ATTU容器访问MILVUS服务器的IP地址。 ＃161

• Mac M芯片安装应用程序失败：attu.app已损坏，无法打开。

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

• TBD

更多屏幕截图

创建集合	收集树

集合概述	数据视图

向量搜索	系统视图

贡献代码

感谢您对贡献Attu的兴趣！这是您可以在本地构建ATTU以贡献代码，测试最新功能或尝试开放PR的方法：

构建服务器

1. 叉子和克隆ATTU存储库。
2. 通过在终端中运行cd server来导航到服务器目录。
3. 通过运行yarn install来安装依赖项。
4. 要在开发模式下启动服务器，请运行yarn start 。
5. 通过运行git checkout -b my-branch为您的PR创建一个新的分支。

建立客户

1. 叉子和克隆ATTU存储库。
2. 通过在终端中运行cd client来导航到客户端目录。
3. 通过运行yarn install来安装依赖项。
4. 要在开发模式下启动服务器，请运行yarn start 。
5. 通过运行git checkout -b my-branch为您的PR创建一个新的分支。

提交拉拉请求

1. 进行更改并确保测试通过。
2. 提交更改并将其推向叉子。
3. 创建针对ATTU主要分支的拉请请求。

无论大小如何，我们都要感谢您对ATTU的贡献。感谢您支持该项目！

❓您有任何问题或问题吗？

如果您遇到任何错误或想请求新功能，请创建一个GitHub问题。在提交新问题之前，检查其他人是否已经为同一问题创建了一个问题很重要。

有用的例子

MILVUS打字稿示例：此存储库提供了基于Next.js的一些简单的React应用程序。

姓名	演示	模型
语义搜索示例	https://zilliz-semantic-search-example.vercel.app	All-Minilm-L6-V2
语义图像搜索		夹子 - 底座-patch16
语义图像搜索 - 咨询者	https://zilliz-semantic-image-search-client.vercel.app	夹子 - 底座-patch16

用户链接

以下是一些有用的资源，可以让您开始使用Milvus：

• MILVUS文档：在这里，您可以找到有关如何使用MILVU的详细信息，包括安装说明，教程和API文档。
• Milvus Python SDK：Python SDK允许您使用Python与Milvus进行交互。它提供了一个简单直观的界面，用于创建和查询向量。
• Milvus Java SDK：Java SDK与Python SDK相似，但专为Java开发人员而设计。它还提供了一个简单而直观的界面，用于创建和查询向量。
• MILVUS GO SDK：GO SDK为Milvus提供了GO API。如果您是Go Developer，那么这是您的SDK。
• MILVUS节点SDK：节点SDK为MILVUS提供了node.js api。如果您是Node.js开发人员，那么这是您的SDK。
• 费德（Feder）：费德（Feder）是一种JavaScript工具，旨在帮助理解嵌入向量。

社区

加入我们充满活力的社区，在米尔维斯不和谐中，您可以在其中分享您的知识，提出问题并进行有意义的对话。这不仅是关于编码，还关乎与其他志趣相投的人建立联系。单击下面的链接立即加入！