37a8370f7b
build / build (push) Successful in 1m15s
真实 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 条)。
94 lines
3.3 KiB
Go
94 lines
3.3 KiB
Go
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
|
||
}
|