容器与云原生 / 系统课时
配置数据库服务和持久化
配置数据库服务和持久化
数据库容器最容易出现的误区,是容器能启动就认为数据安全。本篇把 PostgreSQL 的初始化变量、内部端口、命名 Volume 和健康检查放在一起配置,并通过重建容器验证数据仍然存在。
学习目标
- 正确设置 PostgreSQL 初始化环境变量
- 使用命名 Volume 保存数据库数据目录
- 验证容器重建后数据仍可读取
配置数据库服务
官方 PostgreSQL 镜像会在数据目录为空时根据 POSTGRES_DB、POSTGRES_USER 和 POSTGRES_PASSWORD 完成首次初始化。这些变量主要影响首次创建数据库集群;已有 Volume 再次挂载时,修改它们不会自动重建现有用户或数据库。
下面的 compose.yaml 只定义数据库,适合单独练习持久化行为。
services:
db:
image: postgres:17-alpine
environment:
POSTGRES_DB: app
POSTGRES_USER: app
POSTGRES_PASSWORD: dev-password
expose:
- "5432"
volumes:
- db-data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app -d app"]
interval: 5s
timeout: 3s
retries: 10
restart: unless-stopped
volumes:
db-data:expose: "5432" 用于声明容器内部服务端口,不会把数据库发布到宿主机;同一 Compose 网络中的其他服务即使不写 expose,也可以通过 db:5432 连接。只有确实需要从宿主机数据库客户端直连时,才考虑额外配置 ports。
Volume 为什么挂到这个目录
对 PostgreSQL 17 官方镜像,数据库集群位于 /var/lib/postgresql/data。命名 Volume db-data 的生命周期独立于单个容器,所以执行普通的 docker compose down 删除容器后,数据仍保留在 Volume 中。
验证容器重建后数据仍存在
下面的命令先启动数据库并写入一条探针数据,再删除容器、重新创建数据库容器,最后读取同一条记录。健康检查配合 --wait,避免在 PostgreSQL 尚未就绪时执行 SQL。
docker compose up -d --wait db >/dev/null
docker compose exec -T db psql -U app -d app -v ON_ERROR_STOP=1 -c "CREATE TABLE IF NOT EXISTS persist_probe (id integer PRIMARY KEY, note text NOT NULL);" -c "INSERT INTO persist_probe(id, note) VALUES (1, 'persisted') ON CONFLICT (id) DO UPDATE SET note = EXCLUDED.note;" >/dev/null
docker compose down >/dev/null
docker compose up -d --wait db >/dev/null
docker compose exec -T db psql -U app -d app -tAc "SELECT note FROM persist_probe WHERE id = 1;"预期输出
persisted首次运行如果本机没有镜像,Docker 还可能显示拉取进度;关键验证结果是最后能够读到 persisted。这说明被删除和重新创建的是容器,而数据库文件仍由 db-data 保存。
什么时候需要发布数据库端口
应用与数据库都在同一 Compose 项目中时,优先使用 db:5432,不要为了“能连上”就映射 5432:5432。发布端口会扩大可访问边界,也容易和宿主机已有数据库冲突。
如果本地开发确实需要用宿主机上的 GUI 客户端调试,可以临时增加端口映射,并限制到本机地址,例如 127.0.0.1:5432:5432。生产环境则应根据网络边界和访问控制单独设计,而不是默认公开数据库端口。