快速上手：Milvus与Attu在Docker环境下的无缝集成指南

运行mivlus和它的图形化界面都是在docker容器中运行的，那么首先就是要安装docker，这边以windows用户为例。

安装Docker

启用WSL

1. 首先按win键搜索控制面板并打开。
   
   点击程序。
   
   点击启用或关闭windows功能。
   
   勾选上虚拟机平台然后重启电脑（一定要重启）即可。
   

安装Ubuntu

在微软商店里面搜索ubuntu然后随便安装一个LTS版本即可(LTS表示长期支持)。
下载完成后按提示安装应该会要输入用户名密码什么的（自行设置）。

然后在菜单栏搜索ubuntu并打开。

然后就在这个命令行中执行下面的命令。

首先执行以下命令卸载所有冲突的软件包。(sudo使用超级管理员权限会让你提示你输入密码，你输入的密码在终端中是不会显示的)。

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

然后运行以下命令设置Docker官方仓库并安装相关依赖项。

# 添加Docker的官方GPG密钥:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# 将存储库添加到apt源:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

然后运行以下命令安装docker。

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

然后在终端中运行

docker --help

若出现以下内容则安装成功。

安装mivlus服务端

首先运行以下命令下载安装脚本。

curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh

然后运行以下命令运行脚本。

bash standalone_embed.sh start

启动后再运行。

sudo docker ps

可以看到一个名为milvus-standalone的容器已经开始运行。

ok我们删了这个容器。
运行以下命令强制删除。

sudo docker rm -f milvus-standalone

接下来开始安装milvus用户图形界面attu。

安装mivlus用户图形界面

attu的github地址是https://github.com/zilliztech/attu。

首先拉取项目

执行git clone https://github.com/zilliztech/attu
然后执行cd attu进入到项目里面。

构建镜像

可以直接执行sudo docker build -t attu:2.4.12 .命令构建镜像。
但由于里面的nodejs的依赖安装使用的是国外源，所以十分的慢。因此我改了里面的Dockerfile文件，把源换成了国内的镜像源。
更改的Dockerfile文件如下

# => Building container
FROM node:22-slim AS builder
WORKDIR /app
COPY . .

ARG TARGETPLATFORM
ARG BUILDPLATFORM
RUN echo "I am running on $BUILDPLATFORM, building for $TARGETPLATFORM"

# => Building Client
WORKDIR /app/client
RUN npm config set registry https://registry.npm.taobao.org && \
  yarn install --network-timeout 1000000
RUN yarn build

# => Building Server
WORKDIR /app/server
RUN npm config set registry https://registry.npm.taobao.org && \
  yarn install --network-timeout 1000000
ENV NODE_ENV=production \
    PORT=80
RUN yarn build

# => Copy to Final container
FROM node:22-slim
WORKDIR /app
COPY --from=builder /app/server/dist /app/dist
COPY --from=builder /app/client/build /app/build
COPY --from=builder /app/server/package.json /app/package.json
COPY --from=builder /app/server/yarn.lock /app/yarn.lock

# => Reinstall production dependencies and clean cache
RUN npm config set registry https://registry.npm.taobao.org && \
  yarn install --production && yarn cache clean

# Make our shell script executable
RUN chmod +x /app/build/env.sh

# Make all files accessible such that the image supports arbitrary user ids
RUN chgrp -R 0 /app && \
  chmod -R g=u /app

EXPOSE 3000

CMD ["/bin/bash", "-c", "/app/build/env.sh && yarn start:prod"]

将这上面的内容拷贝替换原来的Dockerfile文件。
然后再运行。

sudo docker build -t attu:2.4.12 .

我这边用时176.5s(没开科学上网)。
然后执行

sudo docker iamges

可以看到已经构建了这个镜像。
接下来开始启动容器
在根目录下创建一个milvus目录并进入

cd ~
mkdir mivlus
cd milvus
sudo docker iamges

将以下下内容保存为compose.yaml文件
一定要注意image字段和你那边是否能对上

version: '3.8'

name: MilvusServer

services:
  milvus-standalone:
    image: milvusdb/milvus:v2.5.0-beta # 确认镜像标签是否正确
    container_name: milvus-standalone
    security_opt:
      - seccomp:unconfined
    environment:
      - ETCD_USE_EMBED=true
      - ETCD_DATA_DIR=/var/lib/milvus/etcd
      - ETCD_CONFIG_PATH=/milvus/configs/embedEtcd.yaml
      - COMMON_STORAGETYPE=local
    volumes:
      - ./volumes/milvus:/var/lib/milvus
      - ./embedEtcd.yaml:/milvus/configs/embedEtcd.yaml
      - ./user.yaml:/milvus/configs/user.yaml
    ports:
      - "19530:19530"
      - "9091:9091"
      - "2379:2379"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9091/healthz"]
      interval: 30s
      start_period: 90s
      timeout: 20s
      retries: 3
    command: ["milvus", "run", "standalone"]
    logging:
      driver: "none"
    networks:
      - milvusserver_default #将其加入自定义的网络

  attu:
    image: attu:2.4.12  # 确认镜像标签是否正确
    container_name: attu
    environment:
      - MILVUS_URL=milvus-standalone:19530  # 使用服务名代替IP地址
    ports:
      - "8000:3000"
    depends_on:
      - milvus-standalone
    networks:
      - milvusserver_default #将其加入自定义的网络

networks:
  milvusserver_default:
    driver: bridge

然后运行

sudo docker compose up -d

进入浏览器访问localhost:8000

等个10秒钟左右再连接(项目刚开要初始化)。

使用milvus

使用milvus请参考Milvus + RAG：开启智能搜索新时代，重塑AI创造力。

将Milvus + RAG：开启智能搜索新时代，重塑AI创造力的

改为

即可！

结语

欢迎讨论。