Releases: canonical/postgresql-operator
Revisions 552, 553
A new revision of Charmed PostgreSQL has been published in the 14/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important highlights, features and bug fixes in this release.
Highlights
- Upgraded PostgreSQL from v.14.12 → v.14.15 (PR #730)
- Check the official PostgreSQL 14.13 release notes
- Check the official PostgreSQL 14.14 release notes
- Check the official PostgreSQL 14.15 release notes
- Added timeline management to point-in-time recovery (PITR) (PR #629) (DPE-5561)
- Added pgAudit plugin/extension (PR #612) (DPE-5248)
- Observability stack (COS) improvements
- Added fully-featured terraform module (PR #643)
Minor features
- Several S3 stability improvements (PR #642)
- Removed patching of private ops class. (PR #617)
- Switched charm libs from
tempo_k8s
totempo_coordinator_k8s
and relay tracing traffic throughgrafana-agent
(PR #640) - Implemented more meaningful group naming for multi-group tests (PR #625)
- Ignoring alias error in case alias is already existing (PR #637)
- Stopped tracking channel for held snaps (PR #638)
- Added pgBackRest logrotate configuration (PR #645) (DPE-5601)
- Grant priviledges to non-public schemas (PR #647) (DPE-5387)
- Added
tls
andtls-ca
fields to databag (PR #666) - Merged
update_tls_flag
intoupdate_endpoints
(PR #669) - Made tox commands resilient to white-space paths (PR #678) (DPE-6042)
- Added microceph (local backup) integration test + bump snap version (PR #633) (DPE-5386)
- Add
max_locks_per_transaction
config option in (PR#718) (DPE-5533) - Split PITR backup test in AWS and GCP (PR #605) (DPE-5181)
Bug fixes
- Juju secrets resetting fix on Juju 3.6 in (PR#726) (DPE-6320) (DPE-6325)
- Fallback to trying to create bucket without LocationConstraint in (PR#690)
- Added warning logs to Patroni reinitialisation (PR #660)
- Fixed some
postgresql.conf
parameters for hardening (PR #621) (DPE-5512) - Fixed lib check (PR #627)
- Allow
--restore-to-time=latest
without abackup-id
in (PR#683) - Clean-up duplicated Patroni config reloads in (PR#682)
- Filter out degraded read only endpoints in (PR#679) (DPE-5714)
- remove clutter from singlestat panels in cos (PR#702)
- Catch wrong parameters exception on bucket create function call (PR#701) (DPE-5713)
- Split topology script (PR#729) (DPE-6377)
- Fix typos in COS alert rules (PR#724) (DPE-6171)
- Add plugins preload libs to regular startup parameters (PR#741) (DPE-6056)
Full Changelog: rev467...rev552
Requirements
The minimum Juju version required to reliably operate all features in this release is v3.4.3
.
The recommended Juju version for this charm is v3.6.1+
.
See the system requirements for more details about Juju versions and other software and hardware prerequisites.
Revisions 467, 468
A new revision of Charmed PostgreSQL has been published in the 14/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important highlights, features and bug fixes in this release.
Highlights
- Upgraded PostgreSQL from v.14.11 → v.14.12 (PR #530)
- Check the official PostgreSQL release notes
- Added support for Point In Time Recovery (PR #391) (DPE-2582)
Minor features
- Secure Syncobj and Patroni with passwords (PR #596) (DPE-5269)
- Removed deprecated config option
profile-limit-memory
(PR #564) (DPE-4889) - Added URI connection string to relations (PR #527) (DPE-2278)
- Moved URI generation to update endpoints (PR #584)
- Improve
list-backups
action output (PR #522) (DPE-4479) - Show start/end time in UTC time in list-backups output (PR #551)
- Switched to constant snap locales (PR #559) (DPE-4198)
Bug fixes
- Wait for exact number of units after scale down (PR #565) (DPE-5029)
- Improved test stability by pausing Patroni in the TLS test (PR #534) (DPE-4533)
- Block charm if it detects objects dependent on disabled plugins (PR #560) (DPE-4967)
- Disabled pgBackRest service initialization (PR #530) (DPE-4345)
- Increased timeout and terminate processes that are still up (PR #514) (DPE-4532)
- Fixed GCP backup test (PR #521) (DPE-4820)
- Handled on start secret exception and remove stale test (PR #550)
- Removed block on failure to get the db version (PR #578) (DPE-3562)
- Updated unit tests after fixing GCP backup test (PR #528) (DPE-4820)
- Ported some
test_self_healing
CI fixes + update check for invalid extra user credentials (PR #546) (DPE-4856) - Fixed slow bootstrap of replicas (PR #510) (DPE-4759)
- Fixed conditional password (PR #604)
- Added enforcement of Juju versions (PR #518) (DPE-4809)
- Fixed a missing case for peer to secrets translation. (PR #533)
- Updated README.md (PR #538) (DPE-4901)
- Increased test coverage (PR #505)
Full Changelog: rev429...rev467
Known limitations
- The unit action
resume-upgrade
randomly raises a harmless error message:terminated
. - The Sysbench charm may crash during a PostgreSQL charm refresh.
- Make sure that cluster-cluster replication is requested for the same charm/workload revisions. An automated check is planned.
- Contact us to schedule the cluster-cluster replication upgrade with you.
Requirements
The minimum Juju version required to reliably operate all features in this release is v3.4.3+
.
See the system requirements for more details about Juju versions and other software and hardware prerequisites.
Revisions 429, 430
A new revision of Charmed PostgreSQL has been published in the 14/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important highlights, features and bug fixes in this release.
Highlights
- Upgraded PostgreSQL from v.14.10 → v.14.11 (PR #432)
- Check the official PostgreSQL release notes
- Added support for ARM64 architecture (PR #381)
- Added support for cross-regional asynchronous replication (PR #452) (DPE-2953)
- This feature focuses on disaster recovery by distributing data across different servers. Check our new how-to guides for a walkthrough of the cross-model setup, promotion, switchover, and other details.
- Added support for tracing with Tempo K8s (PR #485) (DPE-4616)
- Check our new guide: How to enable tracing
- Released new Charmed Sysbench operator for easy performance testing
Minor features
- Added timescaledb plugin/extension (PR#470)
- See the Configuration tab for a full list of supported plugins/extensions
- Added incremental and differential backup support (PR #479) (DPE-4462)
- Check our guide: How to create and list backups
- Added support for disabling the operator (PR#412) (DPE-2469)
- Added support for subordination with:
- Added configuration option for backup retention time (PR#474)(DPE-4401)
- Added
experimental_max_connections
config option (PR#472) - Added check for replicas encrypted connection (PR#437)
Bug fixes
- Fixed slow charm bootstrap time (PR#413)
- Fixed large objects ownership (PR#349)
- Fixed secrets crash for "certificates-relation-changed" after the refresh (PR#475)
- Fixed network cut tests (PR#346) (DPE-3257)
Full Changelog: rev363...rev429
Requirements
The minimum Juju version required to reliably operate all features in this release is v3.4.2+
.
See the system requirements for more details about Juju versions and other software and hardware prerequisites.
Packaging
This charm is based on the charmed-postgresql
snap (pinned revision 113). It packages:
- postgresql
v.14.11
- pgbouncer
v.1.21
- patroni
v.3.1.2
- pgBackRest
v.2.48
- prometheus-postgres-exporter
v.0.12.1
Revision 363
A new revision of Charmed PostgreSQL has been published in the 14/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important highlights, features and bug fixes in this release.
Highlights
- PostgreSQL upgrade 14.9 -> 14.10. (DPE-3217)
- Note: It is advisable to REINDEX potentially-affected indexes after installing this update! (See PostgreSQL changelog)
- Added COS Awesome Alert rules (DPE-3160)
- Updated TLS libraries for compatibility with new charms
- manual-tls-certificates
- self-signed-certificates
- Any charms compatible with tls_certificates_interface.v2.tls_certificates
Minor features
- [CORE] Juju 3.1.7+ support (#2037120)
- [PLUGINS] pgVector extension/plugin (DPE-3159)
- [PLUGINS] New PostGIS plugin (#312)
- [PLUGINS] More new plugins - 50 in total
Bug fixes
- DPE-3199 Stabilized internal Juju secrets management
- DPE-3258 Check system identifier in stanza (backups setup stabilization)
Full Changelog: rev351...rev363
Packaging
- Charmed PostgreSQL ships the latest PostgreSQL
14.10-0ubuntu0.22.04.1
- PostgreSQL cluster manager Patroni updated to
v.3.1.2
- Backup tools pgBackRest updated to
v.2.48
- The Prometheus postgres-exporter is
0.12.1-0ubuntu0.22.04.1~ppa1
- VM charms based on Charmed PostgreSQL SNAP (Ubuntu LTS 22.04 -
ubuntu:22.04-based
) revision 96 - Principal charms supports the latest LTS series 22.04 only
- Subordinate charms support LTS 22.04 and 20.04 only
Requirements
The minimum Juju version required to reliably operate all features in this release is v3.4.2+
.
See the system requirements for more details about Juju versions and other software and hardware prerequisites.
Revision 351
A new revision of Charmed PostgreSQL has been published in the 14/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important highlights, features and bug fixes in this release.
Highlights
- [Core] Updated
Charmed PostgreSQL
SNAP image (PR#291)(DPE-3039):Patroni
updated from 3.0.2 to 3.1.2Pgbackrest
updated from 2.47 to 2.48
- [Plugins] Add 24 new plugins/extension in (PR#251)
- NOTE: extension
plpython3u
is deprecated and will be removed from list of supported plugins soon!
- NOTE: extension
- [Config] Add 29 new configuration options in (PR#239)(DPE-1781)
- NOTE: the config option
profile-limit-memory
is deprecated. Useprofile_limit_memory
(to follow the naming conventions)! (PR#306)(DPE-3096)
- NOTE: the config option
Minor features
- [Charm] Add Juju Secret labels in (PR#270)(DPE-2838)
- [Charm] Update Python dependencies in (PR#293)
- [DB] Add handling of tables ownership in (PR#298)(DPE-2740)
- (COS) Moved Grafana dashboard legends to the bottom of the graph in (PR#295)(DPE-2622)
- (COS) Add Patroni COS support (#261)(DPE-1993)
- [CI/CD] Charm migrated to GitHub Data reusable workflow in (PR#263)(DPE-2789)
Bug fixes
- Fixed enabling extensions when new database is created (PR#252)(DPE-2569)
- Block the charm if the legacy interface requests roles (DPE-3077)
Canonical Data issues are now public on both Jira and GitHub platforms.
GitHub Releases provide a detailed list of bugfixes, PRs, and commits for each revision.
Full Changelog: rev336...rev351
Packaging
- Charmed PostgreSQL ships the latest PostgreSQL “14.9-0ubuntu0.22.04.1”
- PostgreSQL cluster manager Patroni updated to "3.2.1"
- Backup tools pgBackRest updated to "2.48"
- The Prometheus postgres-exporter is "0.12.1-0ubuntu0.22.04.1~ppa1"
- VM charms based on Charmed PostgreSQL SNAP (Ubuntu LTS “22.04” - ubuntu:22.04-based) revision 89
- Principal charms supports the latest LTS series “22.04” only
- Subordinate charms support LTS “22.04” and “20.04” only
Requirements
The minimum Juju version required to reliably operate all features in this release is v3.1.6+
.
See the system requirements for more details about Juju versions and other software and hardware prerequisites.
Revision 336
A new revision of Charmed PostgreSQL has been published in the 14/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important highlights, features and bug fixes in this release.
Highlights
- Add Juju 3 support (Juju 2 is still supported) [DPE-1758]
- Charm minor upgrades and minor rollbacks [DPE-1767]
Other new features
- All secrets are now stored in Juju secrets [DPE-1758]
- Canonical Observability Stack (COS) support [DPE-1775]
- PostgreSQL plugins support [DPE-1373]
- Profiles configuration support [DPE-2655]
- Logs rotation [DPE-1754]
- Workload updated to PostgreSQL 14.9 [PR#18]
- Add '
admin
' extra user role [DPE-2167] - New charm 'PostgreSQL Test App'
- New documentation:
Bugfixes
- DPE-1624, DPE-1625 Backup/restore fixes
- DPE-1926 Remove fallback_application_name field from relation data
- DPE-1712 Enabled the user to fix network issues and rerun stanza related hooks
- DPE-2173 Fix allowed units relation data field
- DPE-2127 Fixed databases access
- DPE-2341 Populate extensions in unit databag
- DPE-2218 Update charm libs to get s3 relation fix
- DPE-1210, DPE-2330, DPE-2212 Open port (ability to expose charm)
- DPE-2614 Split stanza create and stanza check
- DPE-2721 Allow network access for pg_dump, pg_dumpall and pg_restore
- DPE-2717 Copy dashboard changes from K8s and use the correct topology dispatcher
- [MISC] More resilient topology observer
Canonical Data issues are now public on both Jira and GitHub platforms.
Full Changelog: rev288...rev336
Technical notes
juju refresh
from the old-stable revision 288 to the current-revision 324 is NOT supported!!! The upgrade functionality is new and supported for revision 324+ only!- Please check additionally the previously posted restrictions.
- Ensure the charm requirements met
- The minimum Juju version required to reliably operate all features in this release is
v3.1.5
.
See the system requirements for more details about Juju versions and other software and hardware prerequisites.
Packaging
- Charmed PostgreSQL ships the latest PostgreSQL “14.9-0ubuntu0.22.04.1”
- PostgreSQL cluster manager Patroni updated to "3.0.2"
- Backup tools pgBackRest updated to "2.47"
- The Prometheus postgres-exporter is "0.12.1-0ubuntu0.22.04.1~ppa1"
- VM charms based on Charmed PostgreSQL SNAP (Ubuntu LTS “22.04” - ubuntu:22.04-based)
- Principal charms supports the latest LTS series “22.04” only.
- Subordinate charms support LTS “22.04” and “20.04” only.
Contact us
Charmed PostgreSQL is an open source project that warmly welcomes community contributions, suggestions, fixes, and constructive feedback.
Revision 288
The first stable
revision of Charmed PostgreSQL operator for machines has been published in the 14/stable
channel.
See also: Releases overview page
Highlights
- Deploying on VM (tested with LXD, MAAS)
- Scaling up/down in one simple juju command
- HA using Patroni
- Full backups and restores are supported when using any S3-compatible storage
- TLS support (using “tls-certificates” operator)
- DB access outside of Juju using “data-integrator”
- Data import using standard tools e.g. “psql”.
Full Changelog: https://github.com/canonical/postgresql-operator/commits/rev288
Inside the charms
- Charmed PostgreSQL charm ships the latest PostgreSQL “14.7-0ubuntu0.22.04.1”
- VM charms based on our SNAP (Ubuntu LTS “22.04” - core22-based)
- Principal charms supports the latest LTS series “22.04” only.
- Subordinate charms support LTS “22.04” and “20.04” only.
Technical notes
- The new PostgreSQL charm is also a juju interface-compatible replacement for legacy PostgreSQL charms (using legacy interface
pgsql
, via endpointsdb
anddb-admin
).
However, it is highly recommended to migrate to the modern interfacepostgresql_client
(endpointdatabase
).- Please contact us if you are considering migrating from other “legacy” charms not mentioned above.
- Charmed PostgreSQL follows SNAP track “14”.
- No “latest” track in use (no surprises in tracking “latest/stable”)!
- PostgreSQL charm provide legacy charm through “latest/stable”.
- You can find charm lifecycle flowchart diagrams here.
- Modern interfaces are well described in the Interfaces catalogue and implemented by
data-platform-libs
. - Known limitation: PostgreSQL extensions are not yet supported.
Contact us
Charmed PostgreSQL is an open source project that warmly welcomes community contributions, suggestions, fixes, and constructive feedback.
- Raise software issues or feature requests on GitHub
- Report security issues through Launchpad
- Contact the Canonical Data Platform team through our Matrix channel!
Requirements
See the system requirements for more details about Juju versions and other software and hardware prerequisites.