c72b71d78a
build / build (push) Failing after 17s
为什么:父审指出预备份引用持久化失败仍继续写目标、接管依赖启动扫描且漏掉租约未过期、 恢复失败被标成"无需恢复"、版本登记与作业状态分叉。 - BackupPrepared 返回 error,持久化失败即零写入;预备份同时登记 production_prebackup 版本。 - 接管改为按队列租约判定 + 运行期 30s 扫描 + 原子抢占 + 固定幂等键 + attempt 归零。 - 接管场景保留预备份、不再宣称"未写无需恢复"。 - 恢复/重放同一快照重新激活 production_effective(清 superseded_at)。 - finalize 续作只做校验+登记(finalize_only),不重写生产。 - 索引映射基线缺失时采用首次观察值并登记;索引校验加孤儿文档检查(按 knowledge_id)。 真实验收(候选 API :18089 + 真实 PG/ES/MinIO): A0 首次发布、A1 撤销、B 按版本恢复、C 写阶段 SIGKILL 接管、 D 跨 kind 互斥与多 worker 单次执行、E1 登记失败、E2 finalize 续作、E3 预备份失败零写入。
118 lines
5.1 KiB
Go
118 lines
5.1 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"strings"
|
|
|
|
"knowledge-governance/internal/appconfig"
|
|
"knowledge-governance/internal/librarysnapshot"
|
|
v071 "knowledge-governance/internal/releaseadapter/v071"
|
|
)
|
|
|
|
// buildLibraryProductionStack 用部署注入的配置装配生产整库目标与独立预备份存储。
|
|
// 任何一项缺失都返回明确原因,调用方据此把作业失败并把缺项写进阶段,
|
|
// 不用"未配置"的占位对象假装能跑。
|
|
func buildLibraryProductionStack(ctx context.Context, config appconfig.Config, scope, snapshotID, knownMapping string) (
|
|
*v071.ProductionLibraryTarget, *v071.ProductionBackupStore, error) {
|
|
missing := make([]string, 0, 4)
|
|
if config.LibraryProductionDatabaseURL == "" {
|
|
missing = append(missing, "LIBRARY_PRODUCTION_DATABASE_URL")
|
|
}
|
|
if config.LibraryProductionElasticURL == "" {
|
|
missing = append(missing, "LIBRARY_PRODUCTION_ELASTIC_URL")
|
|
}
|
|
if config.LibraryProductionTenantID == 0 {
|
|
missing = append(missing, "LIBRARY_PRODUCTION_TENANT_ID")
|
|
}
|
|
kb := config.LibraryProductionInternalKB
|
|
if scope == "external" {
|
|
kb = config.LibraryProductionExternalKB
|
|
}
|
|
if kb == "" {
|
|
missing = append(missing, "LIBRARY_PRODUCTION_KB_"+strings.ToUpper(scope))
|
|
}
|
|
if config.LibraryProductionS3Endpoint == "" || config.LibraryProductionS3Bucket == "" ||
|
|
config.LibraryProductionS3AccessKey == "" || config.LibraryProductionS3SecretKey == "" {
|
|
missing = append(missing, "LIBRARY_PRODUCTION_S3_ENDPOINT/BUCKET/ACCESS_KEY/SECRET_KEY")
|
|
}
|
|
if len(missing) > 0 {
|
|
return nil, nil, fmt.Errorf("生产整库目标未配置:缺少 %s", strings.Join(missing, "、"))
|
|
}
|
|
secure := strings.HasPrefix(config.LibraryProductionS3Endpoint, "https://")
|
|
objects, err := v071.NewS3ObjectStore(v071.S3ObjectStoreConfig{
|
|
Provider: config.LibraryProductionS3Provider, Endpoint: config.LibraryProductionS3Endpoint,
|
|
Region: config.LibraryProductionS3Region, Bucket: config.LibraryProductionS3Bucket,
|
|
AccessKeyID: config.LibraryProductionS3AccessKey, SecretAccessKey: config.LibraryProductionS3SecretKey,
|
|
Secure: secure, ForcePathStyle: true, MaxObjectBytes: 256 * 1024 * 1024,
|
|
})
|
|
if err != nil {
|
|
return nil, nil, errors.New("生产对象存储配置无效")
|
|
}
|
|
identity := v071.ProductionScope{TenantID: config.LibraryProductionTenantID, KnowledgeBaseID: kb}
|
|
target, err := v071.NewProductionLibraryTarget(ctx, v071.ProductionLibraryConfig{
|
|
Postgres: config.LibraryProductionDatabaseURL, SearchURL: config.LibraryProductionElasticURL,
|
|
SearchIndex: config.LibraryProductionIndex, Objects: objects, ObjectsReader: objects,
|
|
ArchiveRoot: config.LibraryArchiveRoot,
|
|
MaxDocuments: 200000,
|
|
}, identity)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
// 契约以"要同步的这份快照"为准:生产必须向它看齐,而不是反过来。
|
|
// 生产为空时索引可能根本不存在,这时不能拿生产映射当契约(会永远启动不了)。
|
|
archive, err := librarysnapshot.Open(config.LibraryArchiveRoot, 256*1024*1024)
|
|
if err != nil {
|
|
target.Close()
|
|
return nil, nil, fmt.Errorf("归档不可用,无法读取快照契约: %w", err)
|
|
}
|
|
manifest, err := archive.Load(snapshotID)
|
|
archive.Close()
|
|
if err != nil {
|
|
target.Close()
|
|
return nil, nil, fmt.Errorf("读取目标快照失败: %w", err)
|
|
}
|
|
contract := manifest.Compatibility
|
|
if contract.EmbeddingDimension == 0 {
|
|
contract.EmbeddingModel = config.LibraryEmbeddingModel
|
|
contract.EmbeddingDimension = config.LibraryEmbeddingDimension
|
|
}
|
|
// 生产索引存在时必须与快照契约一致;不存在或为空基线时跳过比对
|
|
// (空索引的映射没有可比性,非空之后仍然严格比对)。
|
|
if mapping, mapErr := target.Search().MappingSHA256(ctx); mapErr == nil {
|
|
// 映射基线:优先用"上一次生产生效版本登记的实际映射",
|
|
// 它才是这份生产索引的既有事实;快照契约只管"来自哪份数据"。
|
|
baseline := knownMapping
|
|
if baseline == "" {
|
|
// 没有历史基线时(首次接管这套生产索引),把当前实际映射当作基线并随
|
|
// 预备份登记;之后任何改动都会与登记值不符而被拒绝。
|
|
baseline = mapping
|
|
}
|
|
if baseline != "" && mapping != baseline {
|
|
current, currentErr := target.Current(ctx)
|
|
emptyBaseline := currentErr == nil && current.Counts["index"] == 0 && current.Counts["chunks"] == 0
|
|
if !emptyBaseline {
|
|
target.Close()
|
|
return nil, nil, errors.New("生产索引映射与上次生效版本不一致(索引被改动过),先对齐索引映射")
|
|
}
|
|
}
|
|
}
|
|
// 预备份描述的是"生产现在的索引",不是"快照的来源索引":
|
|
// 生产映射基线优先用上次生效版本登记的实际值。
|
|
backupContract := contract
|
|
if knownMapping != "" {
|
|
backupContract.IndexMappingSHA256 = knownMapping
|
|
}
|
|
backups, err := v071.NewProductionBackupStore(v071.ProductionBackupConfig{
|
|
Pool: target.Pool(), Search: target.Search(), Objects: target.Objects(),
|
|
ArchiveRoot: config.LibraryArchiveRoot, Scope: scope, Identity: target.Identity(),
|
|
Compatibility: backupContract, MaxDocuments: 200000, MaxObjectByte: 256 * 1024 * 1024,
|
|
})
|
|
if err != nil {
|
|
target.Close()
|
|
return nil, nil, err
|
|
}
|
|
return target, backups, nil
|
|
}
|