Releases: stackitcloud/rag-template
Releases · stackitcloud/rag-template
v4.0.0
🚨 Breaking changes
Helm chart / deployment config
- Secret schema refactor (values + templates): secrets for basic auth, Langfuse, S3, STACKIT, and RAGAS are now split into individual fields (e.g., username/password or API key) and can be sourced via
secretKeyRefinvalues.yaml. Helm templates were updated accordingly (including ingress/basic-auth handling). You’ll need to adapt existingvalues.yaml+ secrets to the new structure. ([GitHub]1) - New secret-resolution helpers: templates now prefer
secretKeyRef.namewhen provided and otherwise fall back to default names. This can change which secret names your deployments expect. ([GitHub]1) - New local Langfuse init workflow: local dev can generate a stable Langfuse init secret from a
.env.langfusevia Kustomize/Tilt; docs and Tiltfile were updated. ([GitHub]1)
Frontend service configuration
- Frontend auth env vars removed:
VITE_AUTH_USERNAME/VITE_AUTH_PASSWORDwere removed from.env.template. The frontend auth prompt now reusesBASIC_AUTH_USER/BASIC_AUTH_PASSWORD. If your frontend deployment relied onVITE_AUTH_*, you must migrate. ([GitHub]2)
Local dev / build workflow
- Dockerfiles split into prod and dev variants: services now use
Dockerfile(prod) andDockerfile.dev(dev). Tilt supports switching to dev Dockerfiles for live iteration—any custom build references may need updating. ([GitHub]3)
✨ Added
-
Sitemap uploads: “continue on failure” option end-to-end:
🔧 Changed
Release automation (GitHub Actions)
- Release pipeline split into modular workflows (instead of one monolith):
prepare-release,create-release, publish libs, build images, publish chart, etc., with label-gating (prepare-release,refresh-locks,chart-bump) to control progression and avoid unnecessary CI runs. ([GitHub]5) - Docker images built on published releases for all services including
frontendandadmin-frontend, and image digests are collected as artifacts. ([GitHub]5) - Release creation behavior:
create-release.ymlcreates a Git tag + GitHub release when a PR with therefresh-lockslabel is merged (version is extracted from PR title). ([GitHub]5) - Manual chart version bump workflow added (
bump-chart-version.yml). ([GitHub]5)
Frontend
🧭 Migration notes
If you deploy the frontend
-
Replace any usage of:
If you deploy via Helm
- Review and update your
values.yamland referenced Kubernetes secrets to match the new secret field structure and (optionally) usesecretKeyReffor integration with external secret managers. ([GitHub]1)
If you run locally via Tilt
- If you had custom Docker build configuration, ensure you’re pointing dev workflows at
Dockerfile.devwhere appropriate. ([GitHub]3)
Further Changes
- chore: update starlette dependency by @a-klos in #161
- chore: update dependencies for langchain and related packages by @robodev-r2d2 in #165
- chore: bump fastmcp from 2.8.0 to 2.13.1 in /services/mcp-server by @dependabot[bot] in #163
- ci: added dependabot manifest by @robodev-r2d2 in #170
- chore: bump langgraph-checkpoint from 2.1.0 to 3.0.0 in /services/rag-backend by @dependabot[bot] in #169
- chore: bump glob and semantic-release by @dependabot[bot] in #168
- chore: Update appVersion format in Chart.yaml by @a-klos in #172
- chore: Add annotations field to service configuration by @a-klos in #173
- chore: update urllib3 to version 2.6.2 across multiple services by @a-klos in #181
- chore: add timeoutSeconds to startupProbe in frontend deployments by @a-klos in #183
- refactor: composite retriever and make reranker optional by @a-klos in #144
- refactor: Enhance sitemap extraction and summarization features by @robodev-r2d2 in #185
- refactor: frontend by @robodev-r2d2 in #184
- chore: bump aiohttp from 3.12.15 to 3.13.3 in /libs/admin-api-lib by @dependabot[bot] in #193
- chore: bump aiohttp from 3.12.15 to 3.13.3 in /libs/rag-core-api by @dependabot[bot] in #194
- chore: bump aiohttp from 3.12.15 to 3.13.3 in /services/admin-backend by @dependabot[bot] in #195
- chore: bump aiohttp from 3.12.15 to 3.13.3 in /libs/rag-core-lib by @dependabot[bot] in #196
- chore: bump aiohttp from 3.13.2 to 3.13.3 in /libs/extractor-api-lib by @dependabot[bot] in #197
- chore: bump langchain-core from 1.0.7 to 1.2.6 by @dependabot[bot] in #190
- chore: bump mcp from 1.22.0 to 1.23.0 in /services/mcp-server by @dependabot[bot] in #199
- Release/v4 by @a-klos in #209
- chore(release): prepare 4.0.0.post20260122141916 by @a-klos in #211
- chore(release): refresh service lockfiles for 4.0.0 by @a-klos in #216
Full Changelog: v3.4.0...v4.0.0
v3.4.0
3.4.0 (2025-11-17)
Features
- support of more file formats + fallbacks (#155) (0ab2f31), closes /#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L54-R54 /#diff-9879d55539dbabcfd9190ec32b1828dfe5874d5e40d32816db8208de3aeeed1aL13-R95 /#diff-9879d55539dbabcfd9190ec32b1828dfe5874d5e40d32816db8208de3aeeed1aL48-R130 /#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L112-R114 /#diff-9879d55539dbabcfd9190ec32b1828dfe5874d5e40d32816db8208de3aeeed1aL13-R95 /#diff-9879d55539dbabcfd9190ec32b1828dfe5874d5e40d32816db8208de3aeeed1aL48-R130 /#diff-9879d55539dbabcfd9190ec32b1828dfe5874d5e40d32816db8208de3aeeed1aL83-R172 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3R404-R406 /#diff-289e7e7aa5f8a10603dafc1c094fa3487201006a7d5429a0dd9c6c80b3426fcfR28-R63 /#diff-289e7e7aa5f8a10603dafc1c094fa3487201006a7d5429a0dd9c6c80b3426fcfR80-R81 /#diff-289e7e7aa5f8a10603dafc1c094fa3487201006a7d5429a0dd9c6c80b3426fcfL99-R128 /#diff-3ab40efdb049da16ac327c9fbaf8ec1d25f26efbeded4e0c2cfd7f50b976d3ceR80-R87 /#diff-2b6f7f2ec4938055207faa53acf7a300e0ec235db31d1cfb6896703b97292348R39-R49 /#diff-289e7e7aa5f8a10603dafc1c094fa3487201006a7d5429a0dd9c6c80b3426fcfR28-R63 /#diff-3ab40efdb049da16ac327c9fbaf8ec1d25f26efbeded4e0c2cfd7f50b976d3ceL55-L58 /#diff-d72bec7914fc3e7d3fe01a8c0cbdb24832a26956bae5563d109bf8bb19955e0eL12-L20 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3L467-L469 /#diff-2b6f7f2ec4938055207faa53acf7a300e0ec235db31d1cfb6896703b97292348L111-L112 /#diff-dede389bcfb615c4b45cd1da7ac14cbe9535305f41f19cce09e321c91a8bb323R46 /#diff-dede389bcfb615c4b45cd1da7ac14cbe9535305f41f19cce09e321c91a8bb323L79-R80
v3.3.0
3.3.0 (2025-11-07)
Features
- add cql support for confluence extractor (#153) (3647bc2), closes /#diff-2b5524f0cb01b11e336def1a99356a243662de61a73be6dd5da1be89227cf112L57-R80 /#diff-abd3edfc8fadc978097bb0fa2dbc6996a3bc15fa110f2269ae43541b9bf98c64L36-R40 /#diff-abd3edfc8fadc978097bb0fa2dbc6996a3bc15fa110f2269ae43541b9bf98c64R128 /#diff-abd3edfc8fadc978097bb0fa2dbc6996a3bc15fa110f2269ae43541b9bf98c64L36-R40 /#diff-abd3edfc8fadc978097bb0fa2dbc6996a3bc15fa110f2269ae43541b9bf98c64R62 /#diff-a6fc8bcaabdced0bd0b5b642bd5a4aa9cb124a5bbebd0762e76f9dcb0df884c1R25 /#diff-a6fc8bcaabdced0bd0b5b642bd5a4aa9cb124a5bbebd0762e76f9dcb0df884c1L78-R80 /#diff-a6fc8bcaabdced0bd0b5b642bd5a4aa9cb124a5bbebd0762e76f9dcb0df884c1L185-R196 /#diff-0f7547155cd6592b947aae6327e72dbe57073ae43aba24e82ad7ef78fee08153L12-R13 /#diff-0f7547155cd6592b947aae6327e72dbe57073ae43aba24e82ad7ef78fee08153L58-R72 /#diff-e485c1eda5b61acd7bba3807afc19b489ad515ba3a6feddd627596986245c334L13-R15 /#diff-430c5bb0cfd37251a3388659a69ca7cff0726cd2cc40d592b79b55c9f644050dL15-R17
v3.2.1
3.2.1 (2025-10-30)
Bug Fixes
- add missing information for the pyproject toml files and add dedicated documentaion for each lib (#151) (1d95afe), closes /#diff-0064014deac3d21031c406697c008f92f0bb2783aa7eaaaf264a2345eea2cc9eR1-R96 /#diff-9879d55539dbabcfd9190ec32b1828dfe5874d5e40d32816db8208de3aeeed1aR1-R94 /#diff-eb80132f5f4660c40ce8a60f375daec36d19a5e070d120a478f60d74384183d9R1-R96 /#diff-9c5aeb0db77c2eec077d07ddc3b3810ae1a4a1e50ee7061fba37a46706c513fbL7-R19 /#diff-dede389bcfb615c4b45cd1da7ac14cbe9535305f41f19cce09e321c91a8bb323L7-R19 /#diff-9c4162cc1c16dd4c7ec5e95e79df285e8c0882a1db7ff2892c746a0537d26c36L7-R19 /#diff-dede389bcfb615c4b45cd1da7ac14cbe9535305f41f19cce09e321c91a8bb323L139-R148 /#diff-9c5aeb0db77c2eec077d07ddc3b3810ae1a4a1e50ee7061fba37a46706c513fbL7-R19
v3.2.0
v3.1.1
v3.1.0
3.1.0 (2025-10-09)
Features
- exponential retry decorator (#88) (62883be), closes /#diff-d72bec7914fc3e7d3fe01a8c0cbdb24832a26956bae5563d109bf8bb19955e0eR27-R35 /#diff-fc1811e62c75e69c462701871157493af8b72480c2971bfc826f3b2d9c2eacf4R13-R16 /#diff-9f487482fa54d28d71fff497724bbc6741cced8a1e35c9b8829d1c6bd01dca0aR134-R135 /#diff-2b6f7f2ec4938055207faa53acf7a300e0ec235db31d1cfb6896703b97292348R109-R110 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3R200-R207 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3R330-R337 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3R465-R472 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR103-R128 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR201-R226 /#diff-8b7c1816cb3e0a40b7965721c550eefdc184c5d914ec023e36527255613381e7R67 /#diff-8b7c1816cb3e0a40b7965721c550eefdc184c5d914ec023e36527255613381e7R90 /#diff-8b7c1816cb3e0a40b7965721c550eefdc184c5d914ec023e36527255613381e7L139-R143 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR11-R23 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR103-R128 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR201-R226 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR323-R372 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbL117-R147 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR76 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbL159-R192 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR255 /#diff-34194a117b05d75d22ca968cdb7d540839dc7a0eb33960fbca668b5a6ade87cbR274
v3.0.1
3.0.1 (2025-10-08)
Bug Fixes
- bitnami issues (#113) (c9ae73e), closes /#diff-c2ee8653e1d6b85f0aadf87cd438a9250806c052877248442be4d434cbc52425L168-R168 /#diff-c2ee8653e1d6b85f0aadf87cd438a9250806c052877248442be4d434cbc52425L212-R211 /#diff-c2ee8653e1d6b85f0aadf87cd438a9250806c052877248442be4d434cbc52425L249-R247 /#diff-c2ee8653e1d6b85f0aadf87cd438a9250806c052877248442be4d434cbc52425L293-R291 /#diff-c2ee8653e1d6b85f0aadf87cd438a9250806c052877248442be4d434cbc52425L334-R332 /#diff-c2ee8653e1d6b85f0aadf87cd438a9250806c052877248442be4d434cbc52425L352-R350
v3.0.0
3.0.0 (2025-10-07)
⚠ BREAKING CHANGES
- ensure compatibility with the latest Langfuse version (#93)
Code Refactoring
- ensure compatibility with the latest Langfuse version (#93) (3ef2a5a), closes /#diff-fe148c64db46f85d0ef8df1dfbebe80d8a816c2025bef7c15f7ae9282457ac81R165-R198 /#diff-fe148c64db46f85d0ef8df1dfbebe80d8a816c2025bef7c15f7ae9282457ac81L213-R219 /#diff-9c5aeb0db77c2eec077d07ddc3b3810ae1a4a1e50ee7061fba37a46706c513fbL107-R107 /#diff-9c4162cc1c16dd4c7ec5e95e79df285e8c0882a1db7ff2892c746a0537d26c36L34-R34 /#diff-b19ab043535569caf9345971969d115d6515ae951a21b00a278145a28230fba1L21-R21 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3L448-R480 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3L482-R497 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3R512-R582 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3L448-R480 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3L540-L543 /#diff-673dd2d3d4e66a8fd4e45f9c1c9900711313f946bf8b6a89e96c954988fc14f3R615-R619
v2.3.0
2.3.0 (2025-09-23)
Features
- redesign and make easy rebranding possible (#20) (61856f0), closes /#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L111-R111 /#diff-d75aa0c448ddadae4b29e6c34aa5f7331fbacb37d08d956e9c2b23eedd46d3e7R75-R103 /#diff-9a979a1e38ba79e2c75e54c4bf21fe1a2a1b935e1736666565f992e634dadd0fL10-R10 /#diff-f3e59bc57dbbc3efc3a523180fc10892d015c070e3da98d9c4f4544a46bbe09fL1-R1 /#diff-28f7bf29a152b8f8fdc5459c9348fc51e5cfcb8c13a7199c9789ddcadbd8577dL1-R1 /#diff-d75aa0c448ddadae4b29e6c34aa5f7331fbacb37d08d956e9c2b23eedd46d3e7L23-R23 /#diff-ea1c0a3264e5b41498094ec17883df134f4dad44d474fd3ac2c3cb929d6d86c7R1-R25 /#diff-4a605b706d35a31bc48f1af8bfdb3360829ba6f0d59c2dd3dd54972333567c3dR1-R20 /#diff-4edb9e8548cdd91e3f89e64d6c9458fb20da803f73759bc7613c2ccd42abb98eR6-R25 /#diff-aec53716ff6c4f2c234b589983906d2ffddd1cc67eabf7cd5c676fad77ff0751L1-R5 /#diff-aec53716ff6c4f2c234b589983906d2ffddd1cc67eabf7cd5c676fad77ff0751L15-R28 /#diff-98ed9fb0f39bd9e26a573ebe1296e1e723eb79275bd4b4d6064c64dbf81dcefaL1-R35 /#diff-a4d41f884f97f18943db8c18e934c6fbba2c61f180314fae2211a771d11054e4R1-R351 /#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L111-R111 /#diff-d75aa0c448ddadae4b29e6c34aa5f7331fbacb37d08d956e9c2b23eedd46d3e7R75-R103 /#diff-9a979a1e38ba79e2c75e54c4bf21fe1a2a1b935e1736666565f992e634dadd0fL10-R10 /#diff-f3e59bc57dbbc3efc3a523180fc10892d015c070e3da98d9c4f4544a46bbe09fL1-R1