Upgrade from v11 to v12

This guide describes the steps to perform an upgrade of the component from version v11 to v12.

Changes

Parameters for the chart source and version has been changed against Project Syn best practices.

Parameter changes

charts.keycloakx changed to charts.keycloakx.version.
charts.postgresql changed to charts.postgresql.version.

If you’ve configured custom values for any of those parameters, make sure to adjust your configurations when upgrading from component version v11 to v12.

Step-by-step guide

When upgrading the component, the following actions are required if the built-in database is used:

Do a backup of the built-in database.

instance=keycloak
namespace=syn-${instance}

kubectl -n "${namespace}" exec -ti keycloak-postgresql-0 -c postgresql -- sh -c 'PGDATABASE="$POSTGRES_DB" PGUSER="$POSTGRES_USER" PGPASSWORD="$POSTGRES_PASSWORD" pg_dump --clean' > keycloak-postgresql-$(date +%F-%H-%M-%S).sql

Apply the parameter changes.
Compile and push the cluster catalog.