把Compose业务迁到另一台服务器:预演、停写和流量切换

迁移目标和前提

本文面向单台Linux上的Docker Compose业务,准备搬到另一台Linux服务器。示例项目名为shop,实际名称、目录、域名与服务名都要替换。新旧服务器先使用相同CPU架构、应用镜像和数据库主版本;迁移与大版本升级分开做,减少故障时无法判断原因的情况。

先确认业务用了哪些数据:命名卷、宿主绑定目录、数据库、外部存储、证书、环境文件和计划任务。同时检查是否有误写在容器可写层、没有挂载出来的业务数据,必须在删除容器前另外导出。只有compose.yaml和镜像并不能恢复订单、上传文件等数据。已有数据卷概念可参考Docker数据卷与目录挂载。

一、记录当前运行清单

cd /srv/shop
docker compose -p shop config -q
docker compose -p shop config --services
docker compose -p shop config --images
docker compose -p shop ps -a

对每个容器查看实际Mounts和镜像ID,记录容器目标目录、源卷或宿主路径、UID/GID。将compose文件、必要环境文件和秘密配置保存到权限受限的迁移目录,不放在网站下载路径。自建镜像要保存或推送到有权限的仓库;不要指望同名标签永远指向相同内容。

数据库用其原生一致性备份方式;要复制数据库原始卷,必须先正常停止数据库,并保持版本、架构和全部数据文件匹配。不能边写数据库边打包目录。外部数据库或共享存储需要单独安排,不能认为停止当前Compose就停止了全部写入。

二、先做一次隔离恢复

将一份完整备份传到新服务器专用目录,检查校验和,创建新的目标卷并恢复全部数据。按记录重建路径、属主与权限。新服务器测试期间不要开放生产写入口,也不要运行真实通知、付款、Webhook或重复队列任务。

rsync -av --dry-run /srv/migration/shop/ deploy@192.0.2.20:/srv/migration/shop/
rsync -av /srv/migration/shop/ deploy@192.0.2.20:/srv/migration/shop/

192.0.2.20替换为新服务器,目标目录需提前建立并授权。传输仅包含已完成的备份包,不用rsync直接抓取活动数据库目录。先预览再传输,不加--delete。

新服务器以专用测试配置启动,校验登录、数据条数、上传文件、后台任务和日志。使用本地hosts或curl指定解析到新IP,域名与TLS仍按真实证书校验;正式DNS此时不变。若预演失败,留在旧服务器继续服务并修复,先不要切流量。

三、正式切换时处理最后新增数据

  1. 提前安排维护窗口。若要调低DNS TTL,应在旧TTL足够过期前操作;它不能保证所有客户端立刻更新。
  2. 在旧入口开启维护或只读模式,停止该项目队列、调度器和其他写入者,等待在途请求完成。
  3. 生成停写后的最终数据库备份与上传文件备份,记录最终订单或记录时间点。不要继续使用预演时的旧副本。
  4. 在新机停止预演实例,使用新的空目标卷或按数据库工具要求准备的独立实例恢复最终备份,不把全量归档直接覆盖进含预演数据的目录。核对正式配置、最终卷映射、记录和文件,再启动正式业务。
  5. 更新DNS或入口代理,只保留新服务器作为写入端;确认旧任务已停后,只在新服务器启用一份正式队列与调度器。旧入口继续维护,或按事先验证的方案转发到新入口。
docker compose -p shop stop -t 120
docker compose -p shop ps -a

以上停止命令在旧服务器正确项目目录执行,须确认数据库正常退出而非超时强制终止。不能让新旧两边同时收单,再期待DNS自动合并数据。

四、验收与回退条件

从公网验证域名、证书、登录、一个受控写入、文件下载及后台任务,并核对请求进入新服务器。观察日志和业务记录,旧服务器、备份与旧配置保留到既定观察期结束。

如果新服务器已经产生数据,回退前必须先停止新写入,将新增数据库记录、上传和任务状态按应用支持的方式回迁。只把DNS改回旧IP会丢掉切换后的新增数据。未形成这份回迁安排前,不应把“保留旧机器”当成完整回退方案。