Skip to content

Commit

Permalink
DISTPG-732 Release notes 14.11 (#519)
Browse files Browse the repository at this point in the history
* DISTPG-732 Release notes 14.11

modified:   .github/workflows/main.yml
	new file:   docs/release-notes-v14.11.md
	modified:   docs/release-notes.md
	modified:   mkdocs-base.yml
	modified:   variables.yml
  • Loading branch information
nastena1606 authored Mar 1, 2024
1 parent 20459c7 commit e18fee0
Show file tree
Hide file tree
Showing 6 changed files with 63 additions and 12 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ jobs:
- name: Deploy docs
run: |
mike deploy 14 -b publish -p
mike retitle 14 "14.10" -b publish -p
mike retitle 14 "14.11" -b publish -p
# - name: Install Node.js 14.x
# uses: percona-platform/setup-node@v2
Expand Down
13 changes: 5 additions & 8 deletions docs/docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,16 +33,14 @@ For more information about using Docker, see the [Docker Docs](https://docs.dock
1. Start a Percona Distribution for PostgreSQL container as follows:

```{.bash data-prompt="$"}
$ docker run --name container-name -e POSTGRES_PASSWORD=secret -d percona/percona-distribution-postgresql:tag
$ docker run --name container-name -e POSTGRES_PASSWORD=secret -d percona/percona-distribution-postgresql:<tag>-multi
```

Where:

* `container-name` is the name you assign to your container
* `POSTGRES_PASSWORD` is the superuser password
* `tag` is the tag specifying the version you want.

Check the [full list of tags](https://hub.docker.com/r/percona/percona-distribution-postgresql/tags/).
`tag-multi` is the tag specifying the version you need. For example, `{{dockertag}}-multi`. The `multi` part of the tag serves to identify the architecture (x86_64 or ARM64) and pull the respective image. See the [full list of tags](https://hub.docker.com/r/percona/percona-distribution-postgresql/tags/).


!!! tip
Expand All @@ -58,7 +56,7 @@ For more information about using Docker, see the [Docker Docs](https://docs.dock
2. Start the container:

```{.bash data-prompt="$"}
$ docker run --name container-name --env-file ./.my-pg.env -d percona/percona-distribution-postgresql:tag
$ docker run --name container-name --env-file ./.my-pg.env -d percona/percona-distribution-postgresql:<tag>-multi
```

2. Connect to the container's interactive terminal:
Expand Down Expand Up @@ -89,14 +87,14 @@ where:
The following command starts another container instance and runs the `psql` command line client against your original container, allowing you to execute SQL statements against your database:
```{.bash data-prompt="$"}
$ docker run -it --network container:db-container-name --name container-name percona/percona-distribution-postgresql:tag psql -h address -U postgres
$ docker run -it --network container:db-container-name --name container-name percona/percona-distribution-postgresql:<tag>-multi psql -h address -U postgres
```
Where:
* `db-container-name` is the name of your database container
* `container-name` is the name of your container that you will use to connect to the database container using the `psql` command line client
* `tag` is the tag specifying the Docker image version you want to use.
* `tag-multi` is the tag specifying the version you need. For example, `{{dockertag}}-multi`. The `multi` part of the tag serves to identify the architecture (x86_64 or ARM64) and pull the respective image.
* `address` is the network address where your database container is running. Use 127.0.0.1, if the database container is running on the local machine/host.
## Enable `pg_stat_monitor`
Expand Down Expand Up @@ -165,4 +163,3 @@ To enable the `pg_stat_monitor` extension after launching the container, do the
Note that the `pg_stat_monitor` view is available only for the databases where you enabled it. If you create a new database, make sure to create the view for it to see its statistics data.
50 changes: 50 additions & 0 deletions docs/release-notes-v14.11.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# Percona Distribution for PostgreSQL 14.11 (2024-03-01)

[Installation](installing.md){.md-button}

Percona Distribution for PostgreSQL is a solution with the collection of tools from PostgreSQL community that are tested to work together and serve to assist you in deploying and managing PostgreSQL. The aim of Percona Distribution for PostgreSQL is to address the operational issues like High-Availability, Disaster Recovery, Security, Observability, Spatial data handling, Performance and Scalability and others that enterprises are facing.


This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 14.11](https://www.postgresql.org/docs/14/release-14-11.html).

## Release Highlights

* A Docker image for Percona Distribution for PostgreSQL is now available for ARM architectures. This improves the user experience with the Distribution for developers with ARM-based workstations.


------------------------------------------------------------------------------

The following is the list of extensions available in Percona Distribution for PostgreSQL.

| Extension | Version | Description |
| ------------------- | -------------- | ---------------------------- |
|[HAProxy](http://www.haproxy.org/) | 2.8.5 | a high-availability and load-balancing solution |
| [Patroni](https://patroni.readthedocs.io/en/latest/) | 3.2.2 | a HA (High Availability) solution for PostgreSQL |
| [PgAudit](https://www.pgaudit.org/) | 1.6.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.0.1 | 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.50 | a backup and restore solution for PostgreSQL |
|[pgBadger](https://github.com/darold/pgbadger) | 12.4 | a fast PostgreSQL Log Analyzer.|
|[PgBouncer](https://www.pgbouncer.org/) |1.22.0 | a lightweight connection pooler for PostgreSQL|
| [pg_gather](https://github.com/jobinau/pg_gather)| v25 | 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.0 | 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.0 | rebuilds PostgreSQL database objects |
| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor)|2.0.4 | collects and aggregates statistics for PostgreSQL and provides histogram information.|
| [PostGIS](https://github.com/postgis/postgis) | 3.3.5 | a spatial extension for PostgreSQL.|
| [PostgreSQL Common](https://salsa.debian.org/postgresql/postgresql-common)| 256 | PostgreSQL database-cluster manager. It provides a structure under which multiple versions of PostgreSQL may be installed and/or multiple clusters may be maintained at one time.|
|[wal2json](https://github.com/eulerto/wal2json) |2.5 | a PostgreSQL logical decoding JSON output plugin|


Percona Distribution for PostgreSQL also includes the following packages:

* `llvm` 12.0.1 packages for Red Hat Enterprise Linux 8 and derivatives. This fixes compatibility issues with LLVM from upstream.
* supplemental `ETCD` packages which can be used for setting up Patroni clusters. These packages are available for the following operating systems:

| Operating System | Package | Version | Description |
| ------------------- | ---------------------| --------| ------------------ |
| RHEL 8 | `etcd` | 3.5.12 | A consistent, distributed key-value store|
| | `python3-python-etcd`| 0.4.5 | A Python client for ETCD |

Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/14/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."
4 changes: 3 additions & 1 deletion docs/release-notes.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Release notes index

* [Percona Distribution for PostgreSQL 14.10 Update](release-notes-v14.10.md) (2024-01-19)
* [Percona Distribution for PostgreSQL 14.11](release-notes-v14.11.md) (2024-03-01)

* [Percona Distribution for PostgreSQL 14.10 Update](release-notes-v14.10.upd.md) (2024-01-19)

* [Percona Distribution for PostgreSQL 14.10](release-notes-v14.10.md) (2023-11-05)

Expand Down
3 changes: 2 additions & 1 deletion mkdocs-base.yml
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ plugins:
with-pdf: # https://github.com/orzih/mkdocs-with-pdf
output_path: '_pdf/PerconaDistributionPostgreSQL-14.pdf'
cover_title: 'Percona Distribution for PostgreSQL Documentation'
cover_subtitle: 14.10 (January 19, 2024)
cover_subtitle: 14.11 (March 01, 2024)
author: 'Percona Technical Documentation Team'
cover_logo: docs/_images/Percona_Logo_Color.png
debug_html: false
Expand All @@ -134,6 +134,7 @@ nav:
- Home: index.md
- Release notes:
- "Release notes index": "release-notes.md"
- release-notes-v14.11.md
- release-notes-v14.10.upd.md
- release-notes-v14.10.md
- release-notes-v14.9.md
Expand Down
3 changes: 2 additions & 1 deletion variables.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,6 @@
# See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path


release: 'release-notes-v14.10.upd'
release: 'release-notes-v14.11'
pgversion: '14'
dockertag: '14.11'

0 comments on commit e18fee0

Please sign in to comment.