dcdc8d1ddd
全栈知识治理平台首次入库(P1-P10 + 发布链路模拟验证闭环): - 治理核心:源目录/变更集/人工审核/发布批次/发布执行(fail-closed 闸口) - 测试通道:WeKnora 测试 KB 上传/轮询/验收;poll 完成时写入 parser_generation/index_generation,修复 manual/seed 路径发布闸口永久拦截 - 发布适配器 v071(本地 source=测试角色 / 云端 target=生产角色 模拟验证通过): * ES 导出/导入 mapping 自适应(.keyword 子字段、可选 tenant_id) * OSS locator 支持嵌套 scheme;chunks.seq_id 由目标序列分配 * bundle 归档同身份重试原子替换;verifier 按 bundle chunk_type 计数 * 回滚 job payload 支持 prior_execution_id(strict 解码) - 三通道发布+回滚演练实测:publish 4/4 verified,检索命中, rollback 4/4 rolled_back,目标端 PG is_enabled=false、ES is_enabled=false - 前端 A·Data-console 风格全站统一,120 用例通过 - 门禁:go vet / go test 全包通过,gofmt 干净
163 lines
7.3 KiB
Go
163 lines
7.3 KiB
Go
package release
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"strings"
|
|
|
|
"knowledge-governance/internal/releasebundle"
|
|
)
|
|
|
|
type BundleExporter interface {
|
|
Export(ctx context.Context, item PlanItem) (ExportedBundle, error)
|
|
}
|
|
|
|
type ExportedBundle interface {
|
|
ReleaseManifest() releasebundle.Manifest
|
|
}
|
|
|
|
type PreparedChange struct {
|
|
PreviousRevision string
|
|
ProductionRevision string
|
|
}
|
|
|
|
type SidecarTarget interface {
|
|
Contract(ctx context.Context, item PlanItem) (releasebundle.TargetContract, error)
|
|
Prepare(ctx context.Context, item PlanItem, bundle ExportedBundle) (PreparedChange, error)
|
|
Activate(ctx context.Context, item PlanItem, change PreparedChange) error
|
|
Verify(ctx context.Context, item PlanItem, change PreparedChange) error
|
|
Compensate(ctx context.Context, item PlanItem, change PreparedChange) error
|
|
Restore(ctx context.Context, item PlanItem, revision string) (string, error)
|
|
VerifyRestored(ctx context.Context, item PlanItem, revision string) error
|
|
}
|
|
|
|
type SidecarPublisher struct {
|
|
exporter BundleExporter
|
|
target SidecarTarget
|
|
}
|
|
|
|
func NewSidecarPublisher(exporter BundleExporter, target SidecarTarget) (*SidecarPublisher, error) {
|
|
if exporter == nil || target == nil {
|
|
return nil, errors.New("release sidecar dependencies are required")
|
|
}
|
|
return &SidecarPublisher{exporter: exporter, target: target}, nil
|
|
}
|
|
|
|
func (publisher *SidecarPublisher) Publish(ctx context.Context, item PlanItem) (ItemResult, error) {
|
|
bundle, err := publisher.exporter.Export(ctx, item)
|
|
if err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeTargetUnavailable, true, err)
|
|
}
|
|
if bundle == nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeBundleInvalid, false, errors.New("empty release bundle"))
|
|
}
|
|
manifest := bundle.ReleaseManifest()
|
|
if manifest.ExecutionID != item.ReleaseExecutionID || manifest.PublicationID != item.PublicationID ||
|
|
manifest.SourceItemVersionID != item.SourceItemVersionID || manifest.SourceRevision != item.SourceRevision ||
|
|
manifest.ParseRevision != item.ParseRevision || manifest.ReleaseRevision != item.ReleaseRevision ||
|
|
manifest.Contract.KnowledgeBaseID != item.TestKnowledgeBaseID || manifest.Contract.KnowledgeID != item.KnowledgeID {
|
|
return ItemResult{}, newSidecarError(ErrorCodeContractMismatch, false, errors.New("bundle identity mismatch"))
|
|
}
|
|
targetContract, err := publisher.target.Contract(ctx, item)
|
|
if err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeTargetUnavailable, true, err)
|
|
}
|
|
if err := releasebundle.Validate(manifest, targetContract); err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeContractMismatch, false, err)
|
|
}
|
|
change, err := publisher.target.Prepare(ctx, item, bundle)
|
|
if err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeTargetWriteFailed, true, err)
|
|
}
|
|
if !validRevision(change.ProductionRevision) || (change.PreviousRevision != "" && !validRevision(change.PreviousRevision)) {
|
|
return ItemResult{}, publisher.compensateError(ctx, item, change, ErrorCodeBundleInvalid, errors.New("invalid prepared revision"))
|
|
}
|
|
if err := publisher.target.Activate(ctx, item, change); err != nil {
|
|
return ItemResult{}, publisher.compensateError(ctx, item, change, ErrorCodeTargetWriteFailed, err)
|
|
}
|
|
if err := publisher.target.Verify(ctx, item, change); err != nil {
|
|
return ItemResult{}, publisher.compensateError(ctx, item, change, ErrorCodeVerificationFailed, err)
|
|
}
|
|
return ItemResult{
|
|
BundleSHA256: manifest.BundleSHA256,
|
|
PreviousProductionRevision: change.PreviousRevision,
|
|
ProductionRevision: change.ProductionRevision,
|
|
}, nil
|
|
}
|
|
|
|
func (publisher *SidecarPublisher) Rollback(ctx context.Context, item PlanItem) (ItemResult, error) {
|
|
if !validRevision(item.PreviousProductionRevision) {
|
|
return ItemResult{}, newSidecarError(ErrorCodeRollbackArtifactMissing, false, errors.New("missing rollback revision"))
|
|
}
|
|
restoredRevision, err := publisher.target.Restore(ctx, item, item.PreviousProductionRevision)
|
|
if err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeTargetWriteFailed, true, err)
|
|
}
|
|
if restoredRevision != item.PreviousProductionRevision {
|
|
return ItemResult{}, newSidecarError(ErrorCodeContractMismatch, false, errors.New("restored revision mismatch"))
|
|
}
|
|
if err := publisher.target.VerifyRestored(ctx, item, restoredRevision); err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeVerificationFailed, false, err)
|
|
}
|
|
return ItemResult{ProductionRevision: restoredRevision}, nil
|
|
}
|
|
|
|
func (publisher *SidecarPublisher) Delete(ctx context.Context, item PlanItem) (ItemResult, error) {
|
|
bundle, err := publisher.exporter.Export(ctx, item)
|
|
if err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeTargetUnavailable, true, err)
|
|
}
|
|
if bundle == nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeBundleInvalid, false, errors.New("empty release bundle"))
|
|
}
|
|
manifest := bundle.ReleaseManifest()
|
|
if manifest.ExecutionID != item.ReleaseExecutionID || manifest.PublicationID != item.PublicationID ||
|
|
manifest.SourceItemVersionID != item.SourceItemVersionID || manifest.SourceRevision != item.SourceRevision ||
|
|
manifest.ParseRevision != item.ParseRevision || manifest.ReleaseRevision != item.ReleaseRevision ||
|
|
manifest.Contract.KnowledgeBaseID != item.TestKnowledgeBaseID || manifest.Contract.KnowledgeID != item.KnowledgeID {
|
|
return ItemResult{}, newSidecarError(ErrorCodeContractMismatch, false, errors.New("bundle identity mismatch"))
|
|
}
|
|
targetContract, err := publisher.target.Contract(ctx, item)
|
|
if err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeTargetUnavailable, true, err)
|
|
}
|
|
if err := releasebundle.Validate(manifest, targetContract); err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeContractMismatch, false, err)
|
|
}
|
|
change, err := publisher.target.Prepare(ctx, item, bundle)
|
|
if err != nil {
|
|
return ItemResult{}, newSidecarError(ErrorCodeTargetWriteFailed, true, err)
|
|
}
|
|
if !validRevision(change.PreviousRevision) || change.ProductionRevision != item.ReleaseRevision {
|
|
return ItemResult{}, publisher.compensateError(ctx, item, change, ErrorCodeBundleInvalid, errors.New("invalid delete snapshot revision"))
|
|
}
|
|
restoredRevision, err := publisher.target.Restore(ctx, item, "absent")
|
|
if err != nil {
|
|
return ItemResult{}, publisher.compensateError(ctx, item, change, ErrorCodeTargetWriteFailed, err)
|
|
}
|
|
if restoredRevision != "absent" {
|
|
return ItemResult{}, publisher.compensateError(ctx, item, change, ErrorCodeContractMismatch, errors.New("deleted revision mismatch"))
|
|
}
|
|
if err := publisher.target.VerifyRestored(ctx, item, "absent"); err != nil {
|
|
return ItemResult{}, publisher.compensateError(ctx, item, change, ErrorCodeVerificationFailed, err)
|
|
}
|
|
return ItemResult{BundleSHA256: manifest.BundleSHA256, PreviousProductionRevision: change.PreviousRevision, ProductionRevision: "absent"}, nil
|
|
}
|
|
|
|
func (publisher *SidecarPublisher) compensateError(ctx context.Context, item PlanItem, change PreparedChange, code string, cause error) error {
|
|
if err := publisher.target.Compensate(ctx, item, change); err != nil {
|
|
return newSidecarError(ErrorCodeRollbackFailed, false, err)
|
|
}
|
|
return newSidecarError(code, false, cause)
|
|
}
|
|
|
|
func newSidecarError(code string, retryable bool, cause error) error {
|
|
return &ItemError{Code: code, Retryable: retryable, Cause: cause}
|
|
}
|
|
|
|
func validRevision(value string) bool {
|
|
return value == strings.TrimSpace(value) && value != "" && len(value) <= 128 && !strings.ContainsAny(value, "\x00\r\n\t/?#\\")
|
|
}
|
|
|
|
var _ Publisher = (*SidecarPublisher)(nil)
|