容器与云原生 / 系统课时

配置 Compose 数据卷

配置 Compose 数据卷

本节解决 Compose 服务重建后数据如何保留的问题。你将分别用命名卷保存数据库数据、用绑定挂载映射应用文件,并通过实际重建容器验证两种挂载的行为差异。

学习目标

  • 在 Compose 文件中声明并挂载命名卷
  • 使用绑定挂载把宿主机目录映射到容器
  • 验证容器重建后数据是否按预期保留

区分两种持久化方式

命名卷由 Docker 管理实际存储位置,适合数据库等不希望直接依赖宿主机目录结构的数据。Compose 顶层 volumes 用来声明卷,服务再通过 volumes 把它挂载到容器目录。

绑定挂载则直接使用宿主机路径,例如把项目中的 ./html 映射到 Nginx 的站点目录。宿主机文件修改后,容器会立即看到变化,因此更适合开发源码、配置文件和需要人工管理的目录。

声明命名卷和绑定挂载

下面的 compose.yaml 同时启动 PostgreSQL 和 Nginx。数据库目录使用命名卷 db-data,Web 文件则从当前项目的 ./html 绑定到容器中,并设置为只读。

yaml
services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_PASSWORD: example
    volumes:
      - db-data:/var/lib/postgresql/data

  web:
    image: nginx:1.27-alpine
    volumes:
      - ./html:/usr/share/nginx/html:ro

volumes:
  db-data:

这里的 db-data 会创建项目作用域内的命名卷;./html 是相对路径,通常相对于 Compose 项目的基础目录解析。:ro 表示容器只能读取绑定目录,不能通过该挂载修改宿主机内容。

验证绑定挂载

先准备宿主机目录并启动服务,再直接从 Web 容器读取映射后的文件。

bash
mkdir -p html
printf 'bind-mount-ok\n' > html/index.html
docker compose up -d >/dev/null 2>&1
docker compose exec web cat /usr/share/nginx/html/index.html

预期输出

text
bind-mount-ok

如果修改宿主机的 html/index.html 后再次执行 cat,无需重新构建镜像就能看到新内容。这正是绑定挂载适合开发文件和外部配置的原因。

验证命名卷持久化

接下来在 PostgreSQL 数据目录写入一个验证文件,然后删除并重新创建容器。这里使用普通的 docker compose down,不会主动删除命名卷。

bash
docker compose exec db sh -lc 'printf "named-volume-ok\n" > /var/lib/postgresql/data/volume-check.txt'
docker compose down >/dev/null 2>&1
docker compose up -d >/dev/null 2>&1
docker compose exec db cat /var/lib/postgresql/data/volume-check.txt

预期输出

text
named-volume-ok

容器已经重新创建,但文件仍然存在,说明数据保存在命名卷中而不是旧容器的可写层。实际生成的容器名、卷名等会受 Compose 项目名影响。

删除数据时注意边界

docker compose down 默认删除容器和网络,但保留命名卷;如果使用 docker compose down -v,Compose 声明的命名卷也会被删除。对数据库执行该操作前应确认数据已经备份。

绑定挂载不受 down -v 管理。即使容器和 Compose 项目被删除,./html 中的宿主机文件仍然存在,需要由宿主机上的文件管理流程自行清理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 Compose 数据卷

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通