aarch64/postgres

已弃用

https://hub.docker.com/u/aarch64/ 组织已被弃用，建议使用更具体的 https://hub.docker.com/u/arm64v8/ 组织，具体参见 https://github.com/docker-library/official-images#architectures-other-than-amd64%E3%80%82%E8%AF%B7%E7%9B%B8%E5%BA%94%E8%B0%83%E6%95%B4%E6%82%A8%E7%9A%84%E4%BD%BF%E7%94%A8%E6%96%B9%E5%BC%8F%E3%80%82

支持的标签及对应的 Dockerfile 链接

这些镜像属于实验性质；在 https://github.com/docker-library/official-images/issues/2289%EF%BC%88%E8%BF%99%E6%98%AF%E8%BF%88%E5%90%91 proper multiarch 镜像的第一步）完成之前，它们仅基于尽力而为的原则提供

请不要将它们用于重要事项

此镜像基于同名官方镜像（postgres）的源代码构建。有关相关 Dockerfile 的链接，请参见该镜像的描述。

如果您想了解此镜像的具体差异，请参见 https://github.com/tianon/jenkins-groovy/tree/master/dsl/docker-multiarch/images%EF%BC%8C%E8%BF%99%E4%BA%9B%E8%84%9A%E6%9C%AC%E8%B4%9F%E8%B4%A3%E5%88%9B%E5%BB%BA%E6%9E%84%E5%BB%BA%E5%AE%83%E4%BB%AC%E7%9A%84 Jenkins 任务。

快速参考

• 获取帮助的途径：
  Docker 社区论坛、Docker 社区 Slack 或 Stack Overflow

• 提交问题的位置：
  https://github.com/docker-library/postgres/issues

• 维护者：
  https://github.com/docker-library/postgres

• 已发布镜像制品详情：
  https://github.com/docker-library/repo-info/blob/master/repos/postgres%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/postgres%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/pulls?q=label%3Alibrary%2Fpostgres
  https://github.com/docker-library/official-images/blob/master/library/postgres%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/postgres%EF%BC%89

• 此描述的来源：
  https://github.com/docker-library/docs/tree/master/postgres%EF%BC%88https://github.com/docker-library/docs/commits/master/postgres%EF%BC%89

• 支持的 Docker 版本：
  https://github.com/docker/docker/releases/latest%EF%BC%88%E5%B0%BD%E5%8A%9B%E6%94%AF%E6%8C%81%E4%BD%8E%E8%87%B3 1.6 版本）

什么是 PostgreSQL？

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

PostgreSQL 实现了 SQL:2011 标准的大部分内容，符合 ACID 特性且支持事务（包括大多数 DDL 语句），通过多版本并发控制（MVCC）避免锁定问题，提供对脏读的免疫和完全可序列化；使用许多其他数据库不具备的索引方法处理复杂 SQL 查询；具有可更新视图和物化视图、触发器、外键；支持函数和存储过程以及其他可扩展性，并有大量第三方编写的扩展。除了能够与主要的专有和开源数据库协作外，PostgreSQL 通过其广泛的标准 SQL 支持和可用的迁移工具，支持从这些数据库进行迁移。如果使用了专有扩展，通过其可扩展性，可以通过一些内置和第三方开源兼容性扩展（如针对 Oracle 的扩展）模拟许多功能。

***.org/wiki/PostgreSQL

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/postgres/logo.png

如何使用此镜像

启动 postgres 实例

console
$ docker run --name some-postgres -e POSTGRES_PASSWORD=mysecretpassword -d postgres

此镜像包含 EXPOSE 5432（postgres 端口），因此标准容器链接会使其自动对链接的容器可用。入口点会使用 initdb 创建默认的 postgres 用户和数据库。

postgres 数据库是一个默认数据库，供用户、实用程序和第三方应用程序使用。
postgresql.org/docs

从应用程序连接到它

console
$ docker run --name some-app --link some-postgres:postgres -d application-that-uses-postgres

... 或通过 psql

console
$ docker run -it --rm --link some-postgres:postgres postgres psql -h postgres -U postgres
psql (9.5.0)
Type "help" for help.

postgres=# SELECT 1;
 ?column? 
----------
        1
(1 row)

环境变量

PostgreSQL 镜像使用几个容易被忽略的环境变量。虽然这些变量都不是必需的，但它们可能会极大地帮助您使用该镜像。

POSTGRES_PASSWORD

建议您使用此环境变量来使用 PostgreSQL 镜像。此环境变量设置 PostgreSQL 的超级用户密码。默认超级用户由 POSTGRES_USER 环境变量定义。在上面的示例中，它被设置为“mysecretpassword”。

注意：PostgreSQL 镜像在本地设置了 trust 身份验证，因此您可能会注意到从 localhost（在同一容器内）连接时不需要密码。但是，如果从不同的主机/容器连接，则需要密码。

POSTGRES_USER

此可选环境变量与 POSTGRES_PASSWORD 一起使用，用于设置用户及其密码。此变量将创建具有超级用户权限的指定用户以及同名数据库。如果未指定，则使用默认用户 postgres。

PGDATA

此可选环境变量可用于定义数据库文件的另一个位置（如子目录）。默认值为 /var/lib/postgresql/data，但如果您使用的数据卷是文件系统挂载点（如 GCE 持久磁盘），Postgres initdb 建议创建一个子目录（例如 /var/lib/postgresql/data/pgdata）来包含数据。

POSTGRES_DB

此可选环境变量可用于定义首次启动镜像时创建的默认数据库的不同名称。如果未指定，则使用 POSTGRES_USER 的值。

POSTGRES_INITDB_ARGS

此可选环境变量可用于向 postgres initdb 发送参数。该值是 postgres initdb 期望的以空格分隔的参数字符串。这对于添加数据页校验和等功能非常有用：-e POSTGRES_INITDB_ARGS="--data-checksums"。

POSTGRES_INITDB_XLOGDIR

此可选环境变量可用于定义 Postgres 事务日志的另一个位置。默认情况下，事务日志存储在主 Postgres 数据文件夹（PGDATA）的子目录中。有时，将事务日志存储在不同的目录中可能是可取的，该目录可能由具有不同性能或可靠性特征的存储支持。

任意 --user 注意事项

从 https://github.com/docker-library/postgres/pull/253 开始，此镜像支持通过 docker run 上的 --user 以（大部分）任意用户身份运行。

需要注意的主要 caveat 是，postgres 不关心其运行的 UID（只要 /var/lib/postgresql/data 的所有者匹配），但 initdb 关心（并且需要用户存在于 /etc/passwd 中）：

console
$ docker run -it --rm --user www-data postgres
The files belonging to this database system will be owned by user "www-data".
...

$ docker run -it --rm --user 1000:1000 postgres
initdb: could not look up effective user ID 1000: user does not exist

解决此问题的两种最简单方法：

1. 从主机以只读方式绑定挂载 /etc/passwd（如果您需要的 UID 是主机上的有效用户）：

   console
   $ docker run -it --rm --user "$(id -u):$(id -g)" -v /etc/passwd:/etc/passwd:ro postgres
   The files belonging to this database system will be owned by user "jsmith".
   ...
   

2. 与最终运行时分开初始化目标目录（中间使用 chown）：

   console
   $ docker volume create pgdata
   $ docker run -it --rm -v pgdata:/var/lib/postgresql/data postgres
   The files belonging to this database system will be owned by user "postgres".
   ...
   （一旦成功完成初始化并等待连接，停止它）
   $ docker run -it --rm -v pgdata:/var/lib/postgresql/data bash chown -R 1000:1000 /var/lib/postgresql/data
   $ docker run -it --rm --user 1000:1000 -v pgdata:/var/lib/postgresql/data postgres
   LOG:  database system was shut down at 2017-01-20 00:03:23 UTC
   LOG:  MultiXact member wraparound protections are now enabled
   LOG:  autovacuum launcher started
   LOG:  database system is ready to accept connections
   

如何扩展此镜像

如果您希望在从此镜像派生的镜像中进行额外初始化，请在 /docker-entrypoint-initdb.d 下添加一个或多个 *.sql 或 *.sh 脚本（必要时创建该目录）。入口点调用 initdb 创建默认的 postgres 用户和数据库后，将运行该目录中找到的任何 *.sql 文件并 source 任何 *.sh 脚本，以在启动服务之前进行进一步初始化。

例如，要添加其他用户和数据库，请将以下内容添加到 /docker-entrypoint-initdb.d/init-user-db.sh：

bash
#!/bin/bash
set -e

psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" <<-EOSQL
	CREATE USER docker;
	CREATE DATABASE docker;
	GRANT ALL PRIVILEGES ON DATABASE docker TO docker;
EOSQL

这些初始化文件将按照当前区域设置定义的名称排序顺序执行，默认区域设置为 en_US.utf8。任何 *.sql 文件将由 POSTGRES_USER 执行，默认为 postgres 超级用户。建议 *.sh 脚本中运行的任何 psql 命令都使用 --username "$POSTGRES_USER" 标志以 POSTGRES_USER 身份执行。由于容器内 Unix 套接字连接存在 trust 身份验证，此用户无需密码即可连接。

此外，从 https://github.com/docker-library/postgres/pull/253 开始，这些初始化脚本以 postgres 用户（或 docker run 的 --user 标志指定的“半任意用户”；有关更多详细信息，请参见标题为“任意 --user 注意事项”的部分）身份运行。

您还可以使用简单的 Dockerfile 扩展镜像以设置不同的区域设置。以下示例将默认区域设置设置为 de_DE.utf8：

dockerfile
FROM postgres:9.4
RUN localedef -i de_DE -c -f UTF-8 -A /usr/share/locale/locale.alias de_DE.UTF-8
ENV LANG de_DE.utf8

由于数据库初始化仅在容器启动时发生，这允许我们在创建数据库之前设置语言。

注意事项

如果容器中 postgres 启动时没有数据库，则 postgres 将为您创建默认数据库。虽然这是 postgres 的预期行为，但这意味着在此期间它不会接受传入连接。这在使用自动化工具（如 docker-compose）同时启动多个容器时可能会导致问题。

镜像变体

postgres 镜像有多种风格，每种风格都设计用于特定用例。

postgres:<version>

这是默认镜像。如果您不确定自己的需求，可能需要使用此镜像。它设计为既可作为一次性容器（挂载源代码并启动容器以启动应用程序），也可作为构建其他镜像的基础。

postgres:alpine

此镜像基于流行的 Alpine Linux 项目，可在 https://hub.docker.com/_/alpine 中获取。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常会生成更精简的镜像。

当希望最终镜像大小尽可能小时，强烈推荐此变体。需要注意的主要 caveat 是它使用 musl libc 而不是 glibc 及相关库，因此某些软件可能会根据其 libc 要求的深度而遇到问题。但是，大多数软件对此没有问题，因此此变体通常是非常安全的选择。有关可能出现的问题以及使用基于 Alpine 的镜像的一些优缺点比较，请参见 此 Hacker News 评论线程。

为了最小化镜像大小，在基于 Alpine 的镜像中包含额外的相关工具（如 git 或 bash）并不常见。以此镜像为基础，在您自己的 Dockerfile 中添加所需的内容（如果不熟悉如何安装软件包，请参见 https://hub.docker.com/_/alpine/ 中的示例）。