bb64c32654
build / build (push) Failing after 16s
- R4:封存子进程 SIGTERM 宽限停、libraryctl 信号转 ctx;失败/超时后 agent 再做 有界 recover,恢复失败即降级阻断封存并给出原因;启动先恢复、关闭等恢复完成 - R5:封存闸口以已存 payload 为准,同作业号换范围 409 且不入新队;重放回显真实状态 - R6:作业列表按类型查询(ListByType),不再先取全局再过滤 - R7:根目录 libraryagent 二进制移出版本库,保留运行产物并精确忽略 - UI:发布管理只保留对内/对外两目标,整合快照/完整性/作业/存储;链路未接线项禁用 并标原因;整库版本独立导航并入;文档级旧流程折叠保留
144 lines
5.7 KiB
Go
144 lines
5.7 KiB
Go
package httpapi
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"net/http"
|
|
"regexp"
|
|
"strings"
|
|
"time"
|
|
|
|
"knowledge-governance/internal/jobs"
|
|
)
|
|
|
|
// 页面发起封存:只投递一个作业,真正的停机/导出/恢复发生在主机侧 agent。
|
|
// 这里没有任何 Docker 访问,也没有来源凭据 —— 调用方只能选择范围与作业号。
|
|
const libraryCaptureJobType = "library.capture"
|
|
|
|
var libraryCaptureJobPattern = regexp.MustCompile(`^[A-Za-z0-9_-]{1,64}$`)
|
|
|
|
type libraryCaptureRequest struct {
|
|
Scope string `json:"scope"`
|
|
Job string `json:"job"`
|
|
}
|
|
|
|
func libraryCaptureEnqueue(w http.ResponseWriter, r *http.Request, config Config) {
|
|
if config.LibraryAgentSocket == "" {
|
|
writeJSON(w, http.StatusServiceUnavailable, map[string]any{
|
|
"code": "library_capture_unwired",
|
|
"reason": "未接线:主机侧封存 agent 没有挂载,页面无法发起封存",
|
|
})
|
|
return
|
|
}
|
|
var request libraryCaptureRequest
|
|
if err := json.NewDecoder(http.MaxBytesReader(w, r.Body, 4096)).Decode(&request); err != nil {
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "invalid request body"})
|
|
return
|
|
}
|
|
if request.Scope != "internal" && request.Scope != "external" {
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "scope must be internal or external"})
|
|
return
|
|
}
|
|
// The job id is the idempotency key handed to the agent: repeating the same
|
|
// scope+job returns the already sealed version instead of sealing twice.
|
|
captureJob := strings.TrimSpace(request.Job)
|
|
if captureJob == "" {
|
|
captureJob = "lib-" + request.Scope + "-" + time.Now().UTC().Format("20060102T150405")
|
|
}
|
|
if !libraryCaptureJobPattern.MatchString(captureJob) {
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "invalid job id"})
|
|
return
|
|
}
|
|
requestedBy := ""
|
|
if identity, ok := sessionFrom(r.Context()); ok {
|
|
requestedBy = identity.Username
|
|
}
|
|
payload, err := json.Marshal(map[string]string{
|
|
"scope": request.Scope, "capture_job": captureJob, "requested_by": requestedBy,
|
|
})
|
|
if err != nil {
|
|
writeJSON(w, http.StatusInternalServerError, map[string]string{"error": "cannot build capture job"})
|
|
return
|
|
}
|
|
now := time.Now().UTC()
|
|
requestedID := fmt.Sprintf("library-capture-%s-%d", request.Scope, now.UnixNano())
|
|
// The idempotency key is the capture job id: the same logical capture must map
|
|
// to one queue row. Binding the scope into the key would silently create a
|
|
// second job instead of reporting a conflicting request, so the conflict is
|
|
// detected by comparing the stored payload below.
|
|
job, err := config.Store.Enqueue(r.Context(), jobs.EnqueueRequest{
|
|
ID: requestedID,
|
|
Type: libraryCaptureJobType,
|
|
Payload: payload,
|
|
AvailableAt: now,
|
|
MaxAttempts: 2,
|
|
IdempotencyKey: "library.capture:" + captureJob,
|
|
}, now)
|
|
if err != nil || job == nil {
|
|
writeJSON(w, http.StatusInternalServerError, map[string]string{"error": "cannot enqueue capture job"})
|
|
return
|
|
}
|
|
// Enqueue returns the existing row for a reused key. Answer from that row, not
|
|
// from the current request: a reused job id with another scope must be refused
|
|
// instead of being reported as a job for the new scope.
|
|
var stored struct {
|
|
Scope string `json:"scope"`
|
|
CaptureJob string `json:"capture_job"`
|
|
RequestedBy string `json:"requested_by"`
|
|
}
|
|
if err = json.Unmarshal(job.Payload, &stored); err != nil || stored.CaptureJob != captureJob {
|
|
writeJSON(w, http.StatusConflict, map[string]any{
|
|
"code": "library_capture_conflict", "error": "该作业号已被另一个封存请求占用",
|
|
"existing_scope": stored.Scope, "requested_scope": request.Scope,
|
|
})
|
|
return
|
|
}
|
|
if stored.Scope != request.Scope {
|
|
writeJSON(w, http.StatusConflict, map[string]any{
|
|
"code": "library_capture_scope_conflict", "error": "同一作业号已按另一个范围投递",
|
|
"existing_scope": stored.Scope, "requested_scope": request.Scope,
|
|
})
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusAccepted, map[string]any{
|
|
"job_id": job.ID, "capture_job": stored.CaptureJob, "scope": stored.Scope,
|
|
"state": job.State, "reused": job.ID != requestedID, "requested_by": stored.RequestedBy,
|
|
})
|
|
}
|
|
|
|
// libraryCaptureJobs lists recent capture jobs so the page can show real state
|
|
// instead of an optimistic spinner. It reads the queue, not the archive.
|
|
func libraryCaptureJobs(w http.ResponseWriter, r *http.Request, config Config) {
|
|
// Ask the store for this type only. Reading the global queue and filtering in
|
|
// the handler would hide capture jobs behind unrelated traffic and make the
|
|
// page claim "idle" while a capture is still queued.
|
|
byType, ok := config.Store.(interface {
|
|
ListByType(ctx context.Context, jobType string, limit int) ([]jobs.Job, error)
|
|
})
|
|
if !ok {
|
|
writeJSON(w, http.StatusOK, map[string]any{"available": false,
|
|
"reason": "任务存储不支持按类型查询,页面不会据此判断空闲", "jobs": []any{}})
|
|
return
|
|
}
|
|
queue, err := byType.ListByType(r.Context(), libraryCaptureJobType, 20)
|
|
if err != nil {
|
|
writeJSON(w, http.StatusInternalServerError, map[string]string{"error": "cannot read capture jobs"})
|
|
return
|
|
}
|
|
views := make([]map[string]any, 0, len(queue))
|
|
for _, job := range queue {
|
|
var payload struct {
|
|
Scope string `json:"scope"`
|
|
CaptureJob string `json:"capture_job"`
|
|
RequestedBy string `json:"requested_by"`
|
|
}
|
|
_ = json.Unmarshal(job.Payload, &payload)
|
|
views = append(views, map[string]any{"job_id": job.ID, "capture_job": payload.CaptureJob,
|
|
"scope": payload.Scope, "state": job.State, "attempt": job.Attempt,
|
|
"last_error": job.LastError, "requested_by": payload.RequestedBy,
|
|
"created_at": job.CreatedAt, "updated_at": job.UpdatedAt})
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"available": true, "jobs": views})
|
|
}
|