From cc71370b28950aec12d8ff5b226d646334dbdc39 Mon Sep 17 00:00:00 2001 From: Anastasia Alexadrova Date: Thu, 30 Jan 2025 14:35:47 +0100 Subject: [PATCH 1/2] PG-1348 Release notes 13.19 modified: .github/workflows/main.yml new file: docs/release-notes-v13.19md modified: docs/release-notes.md modified: mkdocs-base.yml modified: mkdocs-pdf.yml modified: requirements.txt modified: variables.yml --- .github/workflows/main.yml | 6 ++--- docs/release-notes-v13.19md | 50 +++++++++++++++++++++++++++++++++++++ docs/release-notes.md | 2 ++ mkdocs-base.yml | 4 ++- mkdocs-pdf.yml | 2 +- requirements.txt | 3 ++- variables.yml | 5 ++-- 7 files changed, 64 insertions(+), 8 deletions(-) create mode 100644 docs/release-notes-v13.19md diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 82a7e0e63..f43d3f656 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -11,12 +11,12 @@ jobs: steps: #Pull the latest changes - name: Chekout code - uses: actions/checkout@v3 + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 with: fetch-depth: 0 #Prepare the env - name: Set up Python - uses: actions/setup-python@v3 + uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0 with: python-version: '3.x' @@ -44,7 +44,7 @@ jobs: - name: Deploy docs run: | mike deploy 13 -b publish -p - mike retitle 13 "13.18" -b publish -p + mike retitle 13 "13.19" -b publish -p # - name: Install Node.js 14.x # uses: percona-platform/setup-node@v2 diff --git a/docs/release-notes-v13.19md b/docs/release-notes-v13.19md new file mode 100644 index 000000000..5179b55b6 --- /dev/null +++ b/docs/release-notes-v13.19md @@ -0,0 +1,50 @@ +# Percona Distribution for PostgreSQL 13.19 ({{date.13_19}}) + +[Installation](installing.md){.md-button} + +--8<-- "release-notes-intro.md" + +This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 13.18](https://www.postgresql.org/docs/13/release-13-18.html). + +## Release Highlights + +### 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) + +## 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/) | 1.5.2 | 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 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 Common](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 9 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/13/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 ce0f2c6ed..404792448 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 13.19](release-notes-v13.19.md) ({{date.13_19}}) + * [Percona Distribution for PostgreSQL 13.18](release-notes-v13.18.md) ({{date.13_18}}) * [Percona Distribution for PostgreSQL 13.16](release-notes-v13.16.md) ({{date.13_16}}) diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 9b7e6e443..7a6e4273d 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -125,6 +125,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] @@ -143,7 +144,7 @@ plugins: with-pdf: # https://github.com/orzih/mkdocs-with-pdf output_path: '_pdf/PerconaDistributionPostgreSQL-13.pdf' cover_title: 'Distribution for PostgreSQL Documentation' - cover_subtitle: 13.16 (September 12, 2024) + cover_subtitle: 13.19 (February , 2025) author: 'Percona Technical Documentation Team' cover_logo: docs/_images/Percona_Logo_Color.png debug_html: false @@ -209,6 +210,7 @@ nav: - Uninstall: uninstalling.md - Release notes: - "Release notes index": "release-notes.md" + - release-notes-v13.19.md - release-notes-v13.18.md - release-notes-v13.16.md - release-notes-v13.15.md diff --git a/mkdocs-pdf.yml b/mkdocs-pdf.yml index e6fd27d3a..04fce8a68 100644 --- a/mkdocs-pdf.yml +++ b/mkdocs-pdf.yml @@ -3,7 +3,7 @@ INHERIT: mkdocs-base.yml -copyright: Percona LLC, © 2024 +copyright: Percona LLC, © 2025 markdown_extensions: pymdownx.tabbed: {} 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 b54a4fc8e..37721f060 100644 --- a/variables.yml +++ b/variables.yml @@ -1,11 +1,12 @@ # PG Variables set for HTML output # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v13.18' +release: 'release-notes-v13.19' pgversion: '13' -dockertag: '13.18' +dockertag: '13.19' pgsmversion: '2.1.0' date: + 13_19: 2025-02- 13_18: 2024-12-11 13_16: 2024-09-12 From 246d9af9be13a9af37ad5bd199210ad95c9287a5 Mon Sep 17 00:00:00 2001 From: Anastasia Alexadrova Date: Mon, 3 Mar 2025 14:46:39 +0100 Subject: [PATCH 2/2] Changed version and release highlights Updated the release date --- .github/workflows/main.yml | 2 +- docs/apt.md | 2 +- ...notes-v13.19md => release-notes-v13.20.md} | 17 +++++++---- docs/release-notes.md | 2 +- docs/repo-overview.md | 5 ++++ docs/yum.md | 2 +- mkdocs-base.yml | 6 ++-- mkdocs-percona.yml | 29 ------------------- variables.yml | 8 ++--- 9 files changed, 28 insertions(+), 45 deletions(-) rename docs/{release-notes-v13.19md => release-notes-v13.20.md} (81%) delete mode 100644 mkdocs-percona.yml diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index f43d3f656..d7b4862aa 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -44,7 +44,7 @@ jobs: - name: Deploy docs run: | mike deploy 13 -b publish -p - mike retitle 13 "13.19" -b publish -p + mike retitle 13 "13.20" -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 5cd6715e9..531ae130d 100644 --- a/docs/apt.md +++ b/docs/apt.md @@ -45,7 +45,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)" ```{.bash data-prompt="$"} $ sudo apt install percona-ppg-server-{{pgversion}} diff --git a/docs/release-notes-v13.19md b/docs/release-notes-v13.20.md similarity index 81% rename from docs/release-notes-v13.19md rename to docs/release-notes-v13.20.md index 5179b55b6..5323cc9e5 100644 --- a/docs/release-notes-v13.19md +++ b/docs/release-notes-v13.20.md @@ -1,13 +1,15 @@ -# Percona Distribution for PostgreSQL 13.19 ({{date.13_19}}) +# Percona Distribution for PostgreSQL 13.20 ({{date.13_20}}) [Installation](installing.md){.md-button} --8<-- "release-notes-intro.md" -This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 13.18](https://www.postgresql.org/docs/13/release-13-18.html). +This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 13.19](https://www.postgresql.org/docs/13/release-13-19.html) and PostgreSQL 13.20. ## 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 13.19 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. @@ -16,7 +18,12 @@ This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 13.1 ### 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) +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 @@ -37,10 +44,10 @@ The following is the list of extensions available in Percona Distribution for Po | [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. | +| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | {{pgsmversion}} | 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 Common](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. | +| [PostgreSQL Common](https://salsa.debian.org/postgresql/postgresql-common) | 267 | 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 9 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. diff --git a/docs/release-notes.md b/docs/release-notes.md index 404792448..a341a2371 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -1,6 +1,6 @@ # Percona Distribution for PostgreSQL release notes -* [Percona Distribution for PostgreSQL 13.19](release-notes-v13.19.md) ({{date.13_19}}) +* [Percona Distribution for PostgreSQL 13.20](release-notes-v13.20.md) ({{date.13_20}}) * [Percona Distribution for PostgreSQL 13.18](release-notes-v13.18.md) ({{date.13_18}}) diff --git a/docs/repo-overview.md b/docs/repo-overview.md index 7f3444bed..9282f1007 100644 --- a/docs/repo-overview.md +++ b/docs/repo-overview.md @@ -10,6 +10,11 @@ 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 2daa042d6..5eb62599a 100644 --- a/docs/yum.md +++ b/docs/yum.md @@ -226,7 +226,7 @@ $ sudo yum -y install curl ### Install packages -=== "Install using meta-package" +=== "Install using meta-package (deprecated)" ```{.bash data-prompt="$"} $ sudo yum install percona-ppg-server{{pgversion}} diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 7a6e4273d..9d0961395 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -3,7 +3,7 @@ site_name: Percona Distribution for PostgreSQL site_description: Documentation site_author: Percona LLC -copyright: Percona LLC, © 2024 +copyright: Percona LLC, © 2025 site_url: "" repo_name: percona/postgresql-docs repo_url: https://github.com/percona/postgresql-docs @@ -144,7 +144,7 @@ plugins: with-pdf: # https://github.com/orzih/mkdocs-with-pdf output_path: '_pdf/PerconaDistributionPostgreSQL-13.pdf' cover_title: 'Distribution for PostgreSQL Documentation' - cover_subtitle: 13.19 (February , 2025) + cover_subtitle: 13.20 (March 6, 2025) author: 'Percona Technical Documentation Team' cover_logo: docs/_images/Percona_Logo_Color.png debug_html: false @@ -210,7 +210,7 @@ nav: - Uninstall: uninstalling.md - Release notes: - "Release notes index": "release-notes.md" - - release-notes-v13.19.md + - release-notes-v13.20.md - release-notes-v13.18.md - release-notes-v13.16.md - release-notes-v13.15.md diff --git a/mkdocs-percona.yml b/mkdocs-percona.yml deleted file mode 100644 index 963a44288..000000000 --- a/mkdocs-percona.yml +++ /dev/null @@ -1,29 +0,0 @@ -# MkDocs configuration for Percona builds -INHERIT: mkdocs-base.yml - -site_url: 'https://percona.com/doc/postgresql' - -# Theme adaptation for Percona website -theme: - name: material - custom_dir: _resource/theme - - -extra_css: - - css/version-select.css - - css/toctree.css - - css/percona.css - - css/details.css - -plugins: - - bootstrap-tables - - section-index # Adds links to nodes - comment out when creating PDF - -extra: # Used in main.html template and can't be externalised -# open_issue_text: ' Report a problem -# with this page' -# open_issue_subject: 'PMM2: doc issue on page ' -# open_issue_body: 'Please describe the issue here' -# open_issue_tooltip: 'Report an issue with this page on GitHub' - edit_page_text: ' Edit this page' - updated_text: ' Page updated' diff --git a/variables.yml b/variables.yml index 37721f060..5a7ca69f0 100644 --- a/variables.yml +++ b/variables.yml @@ -1,12 +1,12 @@ # PG Variables set for HTML output # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v13.19' +release: 'release-notes-v13.20' pgversion: '13' -dockertag: '13.19' -pgsmversion: '2.1.0' +dockertag: '13.20' +pgsmversion: '2.1.1' date: - 13_19: 2025-02- + 13_20: 2025-03-06 13_18: 2024-12-11 13_16: 2024-09-12