WeKnora/scripts
LuckVd 3c36cb19a2
fix(deploy): bump paradedb image to v0.25.11-pg17 (#4120)
* fix(deploy): bump paradedb image to v0.25.11-pg17

Batch-importing large knowledge bases on the pinned
paradedb/paradedb:v0.22.6-pg17 image drives PostgreSQL into a
PANIC/crash-recovery loop (corrupted page pointers in shared buffers,
amcheck clean, no OOM), taking every ingest task down with it.

Three independent fixes upstream cover this exact write path, and the
pinned image predates all of them:

- pgvector 0.8.2 fixed a buffer overflow in parallel HNSW index
  builds, 0.8.3 fixed possible index corruption during HNSW vacuuming,
  and 0.8.4 fixed inserts during HNSW vacuuming; the image ships
  pgvector 0.8.1, and the embeddings table maintains three HNSW
  halfvec indexes on import.
- pg_search gained WAL-based crash recovery in 0.24.0 (paradedb#4901):
  without it, any backend crash corrupts BM25 segment metadata and
  turns a single crash into a recovery loop (paradedb#4935).
- PostgreSQL core moved 17.9 -> 17.11; its release notes contain no
  fix matching this failure signature, ruling the core out.

Bump the compose image tags to v0.25.11-pg17 (postgres and
langfuse-db-init, prod and dev) and update the docs that pin the old
tag. Fresh installs are covered by the existing schema SQL (verified
against 0.25.11: extensions, BM25 index and HNSW halfvec indexes all
create cleanly). Existing data volumes keep working across the image
swap without any action (keyword and vector queries byte-identical in
testing); ALTER EXTENSION pg_search/vector UPDATE aligns the SQL
catalog afterwards, and migration 000099 is a no-op for 0.25.x by
design. The Helm chart pins a different image line and is left alone.

Fixes #4077

* fix(migrations): upgrade pg_search catalog to 0.25.11 with the image

Swapping in the v0.25.11 image leaves the extension catalog at 0.22.x.
Calling extension functions such as paradedb.version_info() against the
mismatched catalog segfaults the backend and sends the whole server into
crash recovery, so the catalog upgrade is required rather than optional.

- Add migration 000115 to update pg_search 0.22.0-0.25.10 to 0.25.11 and
  pgvector 0.8.0-0.8.3 to 0.8.4 when the server ships those versions.
- Skip 000099 on newer images instead of advising UPDATE TO '0.22.6',
  which leaves the catalog behind the shared library and crashes.
- Rewrite the upgrade guide as one 0.22.x -> 0.25.11 path with a required
  ALTER EXTENSION UPDATE and a note that rollback needs a backup.
- Extend scripts/test_paradedb_upgrade.py to verify 0.22.2 -> 0.25.11 by
  default (--to 0.22.6 keeps the old path) and run CONCURRENTLY
  migrations outside a transaction like golang-migrate does.

---------

Co-authored-by: LuckVd <LuckVd@users.noreply.github.com>
Co-authored-by: wizardchen <wizardchen@tencent.com>
2026-10-12 11:50:11 +08:00
..
cloud-image docs: 迁移有效文档至 website-docs 并清理旧文档 (#3580) 2026-09-22 23:25:40 +08:00
git-hooks fix(sandbox): separate file access from artifact publishing (#3356) 2026-09-17 16:18:01 +08:00
model-catalog refactor(models): separate provider definitions, model catalogs, and runtime configuration (#3589) 2026-09-23 14:20:08 +08:00
browserskill-release.json chore: update BrowserSkill extension version to 0.3.1 and enhance localization support 2026-09-23 17:12:19 +08:00
browserskill.md chore: update BrowserSkill extension version to 0.3.1 and enhance localization support 2026-09-23 17:12:19 +08:00
build-anydoc-lib.sh fix(anydoc): rebuild truncated patched crate instead of failing cargo 2026-08-21 16:16:33 +08:00
build_browserskill.sh chore: update BrowserSkill extension version to 0.3.1 and enhance localization support 2026-09-23 17:12:19 +08:00
build_frontend_dist.sh feat(ui): multi-stage Docker frontend build (no host npm) (#3074) 2026-09-07 19:33:57 +08:00
build_images.sh feat: support app and docreader build download mirrors (#4073) 2026-10-09 14:28:47 +08:00
check-env.sh feat(storage): support AWS S3 NoAk default credentials (#2008) 2026-08-05 11:59:02 +08:00
check-license-bundle.sh chore: remove vendored archives and unused Python helpers 2026-09-16 15:49:36 +08:00
copy-licenses.sh chore: remove vendored archives and unused Python helpers 2026-09-16 15:49:36 +08:00
dev.sh fix(dev): propagate dev.sh exit status and pull MinIO from pgsty/minio 2026-09-26 15:30:27 +08:00
docker-entrypoint.sh feat(agent): unify sandbox tools and drop host preloaded skills (#3033) 2026-09-05 16:45:59 +08:00
get_version.sh feat: introduce WeKnora Lite edition with lightweight configuration and deployment 2026-03-02 21:21:49 +08:00
install-git-hooks.sh fix(sandbox): separate file access from artifact publishing (#3356) 2026-09-17 16:18:01 +08:00
migrate.sh feat: 支持数据库迁移脏状态自动恢复和Neo4j连接重试机制 2025-12-08 19:38:16 +08:00
model_catalog_diff.py refactor(models): separate provider definitions, model catalogs, and runtime configuration (#3589) 2026-09-23 14:20:08 +08:00
package-lite.sh fix: remove GPL converter and bundle third-party license sources 2026-09-08 15:19:10 +08:00
package-mac-app.sh fix: remove GPL converter and bundle third-party license sources 2026-09-08 15:19:10 +08:00
quick-dev.sh refactor(tracing): remove Jaeger integration and related components 2026-06-08 21:01:04 +08:00
start_all.sh feat(ui): multi-stage Docker frontend build (no host npm) (#3074) 2026-09-07 19:33:57 +08:00
test-git-hooks.sh fix(sandbox): separate file access from artifact publishing (#3356) 2026-09-17 16:18:01 +08:00
test-homebrew.sh Revert "chore: make Lite edition support and related configurations hidden" 2026-04-11 18:51:16 +08:00
test-license-bundle.sh chore: remove vendored archives and unused Python helpers 2026-09-16 15:49:36 +08:00
test_browserskill_extension.mjs chore: update BrowserSkill extension version to 0.3.1 and enhance localization support 2026-09-23 17:12:19 +08:00
test_embed_nginx.py fix(mcp): proxy server endpoints through frontend gateways 2026-09-22 17:36:03 +08:00
test_paradedb_upgrade.py fix(deploy): bump paradedb image to v0.25.11-pg17 (#4120) 2026-10-12 11:50:11 +08:00
update-homebrew-formula.sh Revert "chore: make Lite edition support and related configurations hidden" 2026-04-11 18:51:16 +08:00
verify_frontend_pr.sh chore(cursor): run frontend CI before gh pr create 2026-07-31 11:54:20 +08:00