PostgreSQL / 系统课时

容器化实验环境

容器化实验环境

本节搭建一个可重复创建、保留数据、彻底重置的 PostgreSQL 18 实验实例。最终得到一份 compose.yaml、一个命名数据卷和一组初始化 SQL,并能验证“重启保留数据、删卷重新初始化”的边界。

学习目标

  • 用 Docker Compose 启动 PostgreSQL 18,并把宿主机端口与容器端口分离。
  • 使用命名卷保存数据库文件,使用初始化目录创建固定实验对象。
  • 验证持久化行为,并掌握安全重置实验环境的方法。

设计实验目录

准备一个独立目录,并把初始化脚本放进 init 子目录。命名卷由 Docker 管理,不需要手工创建宿主机数据目录。

bash
mkdir -p pg18-lab/init
cd pg18-lab
pwd

预期输出

text
<PATH>/pg18-lab

<PATH> 是你的实际父目录。整个实验由三个对象协作:Compose 定义容器,命名卷保存数据库文件,init 目录只在数据库首次初始化时注入 SQL。

PostgreSQL 18 容器、数据卷与初始化脚本的关系

编写 Compose 配置

创建 compose.yaml。PostgreSQL 18 的官方容器建议把持久卷挂载在 /var/lib/postgresql,让镜像在其下使用版本相关的数据目录;这与早期版本常见的 /var/lib/postgresql/data 挂载方式不同。

yaml
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 缩进或字段拼写错误直接进入启动阶段。

bash
docker compose config -q && echo compose-ok

预期输出

text
compose-ok

编写初始化脚本

在 init/001-schema.sql 写入一个最小探针表。初始化脚本会按文件名顺序执行,因此使用数字前缀能让后续扩展保持稳定顺序。

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 也能完成健康检查。

bash
docker compose up -d --wait >/dev/null 2>&1
docker compose exec -T postgres pg_isready -U lab_user -d labdb

预期输出

text
/var/run/postgresql:5432 - accepting connections

再直接在容器内查询初始化数据,确认 SQL 已经真正进入数据库,而不只是文件存在于宿主机。

bash
docker compose exec -T postgres psql -U lab_user -d labdb -c "SELECT id, note, created_at FROM lab_probe;"

预期输出

text
 id |    note     |      created_at
----+-------------+------------------------
  1 | initialized | <TIME>
(1 row)

<TIME> 是首次初始化时写入的实际时间。宿主机若已经安装 psql,也可以通过 127.0.0.1:55432 连接;容器内部仍监听 5432,因此两处端口不要混淆。

验证持久化与重置边界

普通停止和重建容器不会删除命名卷,所以初始化数据应继续存在。下面先销毁容器但保留卷,再重新创建并查询同一行。

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

预期输出

text
 id |    note
----+-------------
  1 | initialized
(1 row)

需要从零重做实验时,才删除命名卷。这个操作会永久删除当前实验库中的全部数据,并使下一次启动重新执行 init 目录中的脚本。

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

预期输出

text
 id |    note
----+-------------
  1 | initialized
(1 row)

这时表虽然再次出现,但来源是新数据卷上的重新初始化,而不是旧数据被“恢复”。掌握“容器可重建、卷负责持久化、初始化脚本只作用于空卷”这三个边界,实验环境才真正具备可重复性。

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

目录与阅读设置

阅读设置

17

记录一个想法

容器化实验环境

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

登录哪都通