From b569bbd3bdbbe806d6f2533ff7a1499d2701f83f Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Thu, 27 Feb 2025 14:47:49 +0100 Subject: [PATCH] PG-1346 Release notes 16.8 (#724) PG-1346 Release notes 16.8 new file: docs/release-notes-v16.8.md modified: docs/release-notes.md modified: mkdocs-base.yml modified: variables.yml Signed-off-by: Anastasia Alexadrova --- .github/workflows/main.yml | 8 +++--- docs/apt.md | 2 +- docs/release-notes-v16.8.md | 57 +++++++++++++++++++++++++++++++++++++ docs/release-notes.md | 2 ++ docs/repo-overview.md | 4 +++ docs/yum.md | 2 +- mkdocs-base.yml | 4 ++- requirements.txt | 3 +- variables.yml | 8 +++--- 9 files changed, 78 insertions(+), 12 deletions(-) create mode 100644 docs/release-notes-v16.8.md diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index fb124a1bc..3827dbeb4 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -11,13 +11,13 @@ jobs: steps: #Pull the latest changes - - name: Chekout code - uses: actions/checkout@v2 + - name: Checkout code + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 with: fetch-depth: 0 #Prepare the env - name: Set up Python - uses: actions/setup-python@v2 + uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0 with: python-version: '3.x' @@ -43,7 +43,7 @@ jobs: - name: Deploy docs run: | mike deploy 16 -b publish -p - mike retitle 16 "16.6" -b publish -p + mike retitle 16 "16.8" -b publish -p # - name: Install Node.js 14.x # uses: percona-platform/setup-node@v2 diff --git a/docs/apt.md b/docs/apt.md index 1d50264c4..2685382fd 100644 --- a/docs/apt.md +++ b/docs/apt.md @@ -43,7 +43,7 @@ Run all the commands in the following sections as root or using the `sudo` comma ### Install packages -=== "Install using meta-package" +=== "Install using meta-package (deprecated)" The [meta package](repo-overview.md#percona-ppg-server){:target=”_blank”} enables you to install several components of the distribution in one go. diff --git a/docs/release-notes-v16.8.md b/docs/release-notes-v16.8.md new file mode 100644 index 000000000..9644c782a --- /dev/null +++ b/docs/release-notes-v16.8.md @@ -0,0 +1,57 @@ +# Percona Distribution for PostgreSQL 16.8 ({{date.16_8}}) + +[Installation](installing.md){.md-button} + +--8<-- "release-notes-intro.md" + +This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 16.7](https://www.postgresql.org/docs/16/release-16-7.html) and PostgreSQL 16.8. + +## Release Highlights + +This release fixes [CVE-2025-1094](https://www.postgresql.org/support/security/CVE-2025-1094/), which closed a vulnerability in the `libpq` PostgreSQL client library but introduced a regression related to string handling for non-null terminated strings. The error would be visible based on how a PostgreSQL client implemented this behavior. This regression affects versions 17.3, 16.7, 15.11, 14.16, and 13.19. For this reason, version 16.7 was skipped. + +### Improved security and user experience for Docker images + +* Percona Distribution for PostgreSQL Docker image is now based on Universal Base Image (UBI) version 9, which includes the latest security fixes. This makes the image compliant with the Red Hat certification and ensures the seamless work of containers on Red Hat OpenShift Container Platform. + +* You no longer have to specify the `{{dockertag}}-multi` tag when you run Percona Distribution for PostgreSQL in Docker. Instead, use the `percona/percona-distribution-postgresql:{{dockertag}}`. Docker automatically identifies the architecture of your operating system and pulls the corresponding image. Refer to [Run in Docker](docker.md) for how to get started. + +### PostGIS is included into tarballs + +We have extended Percona Distribution for PostgreSQL tarballs with PostGIS - an open-source extension to handle spacial data. This way you can install and run PostgreSQL as a geospatial database on hosts without a direct access to the Internet. Learn more about [installing from tarballs](tarball.md) and [Spacial data manipulation](postgis.md) + +### Deprecation of meta packages + +[Meta-packages for Percona Distribution for PostgreSQL](repo-overview.md#repository-contents) are deprecated and will be removed in future releases. + +## Supplied third-party extensions + +Review each extension’s release notes for What’s new, improvements, or bug fixes. The following is the list of extensions available in Percona Distribution for PostgreSQL. + +The following is the list of extensions available in Percona Distribution for PostgreSQL. + +| Extension | Version | Description | +| ------------------- | -------------- | ---------------------------- | +| [etcd](https://etcd.io/)| 3.5.18 | A distributed, reliable key-value store for setting up high available Patroni clusters | +| [HAProxy](http://www.haproxy.org/) | 2.8.13 | a high-availability and load-balancing solution | +| [Patroni](https://patroni.readthedocs.io/en/latest/) | 4.0.4 | a HA (High Availability) solution for PostgreSQL | +| [PgAudit](https://www.pgaudit.org/) | 16 | provides detailed session or object audit logging via the standard logging facility provided by PostgreSQL | +| [pgAudit set_user](https://github.com/pgaudit/set_user)| 4.1.0 | provides an additional layer of logging and control when unprivileged users must escalate themselves to superusers or object owner roles in order to perform needed maintenance tasks.| +| [pgBackRest](https://pgbackrest.org/) | 2.54.2 | a backup and restore solution for PostgreSQL | +| [pgBadger](https://github.com/darold/pgbadger) | 13.0 | a fast PostgreSQL Log Analyzer. | +| [PgBouncer](https://www.pgbouncer.org/) | 1.24.0 | a lightweight connection pooler for PostgreSQL | +| [pg_gather](https://github.com/jobinau/pg_gather) | v29 | an SQL script for running the diagnostics of the health of PostgreSQL cluster | +| [pgpool2](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.5.5 | a middleware between PostgreSQL server and client for high availability, connection pooling, and load balancing. | +| [pg_repack](https://github.com/reorg/pg_repack) | 1.5.2 | rebuilds PostgreSQL database objects | +| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | 2.1.0 | collects and aggregates statistics for PostgreSQL and provides histogram information. | +| [pgvector](https://github.com/pgvector/pgvector) | v0.8.0 | A vector similarity search for PostgreSQL | +| [PostGIS](https://github.com/postgis/postgis) | 3.3.8 | a spatial extension for PostgreSQL. | +| [PostgreSQL Commons](https://salsa.debian.org/postgresql/postgresql-common) | 270 | PostgreSQL database-cluster manager. It provides a structure under which multiple versions of PostgreSQL may be installed and/or multiple clusters maintained at one time. | +| [wal2json](https://github.com/eulerto/wal2json) | 2.6 | a PostgreSQL logical decoding JSON output plugin | + + +For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters. + +Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/16/libpq.html) library. It contains "a set of +library functions that allow client programs to pass queries to the PostgreSQL +backend server and to receive the results of these queries." diff --git a/docs/release-notes.md b/docs/release-notes.md index da50d44b3..b09237010 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -1,5 +1,7 @@ # Percona Distribution for PostgreSQL release notes +* [Percona Distribution for PostgreSQL 16.8](release-notes-v16.8.md) ({{date.16_8}}) + * [Percona Distribution for PostgreSQL 16.6](release-notes-v16.6.md) ({{date.16_6}}) * [Percona Distribution for PostgreSQL 16.4](release-notes-v16.4.md) ({{date.16_4}}) diff --git a/docs/repo-overview.md b/docs/repo-overview.md index cd7abae19..c9127039e 100644 --- a/docs/repo-overview.md +++ b/docs/repo-overview.md @@ -12,6 +12,10 @@ Percona Distribution for PostgreSQL provides individual packages for its compone Using a meta-package, you can install all components it contains in one go. +!!! note + + Meta packages are deprecated and will be removed in future releases. + ### `percona-ppg-server` === "Package name on Debian/Ubuntu" diff --git a/docs/yum.md b/docs/yum.md index ee75fe24c..ec62dc962 100644 --- a/docs/yum.md +++ b/docs/yum.md @@ -231,7 +231,7 @@ $ sudo yum -y install curl ### Install packages -=== "Install using meta-package" +=== "Install using meta-package (deprecated)" The [meta package](repo-overview.md#percona-ppg-server){:target=”_blank”} enables you to install several components of the distribution in one go. diff --git a/mkdocs-base.yml b/mkdocs-base.yml index d994a96cc..a08921644 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -112,6 +112,7 @@ plugins: section-index: {} search: separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])' + open-in-new-tab: {} git-revision-date-localized: enable_creation_date: true enabled: !ENV [ENABLED_GIT_REVISION_DATE, True] @@ -131,7 +132,7 @@ plugins: output_path: '_pdf/PerconaDistributionPostgreSQL-16.pdf' cover_title: 'Distribution for PostgreSQL Documentation' - cover_subtitle: 16.6 (December 3, 2024) + cover_subtitle: 16.8 (February 27, 2025) author: 'Percona Technical Documentation Team' cover_logo: docs/_images/Percona_Logo_Color.png debug_html: false @@ -196,6 +197,7 @@ nav: - Uninstall: uninstalling.md - Release Notes: - "Release notes index": "release-notes.md" + - release-notes-v16.8.md - release-notes-v16.6.md - release-notes-v16.4.md - release-notes-v16.3.md diff --git a/requirements.txt b/requirements.txt index f1d3d82d1..031d9e13a 100644 --- a/requirements.txt +++ b/requirements.txt @@ -14,4 +14,5 @@ mkdocs-section-index mkdocs-htmlproofer-plugin mkdocs-meta-descriptions-plugin mike -Pillow > 10.1.0 \ No newline at end of file +Pillow > 10.1.0 +mkdocs-open-in-new-tab \ No newline at end of file diff --git a/variables.yml b/variables.yml index 5df7aa08a..ac6c82c91 100644 --- a/variables.yml +++ b/variables.yml @@ -1,14 +1,14 @@ # PG Variables set for HTML output # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v16.6' -dockertag: '16.6' +release: 'release-notes-v16.8' +dockertag: '16.8' pgversion: '16' -pgsmversion: '2.1.0' - +pgsmversion: '2.1.1' date: + 16_8: 2025-02-27 16_6: 2024-12-03 16_4: 2024-09-10