# Pigsty v3.1.0

> PG 17 升默认大版本，配置简化，Ubuntu24 与 ARM 支持，Supabase，MinIO 改进

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

**v3\.1\.0 · 2024-11-24**
- [查看发布](https://github.com/pgsty/pigsty/releases/tag/v3.1.0)
- [源码 · tar\.gz](https://github.com/pgsty/pigsty/archive/refs/tags/v3.1.0.tar.gz)
- [源码 · zip](https://github.com/pgsty/pigsty/archive/refs/tags/v3.1.0.zip)
- [pgsty\/pigsty](https://github.com/pgsty/pigsty)

## 亮点特性

- PostgreSQL 17 现已成为默认使用的主要版本 (17.2)
- Ubuntu 24.04 系统支持
- arm 架构支持：EL9, Debian12, Ubuntu 22.04
- Supabase 一键自建，新的剧本 `supabase.yml`
- MinIO 最佳实践改进，配置模板与 Vagrant 模板
- 提供了一系列开箱即用的配置模板与文档说明。
- 允许在 `configure` 过程中使用 `-v|--version` 指定使用的 PG 大版本。
- 调整 PG 默认插件策略：默认安装 `pg_repack`, `wal2json` 以及 `pgvector` 三个关键扩展。
- 大幅简化 `repo_packages` 本地软件源构建逻辑，允许在 `repo_packages` 中使用软件包组别名
- 提供了 Babelfish，IvorySQL，PolarDB 的软件源镜像，简化三者的安装。
- 默认启用数据库校验和。
- 修复 ETCD 与 MINIO 日志面板

## 软件升级

- PostgreSQL 17.2, 16.6, 15.10, 14.15, 13.18, 12.22
- PostgreSQL 扩展版本变动请参考：/ext/
- Patroni 4.0.4
- MinIO 20241107 / MCLI 20241117
- Rclone 1.68.2
- Prometheus: 2.54.0 -> 3.0.0
- VictoriaMetrics 1.102.1 -> 1.106.1
- VictoriaLogs v0.28.0 -> 1.0.0
- vslogcli 1.0.0
- MySQL Exporter 0.15.1 -> 0.16.0
- Redis Exporter 1.62.0 -> 1.66.0
- MongoDB Exporter 0.41.2 -> 0.42.0
- Keepalived Exporter 1.3.3 -> 1.4.0
- DuckDB 1.1.2 -> 1.1.3
- etcd 3.5.16 -> 3.5.17
- tigerbeetle 16.8 -> 0.16.13

## API 变更

- `repo_upstream`：针对每个具体的操作系统发行版生成默认值：[`roles/node_id/vars`](https://github.com/pgsty/pigsty/tree/main/roles/node_id/vars)
- `repo_packages`：允许使用 `package_map` 中定义的别名。
- `repo_extra_packages`：新增未指定时的默认值，允许使用 `package_map` 中定义的别名。
- `pg_checksum`：默认值修改为 `true`，默认打开。
- `pg_packages`：默认值修改为：`postgresql, wal2json pg_repack pgvector, patroni pgbouncer pgbackrest pg_exporter pgbadger vip-manager`
- `pg_extensions`：默认值修改为空数组 `[]`。
- `infra_portal`：允许为 `home` 服务器指定 `path`，替代默认的本地仓库路径 `nginx_home` (`/www`)

## 校验和

```text
e62f9ce9f89a58958609da7b234bf2f2  pigsty-v3.1.0.tgz
```

## 信息来源

- [GitHub Release](https://github.com/pgsty/pigsty/releases/tag/v3.1.0)
- [Pigsty v3.1 发布文章](https://pigsty.cc/blog/pigsty/v3.1/)
- [历史 About / 发布注记](https://pigsty.cc/docs/about/release/#v310)
- [源码对比：`v3.0.4...v3.1.0`](https://github.com/pgsty/pigsty/compare/v3.0.4...v3.1.0)