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 <[email protected]>
percona · Feb 27, 2025 · b569bbd · b569bbd
1 parent f0a9ebc
commit b569bbd
Show file tree

Hide file tree

Showing 9 changed files with 78 additions and 12 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -14,4 +14,5 @@ mkdocs-section-index
 mkdocs-htmlproofer-plugin
 mkdocs-meta-descriptions-plugin
 mike
-Pillow > 10.1.0
+Pillow > 10.1.0
+mkdocs-open-in-new-tab
diff --git 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