当前位置：首页 > news >正文

在k8s上部署Crunchy Postgres for Kubernetes

news 2025/11/5 4:16:28

一、前言

Crunchy Postgres可以帮助我们在k8s上快速部署一个高可用、具有自动备份和恢复功能的postgres集群。相似的，还有Stolon、Patroni、zalando这几个项目。
每个项目的优缺点可以参考下面这几篇文章，国内关于postgres集群的文章还是太少了
https://www.libhunt.com/compare-patroni-vs-stolon
https://www.simplyblock.io/blog/choosing-a-postgres-kubernetes-operator/
https://blog.palark.com/comparing-kubernetes-operators-for-postgresql/

本篇文章只讨论Crunchy Postgres
官方文档：https://access.crunchydata.com/documentation/postgres-operator/latest
项目地址：https://github.com/CrunchyData/postgres-operator
https://github.com/CrunchyData/postgres-operator-examples

二、安装Crunchy Postgres for Kubernetes

在这里插入图片描述
根据你的k8s版本选择合适的Crunchy Postgres版本。跟着官方文档的quickstart走，他会让你fork最新的版本，这是有问题的。由于当时我需要5.3.2的版本，所以我只能看哪个账号是fork了5.3.2的postgres-operator-examples，然后再从他那里下载。这里感觉Crunchy Postgres这个项目的版本管理挺乱的。然后下载解压到服务器上。后面的命令默认都是再“postgres-operator-examples/”路径下执行

使用helm安装pgo，安装后环境就搭建好了。

#安装pgoperator
helm install pgoperator  oci://registry.developers.crunchydata.com/crunchydata/pgo -n your_namespace --set singleNamespace=true --version 5.3.2
#删除pgoperator
helm delete pgoperator -n your_namespace

三、部署一个简单的postgres集群

执行命令，就可以部署一个简单的集群了

helm  install hippo helm/postgres  --namespace your_namespace

查看

helm ls -n your_namespace

删除集群

helm delete hippo -n your_namespace

当然，也可以根据自己的需要部署一个个性化的集群，具体方法是修改helm/postgres/value.yaml文件。例如：
在这里插入图片描述
另外，如果你想要在k8s集群外连接postgres，最好增加一个NodePort以暴露一个端口访问

修改value.yaml文件后，用如下命令升级

helm  upgrade hippo helm/postgres --namespace your_namespace

也可以先用下面的命令看配置文件是否有问题

helm  upgrade hippo helm/postgres --debug --dry-run --namespace your_namespace

部署有三个节点的集群后，用如下命令查看主节点和从节点

kubectl get pods -n your_namespace -L postgres-operator.crunchydata.com/role

集群部署后，会生成5个service，每个service的作用可以参考这个连接
https://github.com/CrunchyData/postgres-operator/issues/3784

每个postgres节点通过各自的statefulset进行管理，所以如果有三个postgres节点，就会有三个statefulset。查看statefulset列表

kubectl get statefulset -n your_namespace

我们可以通过statefulset配置文件从而修改节点的信息。例如，容器中的系统的默认时区是UTC
，而我们在东八区。所以我们需要调整系统的时区。但是Crunchy目前还不支持在helm/postgres/value.yaml修改环境变量，所以只能在部署集群后再通过statefulset来修改环境变量。

kubectl edit statefulset hippo-pgha1-lvr7 -n your_namespace

在每个容器的环境变量中增加

- name: TZvalue: Asia/Shanghai

参考：
https://github.com/CrunchyData/postgres-operator/issues/3054
https://www.cnblogs.com/saneri/p/16326567.html

四、增加pgbouncer

PGBouncer是一个轻量级的PostgreSQL数据库连接池，主要用于减少数据库服务器的连接压力，提高数据库的处理能力。
特点：
连接池：维护到PostgreSQL数据库的连接池，允许多个客户端复用已建立的连接，减少连接和断开连接的开销。
轻量级：占用资源极少，可以在几乎不影响系统性能的情况下提供连接池服务。
配置灵活：支持不同的池化模式，以适应不同的使用场景。
高性能：减少了连接建立的开销，提高应用程序的响应速度和吞吐量。
安全性：支持TLS/SSL连接，确保数据传输过程中的安全。
易于管理：提供简单的管理接口，便于监控和管理连接池状态。

同样，我们也在helm/postgres/value.yaml进行修改就可以为集群增加一个pgbouncer
在这里插入图片描述
注意：Crunchy里面的pgbouner默认是连接主数据库的，而databases的配置项是让pgbouncer连接hippo-replaces服务，从而连接从库。global配置项是参考这里添加的。更多的用法可以参考下面这几个链接：
https://github.com/CrunchyData/postgres-operator/issues/1411
https://github.com/CrunchyData/postgres-operator/issues/1499
https://github.com/CrunchyData/postgres-operator/issues/2675
https://github.com/CrunchyData/postgres-operator/issues/3025
https://github.com/CrunchyData/postgres-operator/issues/3123

五、数据备份

以存储在minio作为例子
首先，需要部署一个带tls的minio，部署方法可以参考我写的另外一篇文章：在k8s上部署minio
虽然项目有有人提到了加repo1-s3-verify-tls="n"来省略tls验证，但好像并没有效果。

然后，需要在minio创建一个桶以及一个Access keys。接着，需要根据Access keys的信息在k8s中创建一个secret。
编辑s3.conf文件
在这里插入图片描述
使用下面命令生成secret

kubectl create secret generic pgo-s3-creds-tls --namespace=your_namespace --from-file=s3.conf=./s3.conf

然后，修改value.yaml文件
在这里插入图片描述
Crunchy是使用pgbackrest工具进行备份与恢复的，可以看到设置了两种备份方法，一种是手动，一种是定期，都是全量备份。另外repo1-s3-uri-style和repo1-path配置项是设置备份数据在桶里面的位置。repo1-retention-full: "14"和repo1-retention-full-type: time的作用是自动删除14天前的备份。
手动备份的命令

kubectl annotate -n your_namespace postgrescluster hippo  --overwrite  postgres-operator.crunchydata.com/pgbackrest-backup="$(date)"

另外，观察当部署集群是，也会自动进行一次全量备份。当进行备时，Crunchy自动创建一个叫hippo-backup的pods来执行备份操作。可以用下面的命令来查看备份情况

kubectl describe postgrescluster hippo -n your_namespace

六、备份恢复

修改value.yaml文件，增加如下配置，启动集群时就会自动调用pgbackrast的pod节点来恢复数据
在这里插入图片描述
恢复过程中可能会遇到各种情况，一下是解决问题所需要用到的只是或者参考资料：
1.了解postgres的timeline、wal的定义：
参考：（1）https://blog.csdn.net/liuhuayang/article/details/136958271
（2）https://www.cnblogs.com/xiaotengyi/p/4665990.html
2.在源postgres集群节点的客户端上执行下面命令查看信息

pg_controldata  //查看当前时间线 wal信息
ls -l $PGDATA/pg_wal/  //查看history的文件
pgbackrest info --stanza=db  //查看历史的备份信息
pg_waldump  //查看wal文件的内容

3.（1）pgbackrast项目官方地址：https://github.com/pgbackrest/pgbackrest
（2）pgbackrast官方文档：https://pgbackrest.org/command.html
（3）案例教学：https://github.com/pgbackrest/pgbackrest/issues/2091

七、postgres配置参数

在这里插入图片描述
TimeZone与log_tiemzone的作用参考参考：https://github.com/CrunchyData/postgres-operator/issues/3344`
其他参数参考：https://zhuanlan.zhihu.com/p/157599782

七、数据导入

需要将单节点的postgres导入带postgres集群，我用下面的方法是可行的

pg_dump -h old_host -U postgres -d database_name -W| psql --single-transaction --no-psqlrc -U postgres

另外，还有其他方法可以导数据，可以参考下面的链接
https://github.com/CrunchyData/postgres-operator/issues/1891
https://github.com/CrunchyData/postgres-operator/issues/2060
https://www.crunchydata.com/blog/performing-a-major-postgresql-upgrade-with-pg_dumpall

目录