5bf4aae30e
build / build (push) Successful in 1m42s
F17:MarkArtifactFetched 与已验证内容复用都在同一事务内经过策略、来源启用、 过滤、superseded 和当前绑定的复核后,自动把 planned 转 pending 并入队唯一 test.upload;确认与作业幂等,失败整笔回滚。356 已卡记录可对同一文件再次保存 当前策略,经同一路径恢复,不做全库补扫或手工补队列。来源页提示改为自动接续。 F14:来源→监控定位清空未结束/动作/阶段/时间筛选;来源目录定位改为一次性请求 并由父消费,revision/sources 重载不再重放旧请求,手工换目录保持。 F13:抽出 readiness.Resolver 作为端点/绑定/凭据唯一来源;worker 上传/轮询/ 校验/移除改用动态客户端,每次调用重读有效配置,不再固化启动 env 客户端。 验证:隔离 PG 的 F17 正负例与恢复用例、前端挂载定位回归、全量 Go/前端测试 及 make verify 17 项通过。未部署、未做 8088 UI 验收。
149 lines
4.5 KiB
Go
149 lines
4.5 KiB
Go
package readiness
|
||
|
||
import (
|
||
"context"
|
||
"errors"
|
||
"fmt"
|
||
"net/http"
|
||
"net/url"
|
||
"strings"
|
||
"time"
|
||
|
||
"knowledge-governance/internal/platform/weknora"
|
||
)
|
||
|
||
// WeKnora 的 readiness 探测必须与业务执行链看同一个目标:网页保存的端点、
|
||
// 当前生效的知识库绑定、同一份 API Key。任何一项在启动时被捕获成常量,
|
||
// 都会在管理员改绑之后继续探测旧库(F13:旧库 404 被当成整个服务不可用)。
|
||
|
||
var (
|
||
ErrNotConfigured = errors.New("WeKnora 就绪探测未配置")
|
||
ErrKnowledgeBaseMissing = errors.New("WeKnora 探测目标知识库不存在")
|
||
ErrNoPermission = errors.New("WeKnora 探测目标知识库无读取权限")
|
||
)
|
||
|
||
type Target struct {
|
||
BaseURL string
|
||
KnowledgeBaseID string
|
||
APIKey string
|
||
}
|
||
|
||
type Result struct {
|
||
// Target 是脱敏后的探测对象(实例 + 短 ID),用于界面说明“探的是谁”。
|
||
Target string
|
||
Err error
|
||
}
|
||
|
||
// Prober 每次 Check 都重新解析目标并新建客户端:端点、凭据、绑定都允许
|
||
// 在进程运行期间变化,不能缓存成启动快照。
|
||
// Resolver is the single source for the effective WeKnora target: endpoint
|
||
// saved in the console (env fallback), current persisted binding (env fallback)
|
||
// and the same key file. API probes and worker clients both use it, so a
|
||
// runtime settings/binding change cannot leave one side on the old value.
|
||
type Resolver struct {
|
||
Endpoint func(context.Context) string
|
||
LoadBinding func(context.Context) (string, error)
|
||
ReadKey func() (string, error)
|
||
DefaultKB string
|
||
}
|
||
|
||
func (resolver Resolver) Resolve(ctx context.Context) (Target, error) {
|
||
knowledgeBaseID := strings.TrimSpace(resolver.DefaultKB)
|
||
if resolver.LoadBinding != nil {
|
||
stored, err := resolver.LoadBinding(ctx)
|
||
if err != nil {
|
||
return Target{}, fmt.Errorf("读取当前知识库绑定失败")
|
||
}
|
||
if stored = strings.TrimSpace(stored); stored != "" {
|
||
knowledgeBaseID = stored
|
||
}
|
||
}
|
||
apiKey := ""
|
||
if resolver.ReadKey != nil {
|
||
value, err := resolver.ReadKey()
|
||
if err != nil {
|
||
return Target{}, fmt.Errorf("读取 WeKnora API 凭据失败")
|
||
}
|
||
apiKey = strings.TrimSpace(value)
|
||
}
|
||
baseURL := ""
|
||
if resolver.Endpoint != nil {
|
||
baseURL = strings.TrimSpace(resolver.Endpoint(ctx))
|
||
}
|
||
return Target{BaseURL: baseURL, KnowledgeBaseID: knowledgeBaseID, APIKey: apiKey}, nil
|
||
}
|
||
|
||
type Prober struct {
|
||
Resolve func(context.Context) (Target, error)
|
||
Timeout time.Duration
|
||
AllowDockerHTTP bool
|
||
}
|
||
|
||
func (prober Prober) Check(ctx context.Context) Result {
|
||
if prober.Resolve == nil {
|
||
return Result{Err: ErrNotConfigured}
|
||
}
|
||
target, err := prober.Resolve(ctx)
|
||
if err != nil {
|
||
return Result{Err: err}
|
||
}
|
||
described := describe(target)
|
||
if strings.TrimSpace(target.BaseURL) == "" || strings.TrimSpace(target.KnowledgeBaseID) == "" || strings.TrimSpace(target.APIKey) == "" {
|
||
return Result{Target: described, Err: ErrNotConfigured}
|
||
}
|
||
timeout := prober.Timeout
|
||
if timeout <= 0 || timeout > 10*time.Second {
|
||
timeout = 10 * time.Second
|
||
}
|
||
client, err := weknora.NewClient(weknora.ClientConfig{
|
||
BaseURL: target.BaseURL,
|
||
APIKey: target.APIKey,
|
||
Timeout: timeout,
|
||
AllowDockerHTTP: prober.AllowDockerHTTP,
|
||
})
|
||
if err != nil {
|
||
return Result{Target: described, Err: err}
|
||
}
|
||
if _, _, err := client.ListKnowledge(ctx, target.KnowledgeBaseID, 1, 1); err != nil {
|
||
return Result{Target: described, Err: classify(target, described, err)}
|
||
}
|
||
return Result{Target: described}
|
||
}
|
||
|
||
func classify(target Target, described string, err error) error {
|
||
var httpErr *weknora.HTTPError
|
||
if errors.As(err, &httpErr) {
|
||
switch httpErr.StatusCode {
|
||
case http.StatusNotFound:
|
||
return fmt.Errorf("%w(%s)", ErrKnowledgeBaseMissing, described)
|
||
case http.StatusUnauthorized, http.StatusForbidden:
|
||
return fmt.Errorf("%w(%s)", ErrNoPermission, described)
|
||
case http.StatusTooManyRequests:
|
||
return fmt.Errorf("目标知识库读取被限流(HTTP 429,%s)", described)
|
||
}
|
||
}
|
||
return err
|
||
}
|
||
|
||
// describe 只保留实例主机与知识库短 ID:诊断够用,不输出完整 UUID、路径或凭据。
|
||
func describe(target Target) string {
|
||
host := ""
|
||
if parsed, err := url.Parse(strings.TrimSpace(target.BaseURL)); err == nil && parsed.Host != "" {
|
||
host = parsed.Host
|
||
}
|
||
id := strings.TrimSpace(target.KnowledgeBaseID)
|
||
if len(id) > 8 {
|
||
id = id[:8]
|
||
}
|
||
switch {
|
||
case host == "" && id == "":
|
||
return ""
|
||
case host == "":
|
||
return "知识库 " + id
|
||
case id == "":
|
||
return "实例 " + host
|
||
default:
|
||
return "实例 " + host + " · 知识库 " + id
|
||
}
|
||
}
|