Debian环境下MongoDB的升级步骤

Debian 环境下 MongoDB 升级步骤

一 升级前准备

• 备份数据：使用 mongodump 全量导出，确保可回滚。示例：mongodump --out /path/to/backup-$(date +%F)。
• 检查现状：确认当前版本与运行状态。示例：mongod --version、systemctl status mongod。
• 查阅版本路径：MongoDB 官方以 Ubuntu LTS 代号发布 APT 仓库（如 focal），在 Debian 上通常沿用该代号；请以目标版本的官方文档为准，选择正确的仓库与版本系列。
• 规划维护窗口：尽量在业务低峰期执行，并通知相关方。

二 通过 APT 就地升级（推荐）

• 更新索引并查看可用版本：
  • sudo apt-get update
  • apt-cache madison mongodb-org（确认可升级到的具体版本）
• 执行升级（保持现有配置与数据目录不变）：
  • 升级到仓库最新版：sudo apt-get install -y mongodb-org
  • 或指定组件与版本：sudo apt-get install -y mongodb-org-server=6.0.15 mongodb-org-shell=6.0.15 mongodb-org-mongos=6.0.15 mongodb-org-tools=6.0.15
• 重启并验证：
  • sudo systemctl restart mongod
  • mongod --version、systemctl status mongod
  • 连接 shell 复核：mongo --eval 'db.version()'（如仍保留旧 shell，可用 mongosh 替代）

三 跨大版本或遇到冲突时的做法

• 方式 A（保留数据与配置，优先尝试）：
  • 先备份：mongodump --out /path/to/backup-$(date +%F)
  • 仅移除软件包但保留数据：sudo apt-get purge -y mongodb-org*（注意这不会删除 /var/lib/mongodb 与 /etc/mongod.conf）
  • 按目标版本导入正确 GPG 公钥 与 APT 源（见下一节示例），然后 sudo apt-get update && sudo apt-get install -y mongodb-org
  • 重启并验证：sudo systemctl restart mongod、mongod --version
• 方式 B（全新安装，最干净）：
  • 备份后彻底清理：sudo apt-get purge -y mongodb-org* 并手动清理 /var/lib/mongodb、/var/log/mongodb（谨慎操作）
  • 按目标版本配置仓库后安装：sudo apt-get install -y mongodb-org
  • 使用既有 /etc/mongod.conf 启动：sudo systemctl start mongod
  • 如需回滚，先停库再 mongorestore /path/to/backup

四 仓库与密钥配置示例

• 导入公钥（以目标版本的密钥为准，示例为 server-6.0.asc）：
  • wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
• 添加 APT 源（Debian 通常沿用 Ubuntu LTS 代号；以下为常见示例，请按目标版本与系统架构调整）：
  • Debian 11（Bullseye）示例：
    • echo "deb [arch=amd64,arm64] https://repo.mongodb.org/apt/debian bullseye/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
  • 若文档要求使用 Ubuntu 代号（如 focal）：
    • echo "deb [arch=amd64,arm64] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
• 更新索引并安装：sudo apt-get update && sudo apt-get install -y mongodb-org

五 升级后验证与回滚

• 功能与版本验证：
  • mongod --version、systemctl status mongod
  • 连接复核：mongo --eval 'db.version()'（或 mongosh）
  • 检查日志：sudo journalctl -u mongod -b，确认无启动报错与数据文件兼容提示
• 回滚方案：
  • 使用升级前的 mongodump 备份执行恢复：mongorestore /path/to/backup-<date>
  • 若采用“全新安装”，可快速切回旧版本包并恢复配置与数据目录后启动服务

六 集群与注意事项

• 副本集/分片集群：逐节点升级，遵循官方支持的升级顺序；通常先 Secondary 再 Primary，分片的 mongos 与 config server 也需按计划滚动升级，确保各节点版本一致后再继续下一步。
• 版本路径与兼容性：跨多个大版本升级前，务必阅读目标版本的 Release Notes 与兼容性说明，必要时在测试环境演练。
• 配置与存储：升级不会自动修改 /etc/mongod.conf 与 /var/lib/mongodb；如存储引擎或参数有变更，需按官方指引调整后再启动。
• 安全建议：全程在备份就绪、监控到位的前提下执行，变更窗口内保持可回滚路径。