容器与云原生 / 系统课时
配置 Compose 数据卷
配置 Compose 数据卷
本节解决 Compose 服务重建后数据如何保留的问题。你将分别用命名卷保存数据库数据、用绑定挂载映射应用文件,并通过实际重建容器验证两种挂载的行为差异。
学习目标
- 在 Compose 文件中声明并挂载命名卷
- 使用绑定挂载把宿主机目录映射到容器
- 验证容器重建后数据是否按预期保留
区分两种持久化方式
命名卷由 Docker 管理实际存储位置,适合数据库等不希望直接依赖宿主机目录结构的数据。Compose 顶层 volumes 用来声明卷,服务再通过 volumes 把它挂载到容器目录。
绑定挂载则直接使用宿主机路径,例如把项目中的 ./html 映射到 Nginx 的站点目录。宿主机文件修改后,容器会立即看到变化,因此更适合开发源码、配置文件和需要人工管理的目录。
声明命名卷和绑定挂载
下面的 compose.yaml 同时启动 PostgreSQL 和 Nginx。数据库目录使用命名卷 db-data,Web 文件则从当前项目的 ./html 绑定到容器中,并设置为只读。
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 容器读取映射后的文件。
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预期输出
bind-mount-ok如果修改宿主机的 html/index.html 后再次执行 cat,无需重新构建镜像就能看到新内容。这正是绑定挂载适合开发文件和外部配置的原因。
验证命名卷持久化
接下来在 PostgreSQL 数据目录写入一个验证文件,然后删除并重新创建容器。这里使用普通的 docker compose down,不会主动删除命名卷。
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预期输出
named-volume-ok容器已经重新创建,但文件仍然存在,说明数据保存在命名卷中而不是旧容器的可写层。实际生成的容器名、卷名等会受 Compose 项目名影响。
删除数据时注意边界
docker compose down 默认删除容器和网络,但保留命名卷;如果使用 docker compose down -v,Compose 声明的命名卷也会被删除。对数据库执行该操作前应确认数据已经备份。
绑定挂载不受 down -v 管理。即使容器和 Compose 项目被删除,./html 中的宿主机文件仍然存在,需要由宿主机上的文件管理流程自行清理。