Files
pages/internal/server/dr_readonly.go
T
Anya Tokugawa d5d21b7841
Build and publish container images / images (push) Successful in 9m34s
Release container images / release (push) Successful in 36s
Refactor architecture into eight components and consolidate reliability work
Extract Grammaratur, Dregarnuhr, Geduldh, Mestionora, Ordoschnellic, Schutzaria, Kunstzeal and Seheweit behind compatible application contracts.

Include accumulated editor resilience, navigation and theme UX, remote CLI, storage/schema and DR groundwork, tests and design/operations documentation.

Verified: uncached full Go suite; go vet ./...; race tests for all eight components; 11 targeted Chromium tests; Node suites; 19 Python CLI tests; reproducible editor build. No push, release tag or deployment in this checkpoint.
2026-11-01 15:23:31 +09:00

99 lines
3.7 KiB
Go

package server
import (
"net/http"
"strings"
"time"
)
// This gate is outside authorization; it never grants access. DB mode=ro and
// query_only enforce a second boundary even if a GET handler attempts a write.
// The data directory should additionally be mounted read-only on standby.
func (s *Server) withStandbyReadOnly(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path == "/health/read" || r.URL.Path == "/health/write" {
w.Header().Set("Cache-Control", "no-store")
if r.Method != "GET" && r.Method != "HEAD" {
w.WriteHeader(http.StatusMethodNotAllowed)
return
}
ready := !s.store.ReadOnly || (r.URL.Path == "/health/read" && time.Now().Before(s.store.StandbyReadUntil))
if ready && s.store.DB != nil {
ready = s.store.DB.PingContext(r.Context()) == nil
}
if !ready {
http.Error(w, "not ready", http.StatusServiceUnavailable)
return
}
w.WriteHeader(http.StatusOK)
return
}
if !s.store.ReadOnly {
next.ServeHTTP(w, r)
return
}
w = &standbyResponseWriter{ResponseWriter: w}
w.Header().Set("X-PagesWiki-DR-Role", "standby")
w.Header().Set("Cache-Control", "private, no-store")
fail := func(message string) {
w.Header().Set("Retry-After", "60")
http.Error(w, message, http.StatusServiceUnavailable)
}
// Health remains a liveness endpoint, NOT proof that this node can write.
if r.URL.Path == "/health" && (r.Method == "GET" || r.Method == "HEAD") {
next.ServeHTTP(w, r)
return
}
if s.store.StandbyReadUntil.IsZero() || !time.Now().Before(s.store.StandbyReadUntil) {
fail("DR snapshot expired; routing or offline refresh is required")
return
}
if r.Method != "GET" && r.Method != "HEAD" && r.Method != "OPTIONS" && r.Method != "PROPFIND" && r.Method != "REPORT" {
fail("DR standby is read-only; write request was not executed")
return
}
// Authentication issuance, edit launch, federation and external renderers
// can have side effects even on GET. Do not invoke them on a standby.
for _, prefix := range []string{"/_/auth/", "/-/sys/", "/e/", "/o/e/", "/n/", "/:/", "/new", "/v/upload", "/_/adapter-gateway", "/_/adaptor/", "/_/api/v1/federation", "/_/api/v1/adapter", "/v/open", "/v/import", "/v/compile", "/_/api/v1/import"} {
if strings.HasPrefix(r.URL.Path, prefix) {
fail("operation unavailable on DR standby")
return
}
}
// V1 standby does not serve organizer or DAV endpoints: their current
// read paths repair file-backed indexes and update credential metadata.
// They become available after promotion; no false successful sync responses.
for _, prefix := range []string{"/v/plan", "/v/calendar", "/v/event", "/v/tasks", "/_/api/v1/calendar", "/_/api/v1/caldav", "/_/api/v1/task", "/_/api/v1/extension/", "/.well-known/caldav"} {
if strings.HasPrefix(r.URL.Path, prefix) {
fail("organizer/DAV read service requires DR promotion in this version")
return
}
}
next.ServeHTTP(w, r)
})
}
// Immutable/raw handlers normally set long cache lifetimes. A standby must not
// let those headers outlive the snapshot's authorization freshness deadline.
type standbyResponseWriter struct {
http.ResponseWriter
wrote bool
}
func (w *standbyResponseWriter) WriteHeader(status int) {
if w.wrote {
return
}
w.wrote = true
w.Header().Set("Cache-Control", "private, no-store")
w.Header().Set("X-PagesWiki-DR-Role", "standby")
w.ResponseWriter.WriteHeader(status)
}
func (w *standbyResponseWriter) Write(b []byte) (int, error) {
if !w.wrote {
w.WriteHeader(http.StatusOK)
}
return w.ResponseWriter.Write(b)
}
func (w *standbyResponseWriter) Unwrap() http.ResponseWriter { return w.ResponseWriter }