diff --git a/src/how-to/upgrade/05-config-reference.md b/src/how-to/upgrade/05-config-reference.md index c2a553c..26757d3 100644 --- a/src/how-to/upgrade/05-config-reference.md +++ b/src/how-to/upgrade/05-config-reference.md @@ -35,6 +35,10 @@ Apply each configuration change to your templates as applicable to your model. - [Wire Server 5.24.0](config-references/wire-server-5.24.0.md) - [Wire Server 5.25.0](config-references/wire-server-5.25.0.md) +- [Wire Server 5.26.0](config-references/wire-server-5.26.0.md) +- [Wire Server 5.27.0](config-references/wire-server-5.27.0.md) +- [Wire Server 5.28.0](config-references/wire-server-5.28.0.md) +- [Wire Server 5.29.0](config-references/wire-server-5.29.0.md) ## Contributing diff --git a/src/how-to/upgrade/README.md b/src/how-to/upgrade/README.md index 84571fa..b6b8128 100644 --- a/src/how-to/upgrade/README.md +++ b/src/how-to/upgrade/README.md @@ -13,3 +13,7 @@ Complete documentation for upgrading `wire-server` deployments. ## 5. [Configuration Reference](05-config-reference.md) - [Wire Server 5.24.0](config-references/wire-server-5.24.0.md) - [Wire Server 5.25.0](config-references/wire-server-5.25.0.md) + - [Wire Server 5.26.0](config-references/wire-server-5.26.0.md) + - [Wire Server 5.27.0](config-references/wire-server-5.27.0.md) + - [Wire Server 5.28.0](config-references/wire-server-5.28.0.md) + - [Wire Server 5.29.0](config-references/wire-server-5.29.0.md) diff --git a/src/how-to/upgrade/config-references/wire-server-5.26.0.md b/src/how-to/upgrade/config-references/wire-server-5.26.0.md new file mode 100644 index 0000000..a9d8e13 --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.26.0.md @@ -0,0 +1,24 @@ +# Wire-Server 5.26.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/7023ffdd52f9de2a1eb5ce2e01cefaf16253274b/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-01-26). + +## Known bugs + +Previous release introduced a bug into `background-worker` default settings for `postgresMigration` and have now been correctly set to Cassandra. If you are relying on default values from our charts, but have migrated your conversations to PostgreSQL, update your config accordingly to keep using PostgreSQL. Specifically, this value: + +``` +background-worker: + config: + postgresMigration: + conversation: postgresql | cassandra # default is cassandra, and should be if not migrated to postgresql +``` + +## Mandatory (breaking) changes + +No mandatory changes. + +## Optional changes + +Conversation codes can now be migrated to PostgreSQL. For details, read our [changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-01-26). diff --git a/src/how-to/upgrade/config-references/wire-server-5.27.0.md b/src/how-to/upgrade/config-references/wire-server-5.27.0.md new file mode 100644 index 0000000..8eb335c --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.27.0.md @@ -0,0 +1,17 @@ +# Wire-Server 5.27.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/d8bdda07fd4c32937a5482711b6e322a32d0c784/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-02-04). + +## Known bugs + +No known bugs + +## Mandatory (breaking) changes + +No mandatory changes + +## Optional changes + +Team features can now be migrated to PostgreSQL. For details, read our [changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-02-04). \ No newline at end of file diff --git a/src/how-to/upgrade/config-references/wire-server-5.28.0.md b/src/how-to/upgrade/config-references/wire-server-5.28.0.md new file mode 100644 index 0000000..8e42a2e --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.28.0.md @@ -0,0 +1,31 @@ +# Wire-Server 5.28.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/93632dd82237c122c93e0e37e02e5f2a1ba84746/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-03-03). + +## Known bugs + +No known bugs + +## Mandatory (breaking) changes + +The following Helm charts were changed: + +- `demo-smtp` +- `fake-aws-ses` +- `fake-aws-sns` +- `legalhold` + +Image field overrides are now controlled with split values, `repository` + `tag`, unlike a full `image` string like previously, if you were using overrides in these charts, change to this format: + +``` +affected-chart: + image: + repository: quay.io/wire/... + tag: some-tag +``` + +## Optional changes + +No optional changes \ No newline at end of file diff --git a/src/how-to/upgrade/config-references/wire-server-5.29.0.md b/src/how-to/upgrade/config-references/wire-server-5.29.0.md new file mode 100644 index 0000000..18d1d95 --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.29.0.md @@ -0,0 +1,86 @@ +# Wire-Server 5.29.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/eaaec058bd49e392ab8727a02c568782f709c81a/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v5.29.0). + +## Known bugs + +No known bugs + +## Mandatory (breaking) changes + +Wire-server core services were migrated from subcharts into the umbrella chart templates. As a result, dependency tags for these services are now obsolete. Out of these, `proxy` service might be the only breaking change if it was not used previously and is unconfigured. + +### `proxy` + +If `proxy` was used previously and is already configured, you have no breaking changes. + +Since proxy can no longer be "toggled off" the following configuration with dummy secrets is sufficient for deploy. + +``` +proxy: + secrets: + proxy_config: |- + secrets { + youtube = "..." + googlemaps = "..." + soundcloud = "..." + giphy = "..." + spotify = "Basic ..." + } +``` + +## Optional changes + +### `wire-server` + +This value in `wire-server` charts is now obsolete and can be removed if used: + +``` +tags: + proxy: false # or true +``` + +### `proxy` + +The following is full config options for the `proxy` chart and are shown as defaults as they come set in charts. They are not required to be set in your `values.yaml`. Do not change unless necessary. + +``` +proxy: + replicaCount: 3 + image: + repository: quay.io/wire/proxy + tag: wire-server-release-version + service: + externalPort: 8080 + internalPort: 8080 + imagePullPolicy: "" + metrics: + serviceMonitor: + enabled: false + resources: + requests: + memory: "25Mi" + cpu: "50m" + limits: + memory: "50Mi" + config: + logLevel: Info + logFormat: StructuredJSON + logNetStrings: false + proxy: {} + # Disable one ore more API versions. Please make sure the configuration value is the same in all these charts: + # brig, cannon, cargohold, galley, gundeck, proxy, spar. + disabledAPIVersions: [development] + + podSecurityContext: + allowPrivilegeEscalation: false + capabilities: + drop: + - ALL + runAsNonRoot: true + seccompProfile: + type: RuntimeDefault + secrets: {} +``` \ No newline at end of file