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>
main
LuckVd 2026-10-12 11:50:11 +08:00 committed by GitHub
parent 21ef506fc9
commit 3c36cb19a2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
13 changed files with 109 additions and 37 deletions

View File

@ -2,7 +2,7 @@
services:
# 只启动依赖的基础设施服务
postgres:
image: paradedb/paradedb:v0.22.6-pg17
image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-postgres-dev
ports:
- "${DB_PORT:-5432}:5432"
@ -382,7 +382,7 @@ services:
# ---------------------------------------------------------------------------
# 复用 dev 已有的 ParadeDB 镜像,不额外拉 postgres 镜像
langfuse-db-init:
image: paradedb/paradedb:v0.22.6-pg17
image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-langfuse-db-init-dev
depends_on:
postgres:

View File

@ -541,7 +541,7 @@ services:
# 修改的PostgreSQL配置
postgres:
image: paradedb/paradedb:v0.22.6-pg17
image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-postgres
environment:
- POSTGRES_USER=${DB_USER}
@ -819,7 +819,7 @@ services:
# 一次性初始化脚本:在已有的 WeKnora-postgres 里创建 langfuse 数据库(幂等,数据库已存在则跳过)
# 复用 WeKnora-postgres 的 ParadeDB 镜像,避免多拉一个 postgres 镜像
langfuse-db-init:
image: paradedb/paradedb:v0.22.6-pg17
image: paradedb/paradedb:v0.25.11-pg17
container_name: WeKnora-langfuse-db-init
depends_on:
postgres:

View File

@ -20,7 +20,7 @@ import (
// both spellings need the same assertions. For example:
//
// docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \
// paradedb/paradedb:v0.22.6-pg17
// paradedb/paradedb:v0.25.11-pg17
// WEKNORA_REPOSITORY_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable
//
// Both runs apply the real chunk_images migration, so the triggers and the

View File

@ -18,7 +18,7 @@ import (
// at a disposable database, for example:
//
// docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \
// paradedb/paradedb:v0.22.6-pg17
// paradedb/paradedb:v0.25.11-pg17
// WEKNORA_MIGRATION_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable
//
// It checks what SQLite cannot: that 000106 builds its index CONCURRENTLY

View File

@ -21,6 +21,15 @@ BEGIN
SELECT 1 FROM pg_available_extension_versions
WHERE name = 'pg_search' AND version = '0.22.6'
) THEN
-- Newer images only ship the latest install script; 000115 upgrades
-- them directly. Updating the catalog to 0.22.6 there would mismatch
-- the shared library.
IF EXISTS (
SELECT 1 FROM pg_available_extension_versions
WHERE name = 'pg_search' AND version = '0.25.11'
) THEN
RETURN;
END IF;
RAISE NOTICE 'pg_search 0.22.6 is not available; update the server image and run ALTER EXTENSION pg_search UPDATE TO ''0.22.6'' manually';
RETURN;
END IF;

View File

@ -0,0 +1,2 @@
-- No-op: extension SQL upgrades cannot be reversed by a schema rollback.
-- Restore a pre-upgrade database backup together with the matching old image.

View File

@ -0,0 +1,34 @@
-- Complete the SQL side of the ParadeDB v0.22.x -> v0.25.11 image upgrade.
-- A catalog left at an older version than the server's shared library can
-- crash the whole server when its SQL functions are called (for example
-- paradedb.version_info()), so the catalog must follow the image.
DO $$
DECLARE
search_version TEXT;
vector_version TEXT;
BEGIN
IF current_setting('app.skip_embedding', true) = 'true' THEN
RETURN;
END IF;
-- Leave absent extensions and other release lines under operator control.
-- Do not downgrade a newer extension or upgrade an external server to its
-- potentially incompatible default version.
SELECT extversion INTO search_version FROM pg_extension WHERE extname = 'pg_search';
IF search_version ~ '^0\.(22|23|24|25)\.[0-9]+$' AND search_version <> '0.25.11'
AND EXISTS (
SELECT 1 FROM pg_available_extension_versions
WHERE name = 'pg_search' AND version = '0.25.11'
) THEN
ALTER EXTENSION pg_search UPDATE TO '0.25.11';
END IF;
SELECT extversion INTO vector_version FROM pg_extension WHERE extname = 'vector';
IF vector_version IN ('0.8.0', '0.8.1', '0.8.2', '0.8.3')
AND EXISTS (
SELECT 1 FROM pg_available_extension_versions
WHERE name = 'vector' AND version = '0.8.4'
) THEN
ALTER EXTENSION vector UPDATE TO '0.8.4';
END IF;
END $$;

View File

@ -1,7 +1,7 @@
"""Verify a ParadeDB patch upgrade using disposable Docker volumes and real migrations.
Requires Python 3 and Docker; no database credentials or running WeKnora needed.
Run: python3 scripts/test_paradedb_upgrade.py
Run: python3 scripts/test_paradedb_upgrade.py [--to 0.25.11|0.22.6]
Artifacts (snapshots, plans, logs and a synthetic-data backup) are kept in /tmp.
"""
import argparse
@ -17,6 +17,12 @@ import uuid
ROOT = pathlib.Path(__file__).resolve().parents[1]
OUT = None
CONTAINER = 'weknora-pdb-upgrade-' + uuid.uuid4().hex[:12]
# target pg_search version -> (image, expected vector version or None if unchanged)
TARGETS = {
'0.22.6': ('paradedb/paradedb:v0.22.6-pg17', None),
'0.25.11': ('paradedb/paradedb:v0.25.11-pg17', '0.8.4'),
}
UPGRADES = ['000099_pg_search_0226.up.sql', '000115_pg_search_02511.up.sql']
def sql(query, db='weknora'):
p = subprocess.run(['docker', 'exec', '-i', CONTAINER, 'psql', '-X', '-qAt', '-U', 'postgres', '-d', db, '-v', 'ON_ERROR_STOP=1'], input=query, text=True, capture_output=True)
@ -126,7 +132,9 @@ def migrate(db, paths, label):
with (OUT/(label+'.log')).open('w') as log:
for path in paths:
log.write(path.name+'\n')
sql('BEGIN;\n'+path.read_text()+'\nCOMMIT;', db)
text = path.read_text()
# CONCURRENTLY cannot run in a transaction block; golang-migrate does not add one either.
sql(text if 'CONCURRENTLY' in text else 'BEGIN;\n'+text+'\nCOMMIT;', db)
print(f'{label}: {len(paths)} SQL migrations passed', flush=True)
@ -149,6 +157,7 @@ def main():
global OUT
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--output-dir', type=pathlib.Path)
parser.add_argument('--to', choices=sorted(TARGETS), default='0.25.11', help='target pg_search version')
args = parser.parse_args()
OUT = args.output_dir or pathlib.Path(tempfile.mkdtemp(prefix='weknora-pdb-upgrade-'))
OUT.mkdir(parents=True, exist_ok=True)
@ -156,19 +165,26 @@ def main():
raise RuntimeError('Use an empty output directory')
print('Evidence: '+str(OUT), flush=True)
volume = CONTAINER+'-data'
old, new = 'paradedb/paradedb:v0.22.2-pg17', 'paradedb/paradedb:v0.22.6-pg17'
old = 'paradedb/paradedb:v0.22.2-pg17'
target = args.to
new, vector_target = TARGETS[target]
paths = sorted((ROOT/'migrations/versioned').glob('*.up.sql'))
baseline = [p for p in paths if int(p.name.split('_')[0]) < 99]
upgrade = ROOT/'migrations/versioned/000099_pg_search_0226.up.sql'
upgrade = [ROOT/'migrations/versioned'/name for name in UPGRADES]
upgrade_sql = '\n'.join(p.read_text() for p in upgrade)
search_version = "SELECT extversion FROM pg_extension WHERE extname='pg_search'"
vector_version = "SELECT extversion FROM pg_extension WHERE extname='vector'"
# Only resources created by this invocation are ever removed.
docker('volume', 'create', volume)
try:
start(old, volume)
migrate('weknora', baseline, 'old-migrations')
assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
assert sql(search_version) == '0.22.2'
old_vector = sql(vector_version)
# Older external servers without the target package must remain usable.
migrate('weknora', [upgrade], 'unavailable-target')
assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
migrate('weknora', upgrade, 'unavailable-target')
assert sql(search_version) == '0.22.2'
assert sql(vector_version) == old_vector
seed()
snapshot('before')
with (OUT/'before.dump').open('wb') as backup:
@ -177,12 +193,14 @@ def main():
docker('rm', CONTAINER)
start(new, volume)
# Replacing the image alone leaves the SQL catalog at the old version.
assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade.read_text()+"\nCOMMIT;")
assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'
migrate('weknora', [upgrade, upgrade], 'extension-upgrade-and-idempotence')
assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.6'
assert sql('SELECT version FROM paradedb.version_info()') == '0.22.6'
assert sql(search_version) == '0.22.2'
sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade_sql+"\nCOMMIT;")
assert sql(search_version) == '0.22.2'
migrate('weknora', upgrade + upgrade, 'extension-upgrade-and-idempotence')
assert sql(search_version) == target
assert sql(vector_version) == (vector_target or old_vector)
# Calls into the shared library crash the server if the catalog lags behind it.
assert sql('SELECT version FROM paradedb.version_info()') == target
snapshot('after')
docker('restart', '-t', '60', CONTAINER)
for _ in range(60):
@ -195,10 +213,10 @@ def main():
check_writes()
sql('CREATE DATABASE upgrade_fresh TEMPLATE template0')
# The new migration must not install pg_search on non-search databases.
migrate('upgrade_fresh', [upgrade], 'absent-extension')
assert sql("SELECT count(*) FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0'
migrate('upgrade_fresh', upgrade, 'absent-extension')
assert sql("SELECT count(*) FROM pg_extension WHERE extname IN ('pg_search','vector')", 'upgrade_fresh') == '0'
migrate('upgrade_fresh', paths, 'fresh-migrations')
assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0.22.6'
assert sql(search_version, 'upgrade_fresh') == target
sql("INSERT INTO embeddings(source_id,source_type,content,dimension) VALUES ('fresh',0,'新安装检索',1024)", 'upgrade_fresh')
assert sql("SELECT count(*) FROM embeddings WHERE content ||| '检索'", 'upgrade_fresh') == '1'
print('PASS: fresh install and Chinese BM25 query', flush=True)

View File

@ -43,7 +43,7 @@ flowchart TB
- **源码编译**:Go 1.26(见 `docker/Dockerfile.app` builder 阶段 `golang:1.26-bookworm`)、CGO(依赖 `libsqlite3-dev`)、Node.js + npm(前端)、Python 3.10 + uv(docreader)。
- **Kubernetes**:>= 1.25.0(`helm/Chart.yaml`)。
Compose 默认 ParadeDB `v0.22.6-pg17` 的 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2。这不代表所有 ARM CPU 或其他可选服务均兼容。
Compose 默认 ParadeDB 镜像自 `v0.22.6-pg17` 起 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2;更高镜像版本的基线以 ParadeDB 官方发布说明为准。这不代表所有 ARM CPU 或其他可选服务均兼容。
## 一、Docker Compose 标准部署(docker-compose.yml)
@ -88,7 +88,7 @@ docker compose up -d
| `frontend` | `wechatopenai/weknora-ui:${WEKNORA_VERSION:-latest}` | `${FRONTEND_PORT:-80}:80` | app(healthy) | Nginx 托管 SPA 并反代到 app;`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远程后端 |
| `app` | `wechatopenai/weknora-app` | `${APP_PORT:-8080}:8080` | postgres(healthy)、redis、docreader(healthy) | Go 后端;挂载 `./config/config.yaml`、`data-files` 卷;健康检查 `GET /health` |
| `docreader` | `wechatopenai/weknora-docreader` | 仅 `expose: 50051`(不发布到宿主机) | — | 文档解析 gRPC 服务;健康检查 `grpc_health_probe`;与 app 共享 `docreader-tmp` 卷传递图片 |
| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 |
| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 |
| `redis` | `redis:7.0-alpine` | 不映射宿主端口 | — | `--appendonly yes --requirepass ${REDIS_PASSWORD}` |
### 可选服务与 profiles

View File

@ -1,6 +1,11 @@
# ParadeDB 存量库升级
仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.22.6-pg17`。本文处理 **0.22.2 → 0.22.6、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。
仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.25.11-pg17`。本文处理 **0.22.x → 0.25.11、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。
该版本线相对 `v0.22.6-pg17` 带来 PostgreSQL 17.9 → 17.11、pgvector 0.8.1 → 0.8.4(修复并行 HNSW 构建缓冲区溢出与 HNSW vacuum 期间的索引损坏)以及 pg_search 基于 WAL 的崩溃恢复(0.24.0 起,见 paradedb#4901)。
> [!WARNING]
> 替换镜像后**必须**把扩展 catalog 升级到与镜像一致的版本。catalog 停留在旧版本时,部分扩展 SQL 函数(例如 `paradedb.version_info()`)会因签名与新二进制不匹配而触发段错误,导致整个 PostgreSQL 实例崩溃并进入恢复。也**不要**在新镜像上执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`,它同样会造成上述不匹配。
## 升级步骤
@ -31,35 +36,39 @@
docker compose up -d --no-deps --wait postgres
```
4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。
4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。新镜像自带 0.22.x 起的完整升级脚本链,任意 0.22.x 都可以一步升级到镜像默认版本:
```bash
docker compose exec -T postgres sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -v ON_ERROR_STOP=1' <<'SQL'
ALTER EXTENSION pg_search UPDATE TO '0.22.6';
ALTER EXTENSION pg_search UPDATE;
ALTER EXTENSION vector UPDATE;
SELECT extname, extversion FROM pg_extension WHERE extname IN ('pg_search', 'vector');
SELECT * FROM paradedb.version_info();
SQL
```
在**其他已安装 `pg_search` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。catalog 与 `paradedb.version_info()` 应均报告 0.22.6。
在**其他已安装 `pg_search` 或 `vector` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。`pg_search` 的 catalog 与 `paradedb.version_info()` 应均报告 0.25.11,`vector` 应为 0.8.4。
5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。这个补丁升级无需专门重建全部索引或重新导入文档;保留备份直到验证完成。
5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。已有的 BM25 与 HNSW 索引在新版本下可继续读写,无需专门重建全部索引或重新导入文档;如遇异常可 `REINDEX`。保留备份直到验证完成。
## 自动迁移的范围
迁移 `000099` 仅在 WeKnora 数据库内执行扩展升级:已安装版本须为 0.22.2–0.22.5,且服务器提供 0.22.6 扩展包。它遵守 `app.skip_embedding`,不安装缺失的扩展,也不处理其他版本线。
WeKnora 启动时的迁移只在 WeKnora 数据库内升级扩展,遵守 `app.skip_embedding`,不安装缺失的扩展,也不降级或处理其他版本线:
如果这条迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有 `000099` 的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。
- `000115`:已安装的 `pg_search` 为 0.22.0–0.25.10 且服务器提供 0.25.11 时,升级到 0.25.11;已安装的 `vector` 为 0.8.0–0.8.3 且服务器提供 0.8.4 时,升级到 0.8.4。
- `000099`:历史迁移,仅在服务器提供 0.22.6 扩展包(即仍使用 `v0.22.6-pg17` 镜像)时把 0.22.2–0.22.5 升级到 0.22.6;新镜像上会跳过,交给 `000115`。
如果这些迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有对应迁移的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。
## 回滚与复现验证
回滚需要将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更,`000099` 的 down 文件也不会尝试降级扩展。
回滚只能将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更;而且 pg_search 0.24 起会向 WAL 写入自定义资源管理器记录,旧镜像无法重放这些记录。迁移的 down 文件也不会尝试降级扩展。
仓库提供隔离验证脚本:
仓库提供隔离验证脚本,默认验证 0.22.2 → 0.25.11,也可用 `--to 0.22.6` 验证历史补丁升级:
```bash
docker pull paradedb/paradedb:v0.22.2-pg17
docker pull paradedb/paradedb:v0.22.6-pg17
docker pull paradedb/paradedb:v0.25.11-pg17
python3 scripts/test_paradedb_upgrade.py
```

View File

@ -13,7 +13,7 @@ WeKnora 采用"主服务 + 前端 + 文档解析微服务"的三进程核心架
| `app` | `wechatopenai/weknora-app`(`docker/Dockerfile.app`,Go) | `8080` | 主后端:REST API、RAG 检索、Agent 引擎、异步任务 worker、IM/Embed 渠道接入。健康检查 `GET /health` |
| `frontend` | `wechatopenai/weknora-ui`(`frontend/`,NGINX + Vue3 静态产物) | `80` | Web UI;NGINX 同时充当反向代理,将 `/api` 转发到 `app`(`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远端后端) |
| `docreader` | `wechatopenai/weknora-docreader`(`docker/Dockerfile.docreader`,Python) | `50051`(仅 compose 网络内 expose,不映射宿主机) | 文档解析微服务:gRPC 服务端,PDF/DOCX/Excel/EPUB/网页等 25+ 格式解析与页面渲染。健康检查 `grpc_health_probe` |
| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) |
| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) |
| `redis` | `redis:7.0-alpine`(`appendonly` + `requirepass`) | `6379`(网络内) | Asynq 任务队列、SSE 流管理(跨实例)、system_settings 发布订阅、限流与分布式模型并发闸门 |
| `sandbox` | `wechatopenai/weknora-sandbox`(`docker/Dockerfile.sandbox`) | — | WeKnora 标准运行镜像;可直接用于空间 Docker 后端,接入 CubeSandbox/E2B 时则通过模板 API 自动注册并用于 Agent Skills |

View File

@ -64,7 +64,7 @@ make dev-restart # 重启
| 服务 | 镜像 | 端口(默认) | 启动条件 |
| --- | --- | --- | --- |
| `postgres` | `paradedb/paradedb:v0.22.6-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 |
| `postgres` | `paradedb/paradedb:v0.25.11-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 |
| `redis` | `redis:7.0-alpine`(`--requirepass`) | `6379` | 默认启动 |
| `docreader` | 本地构建 `docker/Dockerfile.docreader` | `50051`(gRPC) | 默认启动 |
| `searxng`(+`searxng-init`) | `searxng/searxng:latest` | `127.0.0.1:8888` | `--searxng` / `--full`(compose profile `searxng`) |

View File

@ -413,7 +413,7 @@ make migrate-up
BM25 索引(`USING bm25`、Lindera 中文分词)只在 ParadeDB 可用;原生 Postgres 部署需保证相应迁移的条件分支生效或改用 Elasticsearch 等外部检索引擎。存量原生 Postgres 库切到 ParadeDB 可参考 `migrations/paradedb/01-migrate-to-paradedb.sql`。
官方镜像自 v0.8.2 起为 `paradedb/paradedb:v0.22.6-pg17`。迁移 000099 只把已安装的 pg_search 0.22.2–0.22.5 升级到 0.22.6:若启动日志提示 `pg_search 0.22.6 is not available`,说明数据库镜像还没换,换镜像后手工执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`;其他版本线不会被自动升级或降级。
官方镜像为 `paradedb/paradedb:v0.25.11-pg17`(v0.8.2 起曾为 `v0.22.6-pg17`)。迁移 000115 在服务器提供对应扩展包时,把已安装的 pg_search 0.22.0–0.25.10 升级到 0.25.11、pgvector 0.8.0–0.8.3 升级到 0.8.4;历史迁移 000099 仅在仍使用 `v0.22.6-pg17` 镜像时生效。其他版本线不会被自动升级或降级。扩展 catalog 必须与镜像版本一致,否则调用部分扩展函数会使数据库崩溃;手工升级见《ParadeDB 存量库升级》,在新镜像上不要执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`。
### 版本文件冲突 {#_7-5-版本文件冲突}