PostgreSQL / 系统课时
容器化实验环境
容器化实验环境
本节搭建一个可重复创建、保留数据、彻底重置的 PostgreSQL 18 实验实例。最终得到一份 compose.yaml、一个命名数据卷和一组初始化 SQL,并能验证“重启保留数据、删卷重新初始化”的边界。
学习目标
- 用 Docker Compose 启动 PostgreSQL 18,并把宿主机端口与容器端口分离。
- 使用命名卷保存数据库文件,使用初始化目录创建固定实验对象。
- 验证持久化行为,并掌握安全重置实验环境的方法。
设计实验目录
准备一个独立目录,并把初始化脚本放进 init 子目录。命名卷由 Docker 管理,不需要手工创建宿主机数据目录。
mkdir -p pg18-lab/init
cd pg18-lab
pwd预期输出
<PATH>/pg18-lab<PATH> 是你的实际父目录。整个实验由三个对象协作:Compose 定义容器,命名卷保存数据库文件,init 目录只在数据库首次初始化时注入 SQL。

编写 Compose 配置
创建 compose.yaml。PostgreSQL 18 的官方容器建议把持久卷挂载在 /var/lib/postgresql,让镜像在其下使用版本相关的数据目录;这与早期版本常见的 /var/lib/postgresql/data 挂载方式不同。
services:
postgres:
image: postgres:18
container_name: pg18-lab
environment:
POSTGRES_DB: labdb
POSTGRES_USER: lab_user
POSTGRES_PASSWORD: ChangeMe_18!
ports:
- "55432:5432"
volumes:
- pg18-data:/var/lib/postgresql
- ./init:/docker-entrypoint-initdb.d:ro
healthcheck:
test: ["CMD-SHELL", "pg_isready -U lab_user -d labdb"]
interval: 5s
timeout: 3s
retries: 10
volumes:
pg18-data:这是实验配置,明文密码便于跟做;团队环境应改用受控的环境变量或密钥管理。先让 Compose 解析配置,避免因为 YAML 缩进或字段拼写错误直接进入启动阶段。
docker compose config -q && echo compose-ok预期输出
compose-ok编写初始化脚本
在 init/001-schema.sql 写入一个最小探针表。初始化脚本会按文件名顺序执行,因此使用数字前缀能让后续扩展保持稳定顺序。
CREATE TABLE IF NOT EXISTS lab_probe (
id integer PRIMARY KEY,
note text NOT NULL,
created_at timestamptz NOT NULL DEFAULT now()
);
INSERT INTO lab_probe (id, note)
VALUES (1, 'initialized')
ON CONFLICT (id) DO UPDATE
SET note = EXCLUDED.note;这个 SQL 属于初始化文件,不会在当前 Shell 中自动执行;它将在 PostgreSQL 第一次面对空数据卷时由容器入口脚本运行。即使脚本写得幂等,也不能把“每次启动都会执行”当作它的生命周期。
启动并验证实例
启动容器后,用容器内自带的 pg_isready 验证数据库已经接受连接,这样本机即使没有安装 psql 也能完成健康检查。
docker compose up -d --wait >/dev/null 2>&1
docker compose exec -T postgres pg_isready -U lab_user -d labdb预期输出
/var/run/postgresql:5432 - accepting connections再直接在容器内查询初始化数据,确认 SQL 已经真正进入数据库,而不只是文件存在于宿主机。
docker compose exec -T postgres psql -U lab_user -d labdb -c "SELECT id, note, created_at FROM lab_probe;"预期输出
id | note | created_at
----+-------------+------------------------
1 | initialized | <TIME>
(1 row)<TIME> 是首次初始化时写入的实际时间。宿主机若已经安装 psql,也可以通过 127.0.0.1:55432 连接;容器内部仍监听 5432,因此两处端口不要混淆。
验证持久化与重置边界
普通停止和重建容器不会删除命名卷,所以初始化数据应继续存在。下面先销毁容器但保留卷,再重新创建并查询同一行。
docker compose down >/dev/null 2>&1
docker compose up -d --wait >/dev/null 2>&1
docker compose exec -T postgres psql -U lab_user -d labdb -c "SELECT id, note FROM lab_probe;"预期输出
id | note
----+-------------
1 | initialized
(1 row)需要从零重做实验时,才删除命名卷。这个操作会永久删除当前实验库中的全部数据,并使下一次启动重新执行 init 目录中的脚本。
docker compose down -v >/dev/null 2>&1
docker compose up -d --wait >/dev/null 2>&1
docker compose exec -T postgres psql -U lab_user -d labdb -c "SELECT id, note FROM lab_probe;"预期输出
id | note
----+-------------
1 | initialized
(1 row)这时表虽然再次出现,但来源是新数据卷上的重新初始化,而不是旧数据被“恢复”。掌握“容器可重建、卷负责持久化、初始化脚本只作用于空卷”这三个边界,实验环境才真正具备可重复性。