Files
姚章浩 5eef13b615 feat(object-gateway): 统一对象写网关与不可变治理日志
方案A:所有对象写入经 loopback 网关,持久计划/grant/intent/逐版本 receipt 与
attempt→grant delivery 落在治理 PG;scope 由 provider+endpoint+bucket 决定,
同一物理桶只允许一个写域。版本 append 不等于 CAS,未锚定计划在首笔业务写前拒绝。

本提交只含网关与其适配层接线、协议文档;生产独占、凭据切换与桶设置未改动。
2026-11-01 11:35:05 +08:00

62 lines
2.1 KiB
Go

package main
import (
"context"
"encoding/json"
"errors"
"flag"
"fmt"
"io"
"os"
"time"
"knowledge-governance/internal/libraryrelease"
"knowledge-governance/internal/objectgateway"
v071 "knowledge-governance/internal/releaseadapter/v071"
)
// This command belongs to the separately authenticated controller. It must not
// be installed with control credentials in an ordinary data worker container.
func main() {
if e := run(); e != nil {
fmt.Fprintln(os.Stderr, e)
os.Exit(1)
}
}
func run() error {
path := flag.String("plan", "", "exact frozen write-set JSON")
directory := flag.String("grant-directory", "", "private durable grant output directory")
expected := flag.Int64("expected-epoch", -1, "previous epoch from the frozen controller intent; never guessed")
flag.Parse()
if *path == "" || *directory == "" || *expected < 0 || flag.NArg() != 0 {
return errors.New("exact plan, grant directory and expected epoch required")
}
f, e := os.Open(*path)
if e != nil {
return errors.New("frozen gateway plan unavailable")
}
defer f.Close()
var set libraryrelease.WriteSet
d := json.NewDecoder(io.LimitReader(f, 16<<20))
d.DisallowUnknownFields()
if d.Decode(&set) != nil || d.Decode(&struct{}{}) != io.EOF {
return errors.New("frozen gateway plan invalid")
}
provider, endpoint, bucket := os.Getenv("OBJECT_GATEWAY_PROVIDER"), os.Getenv("OBJECT_GATEWAY_ENDPOINT"), os.Getenv("OBJECT_GATEWAY_BUCKET")
if provider == "" || endpoint == "" || bucket == "" {
return errors.New("exact gateway target configuration required")
}
scope := objectgateway.Digest([]byte(provider + "\x00" + endpoint + "\x00" + bucket))
client, e := objectgateway.NewClient(os.Getenv("OBJECT_GATEWAY_URL"), os.Getenv("OBJECT_GATEWAY_CONTROL_TOKEN"), scope)
if e != nil {
return e
}
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
defer cancel()
if e = v071.PrepareObjectGatewayGrant(ctx, client, set, *expected, provider, bucket, *directory); e != nil {
return e
}
fmt.Printf("gateway grant persisted: plan=%s epoch=%d\n", set.Digest, *expected+1)
return nil
}