在台湾服务器上用Docker Compose更新应用,如何保留容器中的业务数据?

发布人:A5数据发布时间:2026-11-17 08:59阅读量:2

要在台湾服务器上通过 Docker Compose 更新应用并保留业务数据,关键是让数据库、上传文件等状态存放在独立于容器可写层的持久化存储中,并在升级前制作可验证的备份。常规更新可以拉取新镜像后重建应用容器;不要把“容器不重建”当成保数据的办法,也不要在例行更新时使用 docker compose down -v。

台湾服务器的地域不会改变 Compose 的数据生命周期:命名卷和绑定目录都在宿主机上,服务器重装、磁盘故障或删除卷仍可能造成数据丢失。下面以已有的 Compose 项目为例,说明如何检查挂载、备份、更新和验收。服务名、镜像、数据库类型及容器内路径都应替换成实际值。

更新前确认数据位置

先进入 Compose 文件所在目录,检查当前服务和配置。以下命令适用于 Docker Compose V2:

cd /srv/mysite
docker compose ps
docker compose config -q

config -q 用于校验配置而不打印展开后的内容。若使用了多个 Compose 文件或指定了项目名,后续命令也要带上相同的 -f、-p 参数,否则可能操作到另一个项目。

查看应用容器的挂载:

docker inspect "$(docker compose ps -q app)" \
  --format '{{range .Mounts}}{{println .Type .Name .Source "->" .Destination}}{{end}}'

重点确认业务数据所在的容器路径是否对应到宿主机挂载,例如:

更新前确认数据位置配图

volume mysite_uploads /var/lib/docker/volumes/mysite_uploads/_data -> /var/lib/site/uploads
volume mysite_db_data /var/lib/docker/volumes/mysite_db_data/_data -> /var/lib/postgresql/data

如果业务文件路径没有出现在挂载列表中,数据可能只在容器可写层内。容器一旦被替换,这部分内容通常不会自动转移到新容器。先停写、复制并核验数据,再改 Compose 挂载;不要直接加一个空卷后重建,否则新挂载会遮住原目录内容。

常见存储方式的差别如下:

存储方式数据位置更新容器时的表现适用情况
命名卷Docker 管理的宿主机目录容器重建后,沿用同一个卷即可继续使用数据库目录、应用数据目录
绑定挂载指定的宿主机路径路径和权限不变时,重建后仍可使用上传文件、明确需要由宿主机管理的目录
容器可写层容器自身容器被替换后不应假设数据仍在临时文件、缓存等可重建数据

例如,Compose 中可以用命名卷保存数据库和上传文件:

services:
  app:
    image: registry.example.com/site:${APP_VERSION}
    volumes:
      - uploads:/var/lib/site/uploads

  db:
    image: postgres:16.4
    volumes:
      - db_/var/lib/postgresql/data

volumes:
  uploads:
    name: mysite_uploads
  db_
    name: mysite_db_data

这段配置展示的是挂载关系,不是可直接套用的完整应用配置。镜像名称、容器内路径和卷名必须与现有环境一致。尤其是已有项目:如果当前卷由 Compose 自动命名为类似 项目名_db_data,不要为了“规范命名”直接加上 name: 并重建。Docker 可能因此创建一个新卷,应用看起来能启动,实际却连接到空数据目录。修改前应以容器挂载检查结果为准。

备份数据库和业务文件

先确认备份存放位置有足够空间,并为备份文件限制访问权限:

df -h
docker system df
umask 077
backup_dir=/srv/backups/mysite
mkdir -p "$backup_dir"
stamp=$(date +%F_%H%M%S)

docker system df 可以查看 Docker 使用量,但不要为了腾空间直接运行带 --volumes 的清理命令。需要释放空间时,应先确认待清理对象不是业务卷,也不是唯一一份备份。

数据库备份优先使用数据库自身的导出工具,而不是在数据库仍运行时直接打包其数据目录。以下示例适用于使用官方 PostgreSQL 镜像、且容器内设置了 POSTGRES_USER 和 POSTGRES_DB 的场景:

docker compose exec -T db \
  sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB"' \
  > "$backup_dir/db-${stamp}.sql"

test -s "$backup_dir/db-${stamp}.sql"
ls -lh "$backup_dir/db-${stamp}.sql"

确认备份文件非空只能作为初步检查,不代表一定能恢复。若应用依靠队列、定时任务或多个工作进程写数据库,应在备份窗口内一起暂停这些写入方。也要检查数据库用户是否有导出所需权限;其他数据库产品请改用对应的备份工具。

上传目录若位于命名卷,可以在暂停写入后打包。命令中的卷名须替换成前面查到的真实名称,备份目录必须是宿主机上已存在的绝对路径:

docker run --rm \
  --mount type=volume,src=mysite_uploads,dst=/data,readonly \
  --mount type=bind,src=/srv/backups/mysite,dst=/backup \
  alpine:3.20 \
  sh -c "tar -czf /backup/uploads-${stamp}.tar.gz -C /data ."

ls -lh "$backup_dir/uploads-${stamp}.tar.gz"

如果上传目录是绑定挂载,例如宿主机的 /srv/mysite/uploads,可在停止写入后从宿主机备份:

tar -czf "$backup_dir/uploads-${stamp}.tar.gz" \
  -C /srv/mysite/uploads .

数据库与文件最好使用同一维护窗口的备份。否则,数据库记录可能引用一份文件,而文件备份对应的是另一个时间点。台湾服务器上的本地备份也不能替代异机备份:如果备份与业务数据位于同一块磁盘,磁盘故障可能同时影响两者。异机传输时应保护备份访问权限,并按实际恢复目标保留不同时间点的副本。

备份数据库和业务文件配图

围绕 Compose 应用与业务数据的部署,A5idc数据提供中国台湾台北等地区的物理服务器租用,涵盖不同 CPU、存储配置及优化和国际线路方案,可为应用服务、数据库与上传文件提供相应的计算、磁盘和网络资源。对于同时运行应用与数据服务的业务,这些资源可作为承载容器运行环境及宿主机持久化目录的基础,并能结合业务负载、数据规模与访问区域提供多种配置选择。

拉取镜像并更新应用

先记录当前应用版本,确认要更新的镜像标签;生产环境不宜依赖含义会变化的 latest 标签。使用明确版本可以让回退时更容易找到原镜像,但标签本身仍可能被镜像仓库重新指向。对版本要求严格的环境,可使用镜像摘要固定内容。

修改版本变量后,重新校验 Compose 配置并提前拉取镜像。拉取通常不会停止正在运行的容器,可以先完成这一步,再安排短暂维护窗口:

docker compose config -q
docker compose pull app

若 app 使用本地构建而非远端镜像,应按项目的构建流程生成新镜像,并确认 Compose 中实际引用的是新镜像。不要只在宿主机手动构建一个未被服务配置引用的标签。

在维护窗口中停止应用及其他会写业务数据的服务。下面只列出 app;如果项目还有 worker、定时任务等写入方,也要按实际依赖暂停:

docker compose stop app
docker compose ps

数据库通常保持运行,以便执行逻辑备份;确认它没有被此前的操作停止。完成数据库和文件备份、检查备份文件后,再重建应用服务:

拉取镜像并更新应用配图

docker compose up -d --no-deps app

up 会根据 Compose 配置决定是否创建或替换容器。只要新旧配置使用的是同一份持久化挂载,替换应用容器不会自动清空命名卷。--no-deps 可避免这次更新同时重建依赖服务;前提是数据库等依赖已经正常运行。

如果应用升级需要数据库迁移,应遵循该应用对应版本的迁移步骤,不要猜测迁移命令。迁移可能改变表结构,升级前的数据库备份应保留到验收完成;同时确认新版本是否兼容当前数据库版本。单独更换应用镜像,和升级数据库主版本不是同一件事。例如,PostgreSQL 主版本变化通常需要按其支持的升级路径迁移数据,不能假设只换一个镜像标签并复用原数据目录就能完成升级。

检查更新结果

先查看服务状态和近期日志:

docker compose ps
docker compose logs --since=10m --tail=200 app db

关注容器是否持续重启、数据库是否完成初始化、应用是否连接成功,以及迁移是否报错。如果 Compose 配置设置了健康检查,也要检查服务健康状态。具体健康状态名称取决于服务是否定义了 healthcheck。

再确认新容器仍挂载原来的数据源:

docker inspect "$(docker compose ps -q app)" \
  --format '{{range .Mounts}}{{println .Type .Name .Source "->" .Destination}}{{end}}'

对比更新前记录的卷名、宿主机路径和容器目标路径。只看到容器处于运行状态,并不能证明它接入了原数据;挂载正确、应用可读写以及业务数据可见,才是更有意义的检查。

最后通过应用自己的健康接口或实际业务页面验收。例如,若应用确实提供 /healthz,可在服务器上执行:

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

端口和接口路径需按真实配置替换。还应抽查一条已有业务记录及一份上传文件,并检查创建、读取或访问是否正常。验收时不要为测试方便直接覆盖正式数据。

异常处理与回退边界

如果新容器启动失败,先保留容器和日志,查看失败发生在镜像启动、数据库连接、配置解析还是迁移阶段:

docker compose ps -a
docker compose logs --tail=300 app
docker compose logs --tail=300 db

如果确认只是应用镜像或配置问题,且数据库结构仍兼容旧版本,可把应用版本变量恢复到更新前的值,再拉取并启动旧版应用:

docker compose pull app
docker compose up -d --no-deps app

如果新版本已经执行了数据库迁移,不能仅凭旧镜像能够启动就判断回退安全。先确认应用版本与数据库结构的兼容关系;不兼容时,应从更新前备份恢复到隔离环境验证,而不是直接覆盖生产数据库。恢复数据库会丢弃备份时间点之后的数据,回退前要明确影响范围,并保留更新后的数据副本以便核查。

异常处理与回退边界配图

恢复上传文件也应先还原到临时目录或新卷,检查文件数量、权限和应用可读性,再决定是否切换挂载。不要把恢复操作直接解压到正在使用的业务目录:同名文件可能被覆盖,新增文件也可能与数据库状态不匹配。只有确认恢复点和切换方式后,才调整 Compose 挂载并重启应用。

日常更新中,以下操作尤其需要谨慎:

  • docker compose down -v 会移除 Compose 声明的命名卷和相关匿名卷;除非明确要删除数据且已核实备份,否则不要用于普通升级。
  • docker volume rm、docker volume prune 可能删除仍需要的数据卷。执行前要核对卷名、项目归属和挂载情况。
  • 直接删除宿主机上的卷目录,可能绕过 Docker 管理并造成数据损坏。
  • 在数据库运行时打包其底层数据目录,不应当作数据库逻辑备份的替代方法。
  • 将数据目录改为新卷或新路径时,必须先迁移并核验数据;挂载关系变更后,应用可能会看到一个空目录。

上线验收清单

  • [ ] 更新前已确认数据库、上传文件和其他业务数据的实际挂载位置。
  • [ ] 已记录旧镜像版本、Compose 项目参数和原有卷名。
  • [ ] 数据库备份与文件备份已生成,并检查了文件大小和保存位置。
  • [ ] 应用、工作进程及其他写入服务按需要暂停,备份时间点可对应。
  • [ ] 新容器启动后,挂载源与更新前一致,数据库和应用状态正常。
  • [ ] 业务页面、已有记录和典型文件均通过抽查。
  • [ ] 备份保存在与业务数据分离的位置;恢复步骤和数据覆盖范围已确认。

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

相关推荐