安装与配置 #

Milvus安装方式：

┌─────────────────────────────────────────┐
│           安装方式选择                   │
├─────────────────────────────────────────┤
│                                         │
│  ┌─────────────┐    ┌─────────────┐    │
│  │  单机模式    │    │  集群模式    │    │
│  │  (开发测试)  │    │  (生产环境)  │    │
│  └──────┬──────┘    └──────┬──────┘    │
│         │                  │           │
│    ┌────┴────┐        ┌────┴────┐      │
│    │ Docker  │        │   K8s   │      │
│    │ Compose │        │ Helm    │      │
│    └─────────┘        └─────────┘      │
│                                         │
└─────────────────────────────────────────┘

# 创建目录
mkdir -p ~/milvus && cd ~/milvus

# 下载docker-compose配置
wget https://github.com/milvus-io/milvus/releases/download/v2.4.0/milvus-standalone-docker-compose.yml -O docker-compose.yml

# 启动Milvus
docker-compose up -d

# 查看状态
docker-compose ps

# 输出示例：
# Name                Command                  State                          Ports
# ─────────────────────────────────────────────────────────────────────────────────────
# milvus-etcd         etcd -advertise-client-urls   Up      2379/tcp, 2380/tcp
# milvus-minio        /usr/bin/docker-entrypoint... Up      9000/tcp
# milvus-standalone   /tini -- milvus run standa... Up      0.0.0.0:19530->19530/tcp

# 检查端口
netstat -an | grep 19530

# 使用curl测试
curl -X POST "http://localhost:19530/v1/vector/collections" \
  -H "Content-Type: application/json" \
  -d '{"collection_name": "test"}'

# 停止服务
docker-compose down

# 停止并删除数据
docker-compose down -v

# 删除所有数据
rm -rf ~/milvus/volumes

# 启动Milvus单容器
docker run -d --name milvus-standalone \
  -p 19530:19530 \
  -p 9091:9091 \
  -v ~/milvus/data:/var/lib/milvus \
  milvusdb/milvus:v2.4.0 \
  milvus run standalone

# 创建网络
docker network create milvus

# 启动ETCD
docker run -d --name milvus-etcd \
  --network milvus \
  -e ETCD_AUTO_COMPACTION_MODE=revision \
  -e ETCD_AUTO_COMPACTION_RETENTION=1000 \
  quay.io/coreos/etcd:v3.5.5 \
  etcd -advertise-client-urls=http://127.0.0.1:2379 \
       -listen-client-urls http://0.0.0.0:2379 \
       --data-dir /etcd

# 启动MinIO
docker run -d --name milvus-minio \
  --network milvus \
  -e MINIO_ACCESS_KEY=minioadmin \
  -e MINIO_SECRET_KEY=minioadmin \
  minio/minio:RELEASE.2023-03-20T20-16-18Z \
  minio server /minio_data

# 启动Milvus
docker run -d --name milvus-standalone \
  --network milvus \
  -p 19530:19530 \
  -p 9091:9091 \
  -e ETCD_ENDPOINTS=milvus-etcd:2379 \
  -e MINIO_ADDRESS=milvus-minio:9000 \
  milvusdb/milvus:v2.4.0 \
  milvus run standalone

# 添加Milvus Helm仓库
helm repo add milvus https://zilliztech.github.io/milvus-helm/
helm repo update

# 创建命名空间
kubectl create namespace milvus

# 安装Milvus集群
helm install milvus milvus/milvus \
  --namespace milvus \
  --set cluster.enabled=true \
  --set proxy.service.type=LoadBalancer

# 安装Milvus单机版
helm install milvus milvus/milvus \
  --namespace milvus \
  --set cluster.enabled=false \
  --set proxy.service.type=LoadBalancer

# values.yaml
cluster:
  enabled: true

proxy:
  replicas: 2
  resources:
    requests:
      cpu: "1"
      memory: "2Gi"
    limits:
      cpu: "2"
      memory: "4Gi"

queryNode:
  replicas: 3
  resources:
    requests:
      cpu: "2"
      memory: "8Gi"
    limits:
      cpu: "4"
      memory: "16Gi"

dataNode:
  replicas: 2

indexNode:
  replicas: 2

etcd:
  replicaCount: 3

minio:
  mode: distributed
  replicas: 4

pulsar:
  enabled: true

# 使用自定义配置安装
helm install milvus milvus/milvus \
  --namespace milvus \
  -f values.yaml

# 查看Pod状态
kubectl get pods -n milvus

# 查看服务
kubectl get svc -n milvus

# 查看日志
kubectl logs -n milvus deployment/milvus-proxy

# 基础安装
pip install pymilvus

# 安装特定版本
pip install pymilvus==2.4.0

# 安装所有依赖
pip install "pymilvus[all]"

from pymilvus import connections, utility

# 连接Milvus
connections.connect(
    alias="default",
    host="localhost",
    port="19530"
)

# 检查连接
print(utility.get_server_version())

# 输出: 2.4.0

# 安装Go SDK
go get github.com/milvus-io/milvus-sdk-go/v2

package main

import (
    "context"
    "fmt"
    "github.com/milvus-io/milvus-sdk-go/v2/client"
)

func main() {
    ctx := context.Background()
    c, err := client.NewClient(ctx, client.Config{
        Address: "localhost:19530",
    })
    if err != nil {
        panic(err)
    }
    defer c.Close()
    
    fmt.Println("Connected to Milvus")
}

<!-- Maven依赖 -->
<dependency>
    <groupId>io.milvus</groupId>
    <artifactId>milvus-sdk-java</artifactId>
    <version>2.4.0</version>
</dependency>

import io.milvus.client.MilvusServiceClient;
import io.milvus.param.ConnectParam;

public class Main {
    public static void main(String[] args) {
        ConnectParam connectParam = ConnectParam.newBuilder()
            .withHost("localhost")
            .withPort(19530)
            .build();
        
        MilvusServiceClient client = new MilvusServiceClient(connectParam);
        System.out.println("Connected to Milvus");
    }
}

# 安装Node.js SDK
npm install @zilliz/milvus2-sdk-node

const { MilvusClient } = require('@zilliz/milvus2-sdk-node');

const client = new MilvusClient({
    address: 'localhost:19530',
});

async function main() {
    const version = await client.getVersion();
    console.log('Milvus version:', version);
}

main();

# milvus.yaml
etcd:
  endpoints:
    - localhost:2379
  rootPath: by-dev
  metaSubPath: meta

minio:
  address: localhost
  port: 9000
  accessKeyID: minioadmin
  secretAccessKey: minioadmin
  useSSL: false
  bucketName: a-bucket

common:
  defaultPartitionName: _default
  defaultIndexName: _default_idx
  retentionDuration: 432000  # 5天

dataCoord:
  segment:
    maxSize: 512  # MB
    diskSegmentMaxSize: 2048  # MB

queryCoord:
  autoHandoff: true
  autoBalance: true

queryNode:
  cacheSize: 32  # GB
  segcore:
    chunkRows: 1024

indexCoord:
  segment:
    minSegmentNumRowsToEnableIndex: 1024

proxy:
  timeTickInterval: 200  # ms
  maxFieldLength: 65535
  maxShardNum: 256

# ETCD配置
export ETCD_ENDPOINTS="localhost:2379"
export ETCD_ROOT_PATH="by-dev"

# MinIO配置
export MINIO_ADDRESS="localhost:9000"
export MINIO_ACCESS_KEY="minioadmin"
export MINIO_SECRET_KEY="minioadmin"

# 存储配置
export MINIO_BUCKET_NAME="milvus-bucket"

# 日志配置
export GLOG_LEVEL="info"
export GLOG_FILE="stdout"

from pymilvus import connections

# 基本连接
connections.connect(
    alias="default",
    host="localhost",
    port="19530"
)

# 带用户名密码连接
connections.connect(
    alias="default",
    host="localhost",
    port="19530",
    user="root",
    password="Milvus"
)

# 带TLS连接
connections.connect(
    alias="default",
    host="localhost",
    port="19530",
    secure=True,
    server_pem_path="/path/to/server.pem"
)

from pymilvus import connections

# 多连接管理
connections.connect(
    alias="db1",
    host="localhost",
    port="19530"
)

connections.connect(
    alias="db2",
    host="localhost",
    port="19531"
)

# 切换连接
connections.connect("db1")

# Docker方式安装
docker run -d --name attu \
  -p 3000:3000 \
  -e MILVUS_URL=host.docker.internal:19530 \
  zilliz/attu:latest

打开浏览器访问：http://localhost:3000

连接配置：
- Milvus Address: localhost:19530
- Database: default

# 检查端口占用
lsof -i :19530

# 修改端口
docker run -d --name milvus-standalone \
  -p 19531:19530 \
  milvusdb/milvus:v2.4.0 \
  milvus run standalone

# 调整Docker内存限制
docker run -d --name milvus-standalone \
  --memory="16g" \
  --memory-swap="16g" \
  -p 19530:19530 \
  milvusdb/milvus:v2.4.0 \
  milvus run standalone

# 确保挂载正确目录
docker run -d --name milvus-standalone \
  -v ~/milvus/data:/var/lib/milvus \
  -p 19530:19530 \
  milvusdb/milvus:v2.4.0 \
  milvus run standalone