跳到主要内容

Docker 配置

概述​

MGAgent 使用 Docker Compose 分层部署，基础设施和应用层分离管理：

文件用途包含服务
docker-compose.infra.yml基础设施MySQL、Milvus、etcd、MinIO、Attu
docker-compose.prod.yml应用层Chat 后端、Admin 后端、Chat 前端、Admin 前端

Docker 镜像源配置​

配置国内镜像源​

# 使用脚本配置（推荐）
./scripts/docker-services.sh setup-mirror

# 手动配置
mkdir -p ~/.docker
cat > ~/.docker/daemon.json << 'EOF'
{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.1panel.live",
    "https://docker.1ms.run",
    "https://docker.m.daocloud.io",
    "https://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://mirror.ccs.tencentyun.com"
  ]
}
EOF

# 重启 Docker
sudo systemctl restart docker

预热镜像​

# 预热所有必需的 Docker 镜像
./scripts/docker-services.sh preload

需要预热的镜像：

镜像用途
mysql:8.0MySQL 数据库
milvusdb/milvus:v2.4.12Milvus 向量数据库
quay.io/coreos/etcd:v3.5.5Milvus etcd 依赖
minio/minio:RELEASE.2023-03-20T20-16-18ZMilvus MinIO 依赖
zilliz/attu:v2.4Milvus 管理界面
python:3.10-slim后端构建基础镜像
node:18-alpine前端构建基础镜像
nginx:alpine前端部署镜像

网络配置​

所有服务通过 mgagent-network 网络互联。docker-compose.prod.yml 使用外部网络，因为基础设施和应用层分属不同的 Compose 文件：

# docker-compose.infra.yml（创建网络）
networks:
  mgagent-network:
    driver: bridge
    name: mgagent-network

# docker-compose.prod.yml（加入已存在的网络）
networks:
  mgagent-network:
    external: true
    name: mgagent-network
注意

必须先启动基础设施（docker-compose.infra.yml），网络会被自动创建。然后应用层才能加入该网络。

数据卷配置​

使用 Docker 命名卷实现数据持久化：

volumes:
  mysql_data:
    driver: local
  milvus_data:
    driver: local
  etcd_data:
    driver: local
  minio_data:
    driver: local

查看和管理数据卷​

# 查看所有数据卷
docker volume ls

# 查看数据卷详情
docker volume inspect mgagent_mysql_data

# 备份 MySQL
docker run --rm -v mgagent_mysql_data:/data -v $(pwd):/backup \
  alpine tar czf /backup/mysql-backup.tar.gz /data

# 恢复 MySQL
docker run --rm -v mgagent_mysql_data:/data -v $(pwd):/backup \
  alpine tar xzf /backup/mysql-backup.tar.gz -C /

服务依赖​

基础设施内部依赖​

services:
  milvus:
    depends_on:
      - etcd
      - minio

  attu:
    depends_on:
      - milvus

应用层依赖​

services:
  mgagent-frontend:
    depends_on:
      - mgagent-backend

  mgagent-admin-frontend:
    depends_on:
      mgagent-admin-backend:
        condition: service_healthy

健康检查​

所有服务都配置了健康检查：

# 后端 API 健康检查
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8000/api/health"]
  interval: 30s
  timeout: 5s
  retries: 3
  start_period: 15s

# MySQL 健康检查
healthcheck:
  test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
  interval: 10s
  timeout: 5s
  retries: 5

# Milvus 健康检查
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:9091/healthz"]
  interval: 10s
  timeout: 5s
  retries: 5

资源限制​

生产环境配置​

services:
  mgagent-backend:
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '2'
        reservations:
          memory: 1G
          cpus: '1'

  mysql:
    deploy:
      resources:
        limits:
          memory: 4G
          cpus: '2'
        reservations:
          memory: 2G
          cpus: '1'

  milvus:
    deploy:
      resources:
        limits:
          memory: 4G
          cpus: '2'
        reservations:
          memory: 2G
          cpus: '1'

日志配置​

# 基础设施日志
docker compose -f docker-compose.infra.yml logs -f --tail=50

# 应用层日志
docker compose -f docker-compose.prod.yml logs -f --tail=50

# 单个服务日志
docker logs mgagent-backend --tail=100 -f

Docker 日志轮转​

在 /etc/docker/daemon.json 中配置：

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}

相关文档​