ghcr.io/zalando/spilo-16:3.3-p2

Spilo：基于 Docker 的高可用 PostgreSQL 集群

Spilo 是一个捆绑了 PostgreSQL 和 Patroni 的 Docker 镜像。Patroni 是 PostgreSQL 高可用（HA）的模板。多个 Spilo 实例可以创建一个弹性的高可用 PostgreSQL 集群。为此，需要使用相同的 etcd 地址和集群名称启动所有参与的 Spilo 实例。

Spilo 的名称源自格鲁吉亚语 სპილო [spiːlɒ]，意为“大象”。

实际应用与规划

Spilo 目前仍在不断发展：其创建者正在开发一个 Postgres operator，以便在 Kubernetes 环境中更轻松地部署可扩展的 Postgres 集群并执行维护任务。Spilo 将作为此 operator 的核心构建块。目前已有一个 Helm chart，它依赖 Spilo 和 Patroni 在 Kubernetes+Google 计算引擎环境中部署五节点 PostgreSQL 高可用集群。（该 Helm chart 部署的是 Spilo Docker 镜像，而非“裸” Patroni。）

如何使用此 Docker 镜像

[!IMPORTANT] 我们建议用户使用最新标签从源代码自行构建 Docker 镜像，以受益于持续的改进和修复。团队会继续维护项目并解决问题，但不会进行定期发布，也不会发布最新的 Docker 镜像。

Spilo 的设置假定您已正确配置负载均衡器（HAProxy、ELB、Google 负载均衡器），用于将客户端连接定向到主节点。有两种实现方式：A) 如果负载均衡器依赖状态码区分健康节点和故障节点（如 ELB），则需要将其配置为轮询 API URL；否则，B) 可以使用回调脚本动态更改负载均衡器配置。

可用的容器仓库和镜像架构

Spilo 镜像托管在 GitHub 容器仓库（ghcr.io）中。镜像会在打标签时构建并发布为 linux/amd64 和 linux/arm64 架构。当前 PostgreSQL 14 版本的可用镜像可在此处查看：https://github.com/zalando/spilo/pkgs/container/spilo-14

如何构建此 Docker 镜像

$ cd postgres-appliance
$ docker build --tag $YOUR_TAG .

Dockerfile 中定义了一些构建参数，可通过 --build-arg 参数修改：

--build-arg

• WITH_PERL=false # 若要在镜像中安装 perl 和 plperl 包，设为 true
• PGVERSION="12"
• PGOLDVERSIONS="9.5 9.6 10 11"
• DEMO=false # 设为 true 可构建仅在 Kubernetes 上运行的最小镜像
• TIMESCALEDB_APACHE_ONLY=true # 设为 false 可构建 TimescaleDB 社区版（Timescale 许可证）
• TIMESCALEDB_TOOLKIT=true # 设为 false 可跳过安装 TimescaleDB 社区版的工具包。仅当 TIMESCALEDB_APACHE_ONLY=false 时生效
• ADDITIONAL_LOCALES= # 要构建到镜像中的其他 UTF-8 语言环境（示例："de_DE pl_PL fr_FR"）

构建后在本地运行镜像

$ docker run -it your-spilo-image:$YOUR_TAG

查看容器内部

$ docker exec -it $CONTAINER_NAME bash

连接到 PostgreSQL

管理连接

PostgreSQL 默认配置为监听 5432 端口。Spilo 主节点会初始化 PostgreSQL 并创建超级用户和复制用户（默认名为 postgres 和 standby）。

您需要配置 Spilo 为应用创建数据库和角色。例如：

psql -h myfirstspilo.example.com -p 5432 -U admin -d postgres

应用连接

为应用创建数据库和角色后，即可像连接其他 PostgreSQL 集群一样连接 Spilo：

psql -h myfirstspilo.example.com -p 5432 -U wow_app -d wow
psql -d "postgresql://myfirstspilo.example.com:5432/wow?user=wow_app"

配置

Spilo 通过环境变量进行配置。环境变量的值可通过环境手动提供（当 Spilo 作为一组 Docker 容器启动时），或在配置文件/清单中添加（当 Spilo 用于 Docker 编排环境时，如 Kubernetes 或 Docker Compose）。

请点击此处查看环境变量列表。

要通过环境手动提供环境变量进行本地测试：

docker run -it -e YOUR_ENV_VAR=test your-spilo-image:latest

问题反馈与贡献

Spilo 欢迎通过问题跟踪器提问。我们也非常感谢修复、功能请求和更新；提交拉取请求（pull request）前，请参阅我们的贡献者指南。

许可证

本项目采用 Apache 2.0 许可证。