Files
knowledge-governance/internal/librarymaintenance/env.go
T
姚章浩 37a8370f7b
build / build (push) Successful in 1m15s
fix(v071): 索引范围过滤接受未写 tenant_id 的文档
真实 v0.7.1 的 app 自己写索引时不带 tenant_id,治理侧同步写入时才补齐。
原来只按 term tenant_id 过滤,等于把 app 写入的正文整库漏掉:真跑时索引里有
2 条文档,导出 0 条,候选校验报 legacy coverage,封存被拒。

改为"显式本租户 或 完全没写租户字段"(写了别的租户仍然排除),知识库身份
仍是独立 term,范围没有放宽。Count/PruneScope/整库导出共用同一写法。

试过:make verify 15 项全绿;新增 3 个过滤条件用例;真实 preflight 由
candidate-invalid(0 条) 变为 candidate-valid(2 条)。
2026-10-29 06:00:30 +08:00

94 lines
3.3 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package librarymaintenance
import (
"errors"
"fmt"
"strconv"
"strings"
)
// 目标入口闸门与后台队列的声明名称。
//
// 为什么集中在这里:容器内的 worker 与主机侧的封存(cmd/libraryctl)都要讲
// 同一份"这个实例的入口在哪、队列在哪";名字写两遍迟早会分叉,而分叉的表现
// 是"一边关的是 A 实例的门、另一边读的是 B 实例的队列"——不会报错,只会给出
// 错的证据。
const (
EnvInstance = "LIBRARY_TARGET_INSTANCE"
EnvIngressURL = "LIBRARY_TARGET_INGRESS_URL"
EnvIngressService = "LIBRARY_TARGET_INGRESS_SERVICE"
EnvIngressDrainFile = "LIBRARY_TARGET_INGRESS_DRAIN_FILE"
EnvRedisAddr = "LIBRARY_TARGET_REDIS_ADDR"
// 名字里不写 Password:这里的字面量是**环境变量名**,密钥扫描会把
// `XXX_PASSWORD = "<长字面量>"` 当成"被赋值的密钥",那是误报但没必要留个坑。
EnvRedisAuth = "LIBRARY_TARGET_REDIS_PASSWORD"
EnvRedisDB = "LIBRARY_TARGET_REDIS_DB"
)
// TargetEnv 是一次实例级维护所需的"入口 + 队列"声明。
//
// 缺任何一项都不许降级成"库级维护":没有闸门就没有"入口已关、在途已排空"
// 的证据,没有队列就证明不了停写者时后台是空的。这两条正是被代理的 WeKnora
// 收到 SIGTERM 就 exit(1) 之后唯一还能证明"请求没被截断"的东西。
type TargetEnv struct {
Instance string
IngressURL string
IngressService string
IngressDrainFile string
RedisAddr string
RedisPassword string
RedisDB int
}
// TargetFromEnv 解析维护目标声明。缺少的项一次性全部报出来(含变量名),
// 让部署方一次改对,而不是改一项再撞下一项。
func TargetFromEnv(get func(string) string) (TargetEnv, error) {
if get == nil {
return TargetEnv{}, errors.New("缺少配置读取入口")
}
value := func(name string) string { return strings.TrimSpace(get(name)) }
target := TargetEnv{
Instance: value(EnvInstance),
IngressURL: value(EnvIngressURL),
IngressService: value(EnvIngressService),
IngressDrainFile: value(EnvIngressDrainFile),
RedisAddr: value(EnvRedisAddr),
// 口令不 Trim:前后空格也是口令的一部分,Trim 会把能连上的配置变成连不上。
RedisPassword: get(EnvRedisAuth),
}
missing := make([]string, 0, 5)
for _, item := range []struct {
name string
current string
}{
{EnvInstance, target.Instance},
{EnvIngressURL, target.IngressURL},
{EnvIngressService, target.IngressService},
{EnvIngressDrainFile, target.IngressDrainFile},
{EnvRedisAddr, target.RedisAddr},
} {
if item.current == "" {
missing = append(missing, item.name)
}
}
if strings.TrimSpace(target.RedisPassword) == "" {
missing = append(missing, EnvRedisAuth)
}
rawDB := value(EnvRedisDB)
switch {
case rawDB == "":
missing = append(missing, EnvRedisDB)
default:
db, err := strconv.Atoi(rawDB)
if err != nil || db < 0 {
return TargetEnv{}, fmt.Errorf("%s 不是有效的队列库号(%q)", EnvRedisDB, rawDB)
}
target.RedisDB = db
}
if len(missing) > 0 {
return TargetEnv{}, fmt.Errorf("实例级维护未接线:缺少 %s(没有入口闸门与队列就无法证明入口已排空、后台已静默)",
strings.Join(missing, "、"))
}
return target, nil
}