Skip to content

Commit

Permalink
Merge pull request #225 from projectsyn/changelog-v12
Browse files Browse the repository at this point in the history
Add upgrade how-to from v11 to v12
  • Loading branch information
megian authored Jul 10, 2023
2 parents a2534b2 + 48b6ce5 commit 6cd8da3
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 0 deletions.
32 changes: 32 additions & 0 deletions docs/modules/ROOT/pages/how-tos/upgrade-11.x-to-12.x.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
= 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 https://syn.tools/syn/explanations/commodore-components/helm-charts.html#_example[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.
+
[source,bash]
----
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.
1 change: 1 addition & 0 deletions docs/modules/ROOT/partials/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@
* xref:how-tos/upgrade-8.x-to-9.x.adoc[Upgrade 8.x to 9.x]
* xref:how-tos/upgrade-9.x-to-10.x.adoc[Upgrade 9.x to 10.x]
* xref:how-tos/upgrade-10.x-to-11.x.adoc[Upgrade 10.x to 11.x]
* xref:how-tos/upgrade-11.x-to-12.x.adoc[Upgrade 11.x to 12.x]
* xref:how-tos/openshift-4.adoc[Install on OpenShift 4]
* xref:how-tos/pin-versions.adoc[Pin versions]
Expand Down

0 comments on commit 6cd8da3

Please sign in to comment.