boxcutter/postgres

PostgreSQL

镜像概述和主要用途

PostgreSQL（常简称为"Postgres"）是一个对象关系型数据库管理系统（ORDBMS），强调可扩展性和标准合规性。作为数据库服务器，其主要功能是安全存储数据并支持最佳实践，随后根据其他软件应用的请求（无论是同一计算机上的应用还是网络中另一台计算机上的应用，包括互联网）检索数据。它能处理从小型单机应用到具有大量并发用户的大型互联网应用的工作负载。最新版本还提供数据库本身的复制功能，以增强安全性和可扩展性。

本镜像基于 https://github.com/docker-library/postgres 的发布版本打包。

镜像源码：https://github.com/boxcutter/oci/tree/main/postgres

核心功能和特性

• 标准合规：实现了大部分SQL:2011标准
• ACID兼容：支持事务（包括大多数DDL语句），通过多版本并发控制（MVCC）避免锁定问题
• 数据一致性：提供脏读免疫和完全可序列化
• 查询能力：支持复杂SQL查询，提供多种其他数据库中不具备的索引方法
• 高级特性：支持可更新视图、物化视图、触发器、外键
• 扩展性：支持函数和存储过程，拥有大量第三方扩展
• 迁移支持：通过广泛的标准SQL支持和可用迁移工具，支持从主流 proprietary 和开源数据库迁移；通过内置和第三方开源兼容性扩展（如Oracle兼容扩展）可模拟多种proprietary扩展

使用场景和适用范围

适用于需要可靠数据存储和管理的各类应用场景，包括但不限于：

• 小型单机应用的数据持久化
• 企业级应用的事务处理系统
• 大型互联网应用的高并发数据访问
• 需要复杂查询和数据分析的业务系统
• 对数据完整性和安全性有高要求的场景

使用方法和配置说明

通过端口转发到主机的基本操作

启动实例

bash
docker container run \
  --detach \  # 后台运行容器
  --name db \  # 容器名称为db
  --publish 5432:5432 \  # 将容器的5432端口映射到主机的5432端口
  --env POSTGRES_USER=postgres \  # 设置数据库用户名
  --env POSTGRES_PASSWORD=superseekret \  # 设置数据库密码
  docker.io/boxcutter/postgres:15-noble

创建示例数据库

bash
docker container run \
  --interactive --tty \  # 交互式终端
  --env PGPASSWORD=superseekret \  # 设置psql连接密码
  docker.io/boxcutter/postgres:15-noble psql -h host.docker.internal -p 5432 -U postgres

连接成功后，在psql终端中执行以下SQL：

sql
CREATE TABLE employees (
    id SERIAL PRIMARY KEY,
    first_name VARCHAR(50),
    last_name VARCHAR(50),
    email VARCHAR(100),
    hire_date DATE
);

INSERT INTO employees (first_name, last_name, email, hire_date)
VALUES
('John', 'Doe', 'john.doe@example.com', '2023-01-15'),
('Jane', 'Smith', 'jane.smith@example.com', '2023-02-20'),
('Alice', 'Johnson', 'alice.johnson@example.com', '2023-03-10'),
('Bob', 'Brown', 'bob.brown@example.com', '2023-04-05');

select * from employees;

查询结果应显示：

 id | first_name | last_name |           email           | hire_date
----+------------+-----------+---------------------------+------------
  1 | John       | Doe       | john.doe@example.com      | 2023-01-15
  2 | Jane       | Smith     | jane.smith@example.com    | 2023-02-20
  3 | Alice      | Johnson   | alice.johnson@example.com | 2023-03-10
  4 | Bob        | Brown     | bob.brown@example.com     | 2023-04-05
(4 rows)

输入\q退出psql终端。

停止容器

bash
docker container stop db  # 停止容器
docker container rm db    # 删除容器（此操作会丢失数据）

通过用户定义的桥接网络的基本操作

创建用户定义桥接网络

bash
docker network create database-network  # 创建名为database-network的网络
docker network ls  # 查看网络列表

网络列表应显示：

NETWORK ID     NAME               DRIVER    SCOPE
52101a1b9849   bridge             bridge    local
05d8de6c671c   database-network   bridge    local
6a3c6e764f31   host               host      local
b343fc5c797c   none               null      local

在网络上启动实例

bash
docker container run \
    --detach \
    --name db \
    --network database-network \  # 将容器加入database-network网络
    --publish 5432:5432 \
    --env POSTGRES_USER=postgres \
    --env POSTGRES_PASSWORD=superseekret \
    docker.io/boxcutter/postgres:15-noble

可通过docker network inspect database-network查看容器是否已加入网络，在"Containers"部分会显示：

json
"Containers": {
    "3ac279eeed5eac25df31113171d6944d67c81a6e871bdc3e7aa0cba1069f70ba": {
        "Name": "db",
        ....
    }
}

创建示例数据库

在同一网络中，可通过容器名称访问数据库：

bash
docker container run \
    --interactive --tty \
    --network database-network \  # 加入同一网络
    --env PGPASSWORD=superseekret \
    docker.io/boxcutter/postgres:15-noble psql -h db -p 5432 -U postgres  # 使用容器名称db作为主机名

连接成功后输入\q退出psql终端。

持久化数据

Dockerfile中已声明数据卷：

dockerfile
VOLUME /var/lib/postgresql/data

使用数据卷持久化数据

bash
docker volume create pgdata  # 创建名为pgdata的数据卷

docker container run \
    --detach \
    --name db \
    --publish 5432:5432 \
    --env POSTGRES_USER=postgres \
    --env POSTGRES_PASSWORD=superseekret \
    --mount source=pgdata,target=/var/lib/postgresql/data \  # 挂载数据卷
    docker.io/boxcutter/postgres:15-noble

验证数据卷挂载

使用docker inspect db查看挂载情况，在"Mounts"部分应显示：

json
"Mounts": [
    {
        "Type": "volume",
        "Name": "pgdata",
        "Source": "/var/lib/docker/volumes/pgdata/_data",
        "Destination": "/var/lib/postgresql/data",
        "Driver": "local",
        "Mode": "z",
        "RW": true,
        "Propagation": ""
    }
]

查看数据卷内容

可通过Ubuntu容器挂载数据卷查看内容：

bash
docker run -it --rm \
  --mount source=pgdata,target=/var/lib/postgresql/data \
  docker.io/ubuntu ls /var/lib/postgresql/data

清理资源

bash
docker container stop db  # 停止容器
docker container rm db    # 删除容器
docker volume rm pgdata   # 删除数据卷