sudo mkdir -p /opt/data/ops/mongodb
cd /opt/data/ops/mongodb

# =============================================================================
# MongoDB 8.0 Docker Compose 部署文件
# 镜像版本：mongo:8.0（对应 MongoDB 8.0.32，与《Ubuntu 22.04 安装 MongoDB 8.0 指南》版本一致）
# 使用方式：cd /opt/data/ops/mongodb && docker compose up -d
# 密码等敏感值通过环境变量注入，请先 export（见文档"六、常用环境变量表"章节）
# =============================================================================

services:
  mongodb:
    # 镜像版本：8.0 官方镜像
    image: mongo:8.0

    # 容器名称，方便 docker ps / docker logs 定位
    container_name: mongo-8-0

    # 重启策略：容器异常退出时自动重启（除非手动 stop）
    restart: unless-stopped

    # ---- 常用环境变量配置（值由外部环境变量注入）----
    environment:
      - TZ=Asia/Shanghai                        # 容器时区（与宿主机一致）
      - MONGO_INITDB_ROOT_USERNAME=${MONGO_INITDB_ROOT_USERNAME:-admin}      # 初始管理员用户名
      - MONGO_INITDB_ROOT_PASSWORD=${MONGO_INITDB_ROOT_PASSWORD:?请在环境变量中设置} # 初始管理员密码（首次初始化生效）
      - MONGO_INITDB_DATABASE=${MONGO_INITDB_DATABASE:-app_db}               # 自动创建的默认数据库

    # ---- 端口映射：宿主机17017 -> 容器27017 ----
    ports:
      - "17017:27017"

    # ---- 数据持久化（重要）----
    # ./data 为宿主机数据目录，重启容器数据不丢失
    volumes:
      - ./data:/data/db
      # ---- 配置文件持久化（重要）----
      # ./conf 为宿主机配置目录，mongod 默认自动读取 /etc/mongod.conf，
      # 编辑 ./conf/mongod.conf 后 docker compose restart mongodb 即可生效
      - ./conf/mongod.conf:/etc/mongod.conf

    # ---- 健康检查：mongosh ping 判断数据库就绪 ----
    healthcheck:
      test: ["CMD-SHELL", "mongosh --quiet --username $${MONGO_INITDB_ROOT_USERNAME} --password $${MONGO_INITDB_ROOT_PASSWORD} --authenticationDatabase admin --eval \"db.adminCommand('ping').ok\""]
      interval: 10s      # 每 10 秒检查一次
      timeout: 5s        # 单次检查超时
      retries: 10        # 连续 10 次失败视为不健康
      start_period: 30s  # 启动后 30 秒才开始检查

    # 容器日志大小限制，防止磁盘被日志占满
    logging:
      driver: json-file
      options:
        max-size: "50m"
        max-file: "3"

# MongoDB 自定义配置文件（挂载到 /etc/mongod.conf，mongod 启动时自动读取）
# 修改后重启容器生效：docker compose restart mongodb

# 数据存储目录（对应数据卷 ./data:/data/db）
storage:
  dbPath: /data/db

# 日志输出
systemLog:
  destination: file
  logAppend: true
  path: /var/log/mongodb/mongod.log

# 网络监听：0.0.0.0 监听所有网卡（配合端口映射供外部连接）
net:
  port: 27017
  bindIp: 0.0.0.0

# 进程运行配置
processManagement:
  timeZoneInfo: /usr/share/zoneinfo

# 更多常用参数示例（按需取消注释）：
# security:
#   authorization: enabled            # 启用账号鉴权（镜像在设置初始管理员时会自动追加 --auth）
# storage:
#   wiredTiger:
#     engineConfig:
#       cacheSizeGB: 1                 # WiredTiger 缓存大小（建议为物理内存的 50%）
# operationProfiling:
#   mode: slowOp                      # 慢查询分析：off/slowOp/all
#   slowOpThresholdMs: 100            # 慢查询阈值（毫秒）
#   slowOpSampleRate: 1.0

# 注入密码（首次初始化生效，容器重建后需保持一致才能正常读取数据目录）
export MONGO_INITDB_ROOT_PASSWORD='your-password'

docker compose up -d

# 查看容器状态（healthy 表示健康检查通过）
docker ps --filter name=mongo-8-0

# 使用管理员账号连接测试
docker exec -it mongo-8-0 mongosh -u admin -p "$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --eval "db.runCommand({ ping: 1 })"

# 验证鉴权生效（无凭据访问应被拒绝）
docker exec -it mongo-8-0 mongosh --eval "db.runCommand({ ping: 1 })"

MongoServerError: Command find requires authentication

# 先注入环境变量
export MONGO_INITDB_ROOT_PASSWORD='your-password'

docker run -d \
  --name mongo-8-0 \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD="$MONGO_INITDB_ROOT_PASSWORD" \
  -e MONGO_INITDB_DATABASE=app_db \
  -p 17017:27017 \
  -v /opt/data/ops/mongodb/data:/data/db \
  -v /opt/data/ops/mongodb/conf/mongod.conf:/etc/mongod.conf \
  --health-cmd='mongosh --quiet --username "$MONGO_INITDB_ROOT_USERNAME" --password "$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --eval "db.adminCommand(\"ping\").ok"' \
  --health-interval=10s \
  --health-timeout=5s \
  --health-retries=10 \
  --health-start-period=30s \
  mongo:8.0

# 查看日志
docker logs -f mongo-8-0

# 重启容器（数据保留）
docker compose restart

# 停止并移除容器（保留数据）
docker compose down

# 彻底移除容器 + 数据目录（谨慎操作！）
docker compose down -v

# 进入 mongosh 交互
docker exec -it mongo-8-0 mongosh -u admin -p "$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin