From 513159bb5475974a76944e2818750c8ff5c1d2d2 Mon Sep 17 00:00:00 2001 From: nscuro Date: Sat, 2 May 2026 22:41:43 +0200 Subject: [PATCH] Add upgrade notes for v0.7.0-alpha.5 Signed-off-by: nscuro --- docs/guides/upgrading/.pages | 1 + docs/guides/upgrading/v0.7.0-alpha.3.md | 16 ---------------- docs/guides/upgrading/v0.7.0-alpha.4.md | 15 +++++++++++++++ docs/guides/upgrading/v0.7.0-alpha.5.md | 10 ++++++++++ 4 files changed, 26 insertions(+), 16 deletions(-) create mode 100644 docs/guides/upgrading/v0.7.0-alpha.5.md diff --git a/docs/guides/upgrading/.pages b/docs/guides/upgrading/.pages index f699c23..62ad0a9 100644 --- a/docs/guides/upgrading/.pages +++ b/docs/guides/upgrading/.pages @@ -1,6 +1,7 @@ title: Upgrade guides nav: - index.md + - v0.7.0-alpha.5.md - v0.7.0-alpha.4.md - v0.7.0-alpha.3.md - v0.6.0.md diff --git a/docs/guides/upgrading/v0.7.0-alpha.3.md b/docs/guides/upgrading/v0.7.0-alpha.3.md index 0f34618..357ecc8 100644 --- a/docs/guides/upgrading/v0.7.0-alpha.3.md +++ b/docs/guides/upgrading/v0.7.0-alpha.3.md @@ -117,22 +117,6 @@ * The new datasource configuration mechanism is documented in the [datasource configuration reference](../../reference/configuration/datasources.md). -* **Loading secrets from files now uses the `${file::}` expression syntax.** The legacy - `.file=/path` and `alpine..file=/path` properties are no longer recognized, and - the API server refuses to start if any of them are set. Rewrite each occurrence as - `=${file::/path}`. Affected properties: - - | Before | After | - |:---------------------------------------------------------------------|:----------------------------------------| - | `dt.database.password.file` (or `alpine.database.password.file`) | `dt.datasource.password=${file::/path}` | - | `dt.http.proxy.password.file` (or `alpine.http.proxy.password.file`) | `dt.http.proxy.password=${file::/path}` | - | `dt.ldap.bind.password.file` (or `alpine.ldap.bind.password.file`) | `dt.ldap.bind.password=${file::/path}` | - - The file is read once at startup, decoded as UTF-8, and trailing whitespace is stripped. - Files larger than 64 KiB are rejected. Refer to - [Loading values from files](../../reference/configuration/application.md#loading-values-from-files) - for details. - * **All configuration properties have been standardized to use the `dt.` prefix**. Properties that previously used the `alpine.` prefix, or no prefix at all, are now under `dt.`. For example: diff --git a/docs/guides/upgrading/v0.7.0-alpha.4.md b/docs/guides/upgrading/v0.7.0-alpha.4.md index 7b0e36a..49d8798 100644 --- a/docs/guides/upgrading/v0.7.0-alpha.4.md +++ b/docs/guides/upgrading/v0.7.0-alpha.4.md @@ -8,3 +8,18 @@ could not be completed in time for the GA release. * **Support for importing CycloneDX BOMs in Protobuf format has been removed**. JSON and XML remain the only accepted formats. +* **Loading secrets from files now uses the `${file::}` expression syntax.** The legacy + `.file=/path` and `alpine..file=/path` properties are no longer recognized, and + the API server refuses to start if any of them are set. Rewrite each occurrence as + `=${file::/path}`. Affected properties: + + | Before | After | + |:---------------------------------------------------------------------|:----------------------------------------| + | `dt.database.password.file` (or `alpine.database.password.file`) | `dt.datasource.password=${file::/path}` | + | `dt.http.proxy.password.file` (or `alpine.http.proxy.password.file`) | `dt.http.proxy.password=${file::/path}` | + | `dt.ldap.bind.password.file` (or `alpine.ldap.bind.password.file`) | `dt.ldap.bind.password=${file::/path}` | + + The file is read once at startup, decoded as UTF-8, and trailing whitespace is stripped. + Files larger than 64 KiB are rejected. Refer to + [Loading values from files](../../reference/configuration/application.md#loading-values-from-files) + for details. diff --git a/docs/guides/upgrading/v0.7.0-alpha.5.md b/docs/guides/upgrading/v0.7.0-alpha.5.md new file mode 100644 index 0000000..9d8dd6e --- /dev/null +++ b/docs/guides/upgrading/v0.7.0-alpha.5.md @@ -0,0 +1,10 @@ +# Upgrading to v0.7.0-alpha.5 + +!!! warning + Please make sure you successfully upgraded to [v0.7.0-alpha.4](v0.7.0-alpha.4.md) + before upgrading to v0.7.0-alpha.5. This is **extremely important**, as otherwise + some database migrations will not be applied. + +* **Database migrations have been switched from Liquibase to Flyway**. No action is + required, *except ensuring that the [v0.7.0-alpha.4](v0.7.0-alpha.4.md) upgrade + was executed*.