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 }