Linux服务器迁移Docker容器时,如何保留数据并设置验证与回退步骤?

发布人:A5数据发布时间:2026-11-09 09:30阅读量:67

Linux服务器迁移Docker容器时,应保留的是容器运行所依赖的镜像、配置、网络参数和持久化数据,而不是简单复制容器ID或整个Docker运行目录。可靠做法是先盘点挂载关系与版本依赖,再对数据库执行一致性备份,对文件型数据进行归档校验,最后在目标服务器上按固定版本恢复并验证。

变更实施方案配图

迁移过程中需要把“数据是否完整”和“业务是否可用”分开验证。容器能启动,不代表数据库、上传文件、定时任务和外部连接都正常;目标环境验证通过后,也不能立即删除源服务器数据。应预先约定观察窗口、回退触发条件,以及切换后产生新数据时的处理方式。

A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,可为Docker容器迁移后的应用、数据库、文件存储与后台任务提供独立运行基础。产品覆盖Xeon、AMD EPYC、NVMe存储、大容量HDD、多IP及不同带宽线路,便于结合业务访问区域、数据规模和容器负载搭建目标环境,并承载迁移后的持续运行与数据留存。

现状核对:先确认容器到底依赖什么

盘点主机、Docker和架构差异

升级Docker版本、替换操作系统或跨服务器迁移时,先记录源端和目标端的基础环境。不要只根据发行版名称判断兼容性,还要核对CPU架构、Docker Engine、Compose插件、存储驱动和可用磁盘空间。

在源服务器和目标服务器分别执行:

uname -a
uname -m
docker version
docker compose version
docker info --format 'StorageDriver={{.Driver}} DockerRootDir={{.DockerRootDir}}'
df -hT
free -h

重点确认以下内容:

  • x86_64、aarch64等CPU架构是否一致。若不一致,需要确认镜像是否提供目标架构,不能直接把单架构镜像当作通用镜像使用。
  • Docker Engine和Compose插件版本是否支持当前配置文件中的字段。
  • 目标服务器的磁盘容量是否覆盖镜像、容器日志、数据库、上传文件和临时空间。迁移时不能只按业务数据量估算,还应预留数据库索引、日志和备份空间。
  • 目标端端口、内核参数、防火墙策略和外部网络访问是否满足业务依赖。
  • 源端是否使用rootless Docker、特殊存储驱动或自定义Docker数据目录。rootless模式下,卷路径和权限处理方式可能与root模式不同。

记录容器、镜像、挂载和网络

容器本身通常是可重建的,持久化数据则可能位于命名卷、绑定挂载目录或外部存储中。迁移前要逐个容器确认,不要只看Compose文件。

docker ps -a --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}'

docker inspect <container_name> \
  > /srv/migration/<container_name>-inspect.json

docker inspect -f \
'{{range .Mounts}}{{println .Type .Name .Source "->" .Destination}}{{end}}' \
<container_name>

docker inspect -f \
'Networks: {{json .NetworkSettings.Networks}}' \
<container_name>

docker image inspect <image_name>:<tag> \
  --format '{{json .RepoDigests}}'

docker inspect可能包含环境变量、连接地址或敏感配置,备份文件应限制权限:

chmod 600 /srv/migration/*-inspect.json

如果业务由Compose管理,还应在项目目录保存原始配置、环境变量文件和密钥引用,并生成一次解析后的配置用于核对:

docker compose config > /srv/migration/compose-resolved.yaml
chmod 600 /srv/migration/compose-resolved.yaml

解析后的文件可能包含环境变量中的密码,不应直接上传到公开位置或提交到代码仓库。

区分不同数据类型的迁移方式

不同数据不能套用同一种复制方法。建议建立如下迁移清单:

数据或依赖常见位置推荐迁移方式主要验证点
应用镜像本地镜像或镜像仓库固定摘要拉取,或docker save后导入镜像摘要、架构、启动命令
命名卷Docker volume停止写入后归档恢复文件数量、权限、应用可读写
绑定挂载主机目录rsync或归档复制路径、属主、扩展属性
数据库数据库卷或外部数据库优先使用逻辑备份和恢复表数量、行数、关键业务数据
配置文件项目目录、挂载目录加密或受限传输环境变量、证书、连接地址
消息队列、缓存命名卷或外部服务按组件特性迁移队列积压、缓存失效影响
定时任务和后台进程Compose、宿主机计划任务单独核对并避免重复运行执行时间、幂等性、重复消费

数据库版本发生变化时,直接复制数据库数据目录存在较大风险。例如,源端和目标端的数据库主版本不同,底层数据文件可能不兼容。此时应采用源版本导出、目标版本导入的方式,而不是直接复制数据库卷。

变更准备:备份、传输和目标端预检

先定义停机和写入冻结范围

迁移前应明确以下对象:

  • 哪些域名或入口会切换到目标服务器;
  • 哪些容器会停止写入;
  • 数据库是否由容器管理;
  • 上传文件、消息队列和后台任务是否会产生持续变化;
  • DNS、负载均衡或上游系统的切换时间;
  • 目标端验证期间是否允许真实请求进入。

如果源端和目标端同时运行两个会写入同一业务的数据副本,容易产生双写、重复消费或数据分叉。除非已经设计了复制和冲突处理机制,否则目标端验证阶段应使用隔离域名、内网访问或维护页面,不要让两个环境同时接收生产写请求。

备份数据库和文件数据

对于数据库,先执行逻辑备份,再处理数据库卷。以下命令仅为示例,数据库容器名称、账号和库名需要替换为实际值。

PostgreSQL可以使用自带的pg_dump:

docker exec -t <postgres_container> \
  pg_dump -U <db_user> -d <db_name> --format=custom \
  > /srv/migration/<db_name>-before-migration.dump

MySQL或兼容数据库可以使用一致性导出参数:

docker exec <mysql_container> sh -c \
'exec mysqldump -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" \
--single-transaction --routines --triggers "$MYSQL_DATABASE"' \
> /srv/migration/<db_name>-before-migration.sql

实际环境中不要把生产密码直接写入命令行。应使用容器已有的安全环境变量、凭据文件或临时受限账号,并确认备份文件没有因重定向或权限设置而被普通用户读取。

文件型命名卷需要在停止写入后归档。先查看卷的实际路径:

docker volume inspect app_data

确认业务容器已经停止写入后,可以按卷路径创建归档:

SRC_VOL=$(docker volume inspect -f '{{.Mountpoint}}' app_data)

sudo tar --xattrs --acls --numeric-owner \
  -czf /srv/migration/app_data.tar.gz \
  -C "$SRC_VOL" .

如果使用的是绑定挂载目录,不要把目录名称误当成Docker卷。应根据docker inspect中的Source字段复制:

sudo rsync -aHAX --numeric-ids --info=progress2 \
  /srv/app/uploads/ \
  /srv/migration/uploads/

--numeric-ids适用于需要保留UID和GID的场景,但目标主机上的用户编号必须与容器内实际使用方式匹配。若目标服务器用户编号不同,应在恢复后通过应用容器的实际用户身份验证读写权限,而不是盲目修改属主。

校验备份是否可用

备份文件存在,不代表备份可以恢复。至少应记录文件大小和校验值:

sha256sum \
  /srv/migration/<db_name>-before-migration.dump \
  /srv/migration/<db_name>-before-migration.sql \
  /srv/migration/app_data.tar.gz

校验文件也应随备份一起传输:

sha256sum -c /srv/migration/SHA256SUMS

更稳妥的做法是在备用环境或目标服务器临时数据库中完成一次恢复演练。对于数据库,重点检查导入是否出现错误、字符集是否一致、关键表是否存在;对于文件卷,至少检查归档能够正常解压、目录结构完整且文件权限可识别。

固定镜像和配置版本

不要只记录latest等可变标签。应记录镜像摘要,或在迁移前将当前镜像导出:

docker image inspect registry.example.com/app:2025.01 \
  --format '{{json .RepoDigests}}'

docker save registry.example.com/app:2025.01 \
  | gzip > /srv/migration/app-2025.01.tar.gz

sha256sum /srv/migration/app-2025.01.tar.gz

目标服务器导入时:

docker load < /srv/migration/app-2025.01.tar.gz

如果使用私有镜像仓库,应在目标端按固定摘要拉取,而不是只执行不带版本约束的镜像拉取。Compose文件、.env、证书、反向代理配置和宿主机计划任务也要分别归档,并标明其对应的应用版本。

分步实施:先恢复数据,再启动业务

1. 进入变更窗口并冻结写入

切换前先停止入口流量或启用维护页面,再按依赖关系停止应用、后台任务和消费者。数据库在完成最终逻辑备份前不应直接关闭或复制数据目录。

docker compose stop app worker

上述服务名只是示例,应替换为实际Compose服务。停止后检查是否仍有容器或进程写入目标目录:

docker ps
sudo lsof +D /srv/app/uploads

lsof +D在大目录上可能耗时,生产环境应根据目录规模选择更合适的检查方式。确认没有持续写入后,再执行最终备份或增量同步。

2. 在目标服务器导入镜像和配置

先创建迁移目录并限制访问:

sudo install -d -m 700 /srv/migration

通过受控的SSH、专用存储或企业文件传输方式传递备份和配置。传输完成后,在目标端重新计算校验值:

sha256sum /srv/migration/app-2025.01.tar.gz
sha256sum /srv/migration/app_data.tar.gz

校验一致后导入镜像:

docker load < /srv/migration/app-2025.01.tar.gz

然后核对目标端Compose解析结果:

docker compose config

重点检查:

  • 镜像版本是否与源端一致;
  • 卷挂载目标路径是否一致;
  • 数据库连接地址是否已经改为目标环境;
  • 端口是否与目标主机冲突;
  • 外部服务、证书和密钥是否指向正确环境;
  • 是否误把源服务器的测试参数或临时地址带入生产配置。

3. 恢复命名卷和绑定目录

目标端创建同名卷:

docker volume create app_data

DST_VOL=$(docker volume inspect -f '{{.Mountpoint}}' app_data)

sudo tar --xattrs --acls --numeric-owner \
  -xzf /srv/migration/app_data.tar.gz \
  -C "$DST_VOL"

恢复时不要让业务容器同时挂载并修改该卷。恢复完成后,先确认目录结构和权限:

sudo find "$DST_VOL" -maxdepth 2 -type d | head
sudo stat "$DST_VOL"

如果使用绑定挂载,则应先创建目标目录,再同步文件:

sudo install -d -m 750 /srv/app/uploads

sudo rsync -aHAX --numeric-ids \
  /srv/migration/uploads/ \
  /srv/app/uploads/

启用了SELinux或其他强制访问控制的系统,还要检查目录标签是否允许容器访问。不要为了省事对整个文件系统执行宽泛的权限放开操作;应根据该目录是否仅供一个容器使用,选择符合系统策略的挂载标记或安全上下文。

4. 按依赖顺序恢复数据库和应用

数据库迁移通常有两种路径:

  • 数据库版本兼容、停机窗口较短:在目标端恢复经过一致性保护的数据库卷,但仍应保留逻辑备份;
  • 数据库主版本变化或存储格式可能变化:创建目标版本数据库,使用逻辑备份导入,再进行应用层验证。

不要把“复制数据库目录后容器能启动”作为迁移成功标准。数据库启动后,还要检查升级日志、表结构、字符集、索引和用户权限。

应用可以使用固定镜像和明确卷映射,例如:

services:
  app:
    image: registry.example.com/app@sha256:replace-with-verified-digest
    env_file:
      - .env
    volumes:
      - app_/var/lib/app
    depends_on:
      db:
        condition: service_healthy

volumes:
  app_

这是结构示例,实际字段应以业务配置为准。目标端先启动数据库或其他基础服务,再启动应用:

docker compose up -d db
docker compose ps
docker compose up -d app worker

如果Compose文件没有健康检查,depends_on不一定能保证数据库已经可用,应通过应用实际连接结果或数据库探针确认。迁移期间不要使用会删除卷的命令:

# 不要在生产迁移中随意执行
docker compose down -v

该命令可能删除Compose管理的命名卷,回退所需的数据也可能因此丢失。

5. 通过隔离入口完成首次业务验证

目标端容器启动后,先使用内网地址、临时域名或负载均衡器的单节点权重访问。此阶段不宜直接修改正式DNS或让全部生产流量进入。

通过隔离入口完成首次业务验证配图

确认应用能正常读取历史数据、创建临时测试记录、访问数据库和读取上传文件后,再安排正式流量切换。对于会触发扣费、通知、发货或外部回调的业务,测试应使用专门的测试对象,避免产生不可逆的真实动作。

验证与观察:分别检查容器、数据和业务

基础运行检查

docker compose ps
docker compose logs --since=10m --no-color app
docker inspect -f '{{.State.Status}} {{.State.Health.Status}}' <container_name>
docker stats --no-stream

没有健康检查配置时,Health可能为空,不能据此判断失败;应结合进程状态、应用日志和健康接口判断。

如果应用提供健康接口,可以从目标主机测试:

curl -fsS http://127.0.0.1:8080/healthz

端口和反向代理也要单独核对:

ss -lntp
curl -I http://<temporary-hostname>/

常见问题包括容器内监听地址仍为127.0.0.1、目标端口被其他服务占用、反向代理上游地址未更新,以及证书或跨域配置仍指向旧环境。

数据完整性检查

数据验证应至少覆盖以下层次:

验证层次检查内容通过依据
文件层目录、文件数量、关键文件、权限和属主结构完整,应用用户可读写
数据库层表、索引、关键表行数、最近业务记录无导入错误,关键数据可查询
应用层登录、查询、上传、下载、后台任务业务路径返回预期结果
外部依赖数据库、缓存、队列、对象存储、回调接口连接成功且无持续重试
运行层CPU、内存、磁盘、连接数、错误率在变更前基线或约定阈值内

文件数量只能作为辅助指标,不能代替内容校验。对关键配置、证书和少量代表性业务文件,应分别检查内容摘要和权限。数据库则应选择订单、账户、内容等关键表做行数或抽样核对,不能只查看数据库进程是否处于运行状态。

观察应用行为和后台任务

正式流量切换后,持续观察:

  • HTTP 4xx、5xx错误率和接口延迟;
  • 数据库连接数、慢查询、锁等待和磁盘增长;
  • 消息队列积压、重复消费和失败重试;
  • 上传文件是否写入正确卷;
  • 定时任务是否在目标端运行,源端是否已经停止;
  • 外部回调、邮件、短信或支付接口是否出现重复触发;
  • Docker和宿主机日志中是否出现权限、挂载、DNS或证书错误。

观察时间不应只按“容器启动后几分钟”计算。高频业务可先设置30至60分钟的初步观察窗口;包含小时级、日级定时任务的业务,应覆盖至少一个相关任务周期。具体时长应根据业务峰值、数据写入速度和外部依赖的响应周期确定。

回滚条件:切换后不要直接启动旧容器

预先定义触发条件

回滚条件应采用变更前基线,而不是凭感觉判断。以下是可调整的示例:

现象示例触发条件处理方向
容器持续重启关键服务连续5分钟无法保持运行停止继续放量,检查镜像、配置和依赖
数据不一致关键表、关键文件或校验结果无法解释立即冻结写入,保留目标数据现场
业务错误增加5xx持续超过变更前基线,或关键接口不可用切回流量并评估数据回退
队列异常积压持续增长或出现重复消费停止消费者,避免扩大影响
资源异常磁盘快速耗尽、内存持续回收、数据库连接耗尽暂停切换或回退到已知稳定环境
外部副作用出现重复通知、重复扣费或重复回调立即停止相关任务,按业务预案处理

阈值只是示例,正式变更前应结合源环境的平均值、峰值和告警规则确定。对数据损坏、重复扣费等不可逆风险,不应等待观察窗口结束后再处理。

切换前失败的回退

如果目标端尚未接收真实写请求,回退相对简单:

  1. 停止目标端应用和后台任务,保留目标卷和日志,不要立即删除。
  2. 将入口流量恢复到源服务器。
  3. 启动源端原有服务,确认源端数据库和文件仍可读写。
  4. 检查源端关键接口和后台任务,确认没有重复运行。
  5. 记录目标端失败原因,修复后重新执行迁移。

示例命令如下,服务名需要按实际环境替换:

docker compose stop app worker

源端恢复时,不应直接执行数据清理操作。目标端的卷、导入数据库和日志应保留到问题分析和变更复盘完成之后。

切换后已经产生新数据的回退

如果目标端已经处理了真实请求,不能简单地把流量切回源端并启动旧容器。此时目标端可能已经产生新订单、新文件、队列消费记录或数据库变更,源端数据会落后。

应按数据类型选择策略:

切换后已经产生新数据的回退配图

  • 数据库:冻结目标端写入后,使用经过验证的反向同步、增量导出,或恢复切换前备份并接受明确的数据时间窗口;
  • 上传文件:记录目标端新增文件,完成反向同步并校验后再恢复源端;
  • 消息队列:暂停消费者,确认消息是否已经确认、重复投递或丢失;
  • 不可逆业务动作:立即停止相关任务,按照业务补偿流程处理;
  • 发生数据库结构升级:不能只替换回旧镜像,必要时恢复旧数据库备份或使用已经验证过的降级方案。

如果没有经过演练的双向同步或增量回退方案,最安全的处理通常是先冻结写入、保留目标现场,再由变更负责人根据数据恢复点决定是否恢复备份,而不是在生产环境中临时执行数据库目录覆盖。

观察窗口与变更关闭

迁移只有在数据核对、关键业务验证、后台任务检查和观察窗口均通过后才能关闭。关闭前应确认源服务器已经停止生产写入,目标端的镜像摘要、配置版本、数据备份位置和监控对象已经登记,并保留源端可回退状态一段约定时间。

在观察期内,只要出现关键数据不一致、核心接口持续失败、队列积压扩大、资源耗尽或不可逆业务副作用,应立即冻结目标端写入并触发回滚评估。观察期结束后也不要直接删除旧卷和旧备份,应按数据保留周期归档;只有在新环境连续覆盖一个完整业务周期且回退条件不再满足时,才适合完成迁移收尾。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8348.html

相关推荐