From 71e930b53d647116e77ba08c7aa64f4ac3df1168 Mon Sep 17 00:00:00 2001 From: krystofkomanec Date: Thu, 13 Aug 2026 15:12:53 +0200 Subject: [PATCH 1/2] Add S3 botocore upgrade note --- docs/more/self-hosted-dsw/upgrade-guidelines.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/more/self-hosted-dsw/upgrade-guidelines.rst b/docs/more/self-hosted-dsw/upgrade-guidelines.rst index f21d8be..37f41ac 100644 --- a/docs/more/self-hosted-dsw/upgrade-guidelines.rst +++ b/docs/more/self-hosted-dsw/upgrade-guidelines.rst @@ -48,7 +48,10 @@ Usually, nothing special is required for the upgrade. Internal structure changes 4.32.X to 4.33.X ---------------- -*(nothing)* +- If ``mailer`` or ``document-worker`` is configured to use S3, review any S3-related environment configuration. These + components use ``botocore`` / AWS SDK configuration for S3 access, not MinIO client configuration. For example, custom + certificate bundles should be configured using AWS SDK environment variables such as ``AWS_CA_BUNDLE``. See the + `Boto3 environment variable configuration documentation `__. 4.31.X to 4.32.X ---------------- From 3470325861bcbd103e41475913f45c9a4db33bac Mon Sep 17 00:00:00 2001 From: krystofkomanec Date: Thu, 13 Aug 2026 15:25:54 +0200 Subject: [PATCH 2/2] Add botocore setup --- docs/more/self-hosted-dsw/upgrade-guidelines.rst | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/docs/more/self-hosted-dsw/upgrade-guidelines.rst b/docs/more/self-hosted-dsw/upgrade-guidelines.rst index 37f41ac..d73dec5 100644 --- a/docs/more/self-hosted-dsw/upgrade-guidelines.rst +++ b/docs/more/self-hosted-dsw/upgrade-guidelines.rst @@ -48,10 +48,7 @@ Usually, nothing special is required for the upgrade. Internal structure changes 4.32.X to 4.33.X ---------------- -- If ``mailer`` or ``document-worker`` is configured to use S3, review any S3-related environment configuration. These - components use ``botocore`` / AWS SDK configuration for S3 access, not MinIO client configuration. For example, custom - certificate bundles should be configured using AWS SDK environment variables such as ``AWS_CA_BUNDLE``. See the - `Boto3 environment variable configuration documentation `__. +- Tools interacting with S3 (``mailer`` and ``document-worker``) now use ``botocore`` library instead of ``MinIO``. Settings, such as custom certificates, need to be configure according to its documentation: https://docs.aws.amazon.com/boto3/latest/guide/configuration.html#using-environment-variables. 4.31.X to 4.32.X ---------------- @@ -78,13 +75,13 @@ Usually, nothing special is required for the upgrade. Internal structure changes - **Project Importers** were removed. They can be replaced by :ref:`configuration-plugins`. - API endpoints in sections related to **Document Templates** and **Knowledge Models** were updated. The primary identifier was changed from ``ID`` to ``UUID``. Please check the API documentation for the new endpoints. -- Due to Document Template changes, it is necessary to migrate Document Templates in S3. You can use this script: https://github.com/ds-wizard/dsw-templates-migration-script +- Due to Document Template changes, it is necessary to migrate Document Templates in S3. You can use this script: https://github.com/ds-wizard/dsw-templates-migration-script. 4.26.X to 4.27.X ---------------- - API endpoints in the sections related to **Locales** were updated. The primary identifier was changed from ``ID`` to ``UUID``. Please check the API documentation for the new endpoints. -- Due to Locale changes, it is necessary to migrate Locales in S3. You can use this script: https://github.com/ds-wizard/dsw-locale-migration-script +- Due to Locale changes, it is necessary to migrate Locales in S3. You can use this script: https://github.com/ds-wizard/dsw-locale-migration-script. 4.25.X to 4.26.X ----------------