Fix bundled Postgres image mismatch
General MR
Summary
Updates the bundled Keycloak PostgreSQL subchart configuration to use the supported Iron Bank opensource/postgres/postgresql:18.4 image instead of the deprecated Bitnami PostgreSQL image. This also aligns the chart values, documentation, README, Renovate tracking, and local plugin-development compose setup with the new Postgres image and runtime paths.
Relevant logs/screenshots
Manual database upgrade flow
Follow-up local k3d-dev migration evidence:
- Installed the current
mainchart with the old bundled PG17 Bitnami image. - Created a canary table/row in the
keycloakdatabase. - Exported the PG17 DB with
pg_dump -Fc. - Upgraded to this MR’s PG18 Iron Bank image/layout.
- Confirmed the canary table was absent before restore.
- Restored the PG17 dump into PG18 with
pg_restore. - Confirmed the same canary row existed under PostgreSQL 18.4.
The same PVC retained the old Bitnami-layout PG17 data directory and the new PG18 data directory. This confirms the Helm/image upgrade does not automatically migrate bundled DB data, but a logical dump/restore migration successfully moves data from PG17 into the new PG18 layout.
Cypress Screenshots
See passing CI jobs for clean install. Skipping the upgrade job as explained in the upgrade notices below.
Linked Issue
Upgrade Notices
-
BREAKING DATABASE CHANGE: The bundled internal PostgreSQL database has been updated from PG17 to PG18 and moved from the deprecated Bitnami image/layout to the Iron Bank
opensource/postgres/postgresqlimage/layout. Platform One does not support the bundled internal PostgreSQL database for production deployments; this option should only be used for development or CI pipelines. -
DO NOT UPGRADE WITHOUT A DATABASE BACKUP if you need to preserve data from the bundled database. Existing bundled database data is not automatically migrated or reused by the new image layout. To preserve data, export from the old bundled PG17 database with
pg_dump/pg_dumpall, upgrade to this release, then restore into the new PG18 database withpg_restore/psql. -
If you already upgraded without exporting, do not delete the PVC. The old Bitnami-layout PG17 data remains on the PVC, but the new PG18 image uses a different data directory. Roll back to the previous chart/image to access the old data and export it manually.
Regular database backups and best practices should be followed.
