容器与云原生 / 系统课时

配置数据库服务和持久化

配置数据库服务和持久化

数据库容器最容易出现的误区,是容器能启动就认为数据安全。本篇把 PostgreSQL 的初始化变量、内部端口、命名 Volume 和健康检查放在一起配置,并通过重建容器验证数据仍然存在。

学习目标

  • 正确设置 PostgreSQL 初始化环境变量
  • 使用命名 Volume 保存数据库数据目录
  • 验证容器重建后数据仍可读取

配置数据库服务

官方 PostgreSQL 镜像会在数据目录为空时根据 POSTGRES_DB、POSTGRES_USER 和 POSTGRES_PASSWORD 完成首次初始化。这些变量主要影响首次创建数据库集群;已有 Volume 再次挂载时,修改它们不会自动重建现有用户或数据库。

下面的 compose.yaml 只定义数据库,适合单独练习持久化行为。

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。

bash
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;"

预期输出

text
persisted

首次运行如果本机没有镜像,Docker 还可能显示拉取进度;关键验证结果是最后能够读到 persisted。这说明被删除和重新创建的是容器,而数据库文件仍由 db-data 保存。

什么时候需要发布数据库端口

应用与数据库都在同一 Compose 项目中时,优先使用 db:5432,不要为了“能连上”就映射 5432:5432。发布端口会扩大可访问边界,也容易和宿主机已有数据库冲突。

如果本地开发确实需要用宿主机上的 GUI 客户端调试,可以临时增加端口映射,并限制到本机地址,例如 127.0.0.1:5432:5432。生产环境则应根据网络边界和访问控制单独设计,而不是默认公开数据库端口。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置数据库服务和持久化

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

登录哪都通