BlueGit

timfa bluegit

Merge branch 'stage'

timfa Grok Bot · pushed by timfa

Authored 2026-11-16 · 1 day ago

Hash
aaedebd0654ac708bbf1a23f305b6a21d5892625
Pipeline
Passed
13 files changed +522 −9
README.md +1 −1
@@ -23,7 +23,7 @@ Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).
23 23 - Periodiek onderhoud van de bare repositories (`git gc --auto`, plus `git maintenance` voor loose objects en incremental-repack als de git-binary dat kent). Standaard elke 24 uur (`git.maintenance_interval`; `off` of `0` zet het uit). Eén repo tegelijk, met lage prioriteit (`nice -n 19`) en gits eigen locking, nooit `--prune=now`. Een fout op één repo slaat die over. Installatiebeheerders zien de status en kunnen een ronde starten via `GET`/`POST /api/v1/admin/git-maintenance`.
24 24 - REST-API. Het schema staat op `/api/v1/openapi.json`.
25 25 - Self-update: de instantie installeert een nieuw AUR-pakket met pacman.
26 - Een of meer losse backup servers ([bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Zie [docs/BACKUP.md](docs/BACKUP.md).
26 - Een of meer losse backup servers ([bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Past een backup server niet bij deze BlueGit (een van de twee is verouderd), dan zien beheerders bovenaan elke pagina een waarschuwing. Zie [docs/BACKUP.md](docs/BACKUP.md).
27 27 - Linkpreviews: een gedeelde pagina krijgt een kaart via Open Graph, oEmbed en `/-/card.png`.
28 28
29 29 Een repository hoort bij een gebruiker of bij een groep. De hoogste rol telt.
@@ -23,7 +23,7 @@ Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).
23- Periodiek onderhoud van de bare repositories (`git gc --auto`, plus `git maintenance` voor loose objects en incremental-repack als de git-binary dat kent). Standaard elke 24 uur (`git.maintenance_interval`; `off` of `0` zet het uit). Eén repo tegelijk, met lage prioriteit (`nice -n 19`) en gits eigen locking, nooit `--prune=now`. Een fout op één repo slaat die over. Installatiebeheerders zien de status en kunnen een ronde starten via `GET`/`POST /api/v1/admin/git-maintenance`.
23- Periodiek onderhoud van de bare repositories (`git gc --auto`, plus `git maintenance` voor loose objects en incremental-repack als de git-binary dat kent). Standaard elke 24 uur (`git.maintenance_interval`; `off` of `0` zet het uit). Eén repo tegelijk, met lage prioriteit (`nice -n 19`) en gits eigen locking, nooit `--prune=now`. Een fout op één repo slaat die over. Installatiebeheerders zien de status en kunnen een ronde starten via `GET`/`POST /api/v1/admin/git-maintenance`.
24- REST-API. Het schema staat op `/api/v1/openapi.json`.
24- REST-API. Het schema staat op `/api/v1/openapi.json`.
25- Self-update: de instantie installeert een nieuw AUR-pakket met pacman.
25- Self-update: de instantie installeert een nieuw AUR-pakket met pacman.
26- Een of meer losse backup servers ([bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Zie [docs/BACKUP.md](docs/BACKUP.md).
26- Een of meer losse backup servers ([bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Past een backup server niet bij deze BlueGit (een van de twee is verouderd), dan zien beheerders bovenaan elke pagina een waarschuwing. Zie [docs/BACKUP.md](docs/BACKUP.md).
27- Linkpreviews: een gedeelde pagina krijgt een kaart via Open Graph, oEmbed en `/-/card.png`.
27- Linkpreviews: een gedeelde pagina krijgt een kaart via Open Graph, oEmbed en `/-/card.png`.
28
28
29Een repository hoort bij een gebruiker of bij een groep. De hoogste rol telt.
29Een repository hoort bij een gebruiker of bij een groep. De hoogste rol telt.
docs/BACKUP.md +18 −0
@@ -63,6 +63,24 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha256
63 63
64 64 **Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
65 65
66 ### Compatibiliteit (protocolversie)
67
68 Elke kant heeft een **protocolversie** (wat hij spreekt) en een **minimumversie** (de oudste versie van de andere kant die hij nog ondersteunt). Nu is dat aan beide kanten protocol 1, minimum 1.
69
70 - BlueGit stuurt `X-BlueGit-Protocol`, `X-BlueGit-Min-Protocol` en `X-BlueGit-Version` mee op elk verzoek aan de backup server (meldingen, status, beheeracties, rollback) en op elk antwoord van de backup-API; `GET /api/v1/backup/info` geeft ook `protocol`, `min_protocol`, `version` en `compat`.
71 - De backup server stuurt `X-Backup-Protocol`, `X-Backup-Min-Protocol` en `X-Backup-Version` mee op elk verzoek aan BlueGit en op elk antwoord.
72 - Ontbreken de koppen, dan is het protocol 1 (BlueGit vóór deze versie en bluegit-backup v0.1.0).
73 - Ze passen als de backup server minstens het minimum van BlueGit spreekt en BlueGit minstens het minimum van de backup server. Anders is het `backup_too_old` (update de backup server) of `bluegit_too_old` (update BlueGit).
74
75 Wat er gebeurt als ze niet passen:
76
77 - BlueGit onthoudt per backup server het laatst gemelde protocol in `backup.json` en toont **beheerders bovenaan elke pagina een banner** met de naam van de backup server, wie er geüpdatet moet worden en een link naar Beheer → Backup. Andere gebruikers zien niets. De lijst en de pagina van de server tonen het ook, en de API (`GET /api/v1/admin/backup`) geeft per server `compat` en `protocol`.
78 - BlueGit weigert `manifest`, `file` en `restore` met `426 Upgrade Required` (`{"error", "compat", "protocol", "min_protocol"}`); `info` en `connect` blijven werken, zodat beide kanten het kunnen melden.
79 - De backup server vraagt vóór elke sync, rollback of restore `info` op en weigert zelf als het niet past; zijn webinterface toont een banner en `GET /api/v1/admin/status` geeft `compat` en `compat_message`.
80 - Na een update van de verouderde kant herstelt alles vanzelf bij het volgende contact.
81
82 Een test-build met een ander protocol: `go build -ldflags "-X gitlab.com/Timfa/bluegit/internal/backup.protocolVersion=99 -X gitlab.com/Timfa/bluegit/internal/backup.minBackupProtocol=99" ./cmd/bluegit` (de integratietests van bluegit-backup doen dat).
83
66 84 ## Wat er in een backup zit
67 85
68 86 ```text
@@ -63,6 +63,24 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha256
63
63
64**Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
64**Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
65
65
66### Compatibiliteit (protocolversie)
67
68Elke kant heeft een **protocolversie** (wat hij spreekt) en een **minimumversie** (de oudste versie van de andere kant die hij nog ondersteunt). Nu is dat aan beide kanten protocol 1, minimum 1.
69
70- BlueGit stuurt `X-BlueGit-Protocol`, `X-BlueGit-Min-Protocol` en `X-BlueGit-Version` mee op elk verzoek aan de backup server (meldingen, status, beheeracties, rollback) en op elk antwoord van de backup-API; `GET /api/v1/backup/info` geeft ook `protocol`, `min_protocol`, `version` en `compat`.
71- De backup server stuurt `X-Backup-Protocol`, `X-Backup-Min-Protocol` en `X-Backup-Version` mee op elk verzoek aan BlueGit en op elk antwoord.
72- Ontbreken de koppen, dan is het protocol 1 (BlueGit vóór deze versie en bluegit-backup v0.1.0).
73- Ze passen als de backup server minstens het minimum van BlueGit spreekt en BlueGit minstens het minimum van de backup server. Anders is het `backup_too_old` (update de backup server) of `bluegit_too_old` (update BlueGit).
74
75Wat er gebeurt als ze niet passen:
76
77- BlueGit onthoudt per backup server het laatst gemelde protocol in `backup.json` en toont **beheerders bovenaan elke pagina een banner** met de naam van de backup server, wie er geüpdatet moet worden en een link naar Beheer → Backup. Andere gebruikers zien niets. De lijst en de pagina van de server tonen het ook, en de API (`GET /api/v1/admin/backup`) geeft per server `compat` en `protocol`.
78- BlueGit weigert `manifest`, `file` en `restore` met `426 Upgrade Required` (`{"error", "compat", "protocol", "min_protocol"}`); `info` en `connect` blijven werken, zodat beide kanten het kunnen melden.
79- De backup server vraagt vóór elke sync, rollback of restore `info` op en weigert zelf als het niet past; zijn webinterface toont een banner en `GET /api/v1/admin/status` geeft `compat` en `compat_message`.
80- Na een update van de verouderde kant herstelt alles vanzelf bij het volgende contact.
81
82Een test-build met een ander protocol: `go build -ldflags "-X gitlab.com/Timfa/bluegit/internal/backup.protocolVersion=99 -X gitlab.com/Timfa/bluegit/internal/backup.minBackupProtocol=99" ./cmd/bluegit` (de integratietests van bluegit-backup doen dat).
83
66## Wat er in een backup zit
84## Wat er in een backup zit
67
85
68```text
86```text
internal/backup/client.go +6 −0
@@ -90,6 +90,7 @@ func (c *Client) Call(ctx context.Context, conn Conn, method, p string, in any)
90 90 now = c.Now
91 91 }
92 92 Sign(req, conn.SignSecret, inst, body, now())
93 SetOwnHeaders(req.Header)
93 94 hc := c.HTTP
94 95 if hc == nil {
95 96 hc = &http.Client{Timeout: 15 * time.Second}
@@ -99,6 +100,11 @@ func (c *Client) Call(ctx context.Context, conn Conn, method, p string, in any)
99 100 return 0, nil, err
100 101 }
101 102 defer resp.Body.Close()
103 // Alleen een antwoord met protocolkop zegt iets over de backup server
104 // (een proxy-fout heeft er geen).
105 if p, ok := PeerFromHeader(resp.Header); ok {
106 c.Manager.SetPeer(conn.ID, p)
107 }
102 108 raw, _ := io.ReadAll(io.LimitReader(resp.Body, 4<<20))
103 109 return resp.StatusCode, raw, nil
104 110 }
@@ -90,6 +90,7 @@ func (c *Client) Call(ctx context.Context, conn Conn, method, p string, in any)
90 now = c.Now
90 now = c.Now
91 }
91 }
92 Sign(req, conn.SignSecret, inst, body, now())
92 Sign(req, conn.SignSecret, inst, body, now())
93 SetOwnHeaders(req.Header)
93 hc := c.HTTP
94 hc := c.HTTP
94 if hc == nil {
95 if hc == nil {
95 hc = &http.Client{Timeout: 15 * time.Second}
96 hc = &http.Client{Timeout: 15 * time.Second}
@@ -99,6 +100,11 @@ func (c *Client) Call(ctx context.Context, conn Conn, method, p string, in any)
99 return 0, nil, err
100 return 0, nil, err
100 }
101 }
101 defer resp.Body.Close()
102 defer resp.Body.Close()
103 // Alleen een antwoord met protocolkop zegt iets over de backup server
104 // (een proxy-fout heeft er geen).
105 if p, ok := PeerFromHeader(resp.Header); ok {
106 c.Manager.SetPeer(conn.ID, p)
107 }
102 raw, _ := io.ReadAll(io.LimitReader(resp.Body, 4<<20))
108 raw, _ := io.ReadAll(io.LimitReader(resp.Body, 4<<20))
103 return resp.StatusCode, raw, nil
109 return resp.StatusCode, raw, nil
104}
110}
internal/backup/compat.go added +172 −0
@@ -0,0 +1,172 @@
1 package backup
2
3 import (
4 "net/http"
5 "runtime/debug"
6 "strconv"
7 "strings"
8 )
9
10 // Compatibiliteit tussen BlueGit en bluegit-backup.
11 //
12 // Elke kant heeft een protocolversie (wat hij zelf spreekt) en een
13 // minimumversie (de oudste versie van de andere kant die hij nog
14 // ondersteunt). Ze zijn compatibel als elk de minimumversie van de ander
15 // haalt. Een kant die de koppen niet stuurt, spreekt protocol 1 (zo was het
16 // tot en met bluegit-backup v0.1.0).
17 //
18 // De waarden zijn strings, zodat een test-build ze met
19 // -ldflags "-X gitlab.com/Timfa/bluegit/internal/backup.protocolVersion=…"
20 // kan overschrijven.
21 var (
22 protocolVersion = "1"
23 minBackupProtocol = "1"
24 )
25
26 // Koppen met de protocolversie. BlueGit zet de X-BlueGit-koppen op zijn
27 // verzoeken aan en antwoorden van de backup-API; de backup server zet de
28 // X-Backup-koppen op zijn verzoeken en antwoorden.
29 const (
30 HeaderBlueGitProtocol = "X-BlueGit-Protocol"
31 HeaderBlueGitMinProtocol = "X-BlueGit-Min-Protocol"
32 HeaderBlueGitVersion = "X-BlueGit-Version"
33 HeaderBackupProtocol = "X-Backup-Protocol"
34 HeaderBackupMinProtocol = "X-Backup-Min-Protocol"
35 HeaderBackupVersion = "X-Backup-Version"
36 )
37
38 // Uitkomsten van Compat.
39 const (
40 CompatOK = "ok"
41 CompatBlueGitTooOld = "bluegit_too_old"
42 CompatBackupTooOld = "backup_too_old"
43 )
44
45 func atoiMin1(s string) int {
46 n, err := strconv.Atoi(strings.TrimSpace(s))
47 if err != nil || n < 1 {
48 return 1
49 }
50 return n
51 }
52
53 // Protocol is de protocolversie van deze BlueGit.
54 func Protocol() int { return atoiMin1(protocolVersion) }
55
56 // MinProtocol is de oudste protocolversie van een backup server die deze
57 // BlueGit ondersteunt.
58 func MinProtocol() int {
59 if m := atoiMin1(minBackupProtocol); m <= Protocol() {
60 return m
61 }
62 return Protocol()
63 }
64
65 // Version is de commit waarvan deze BlueGit gebouwd is (of "dev").
66 func Version() string {
67 if bi, ok := debug.ReadBuildInfo(); ok {
68 for _, s := range bi.Settings {
69 if s.Key == "vcs.revision" && len(s.Value) >= 12 {
70 return s.Value[:12]
71 }
72 }
73 }
74 return "dev"
75 }
76
77 // Compat vergelijkt BlueGit (protocol, minimum voor de backup server) met
78 // een backup server (protocol, minimum voor BlueGit).
79 func Compat(bluegit, bluegitMin, backup, backupMin int) string {
80 switch {
81 case backup < bluegitMin:
82 return CompatBackupTooOld
83 case bluegit < backupMin:
84 return CompatBlueGitTooOld
85 }
86 return CompatOK
87 }
88
89 // Peer is wat een backup server over zijn protocol zegt.
90 type Peer struct {
91 Protocol int
92 MinProtocol int
93 Version string
94 }
95
96 // PeerFromHeader leest de X-Backup-koppen. Zonder koppen is het protocol 1.
97 // ok is false als er geen protocolkop is.
98 func PeerFromHeader(h http.Header) (Peer, bool) {
99 p := Peer{Protocol: 1, MinProtocol: 1}
100 raw := h.Get(HeaderBackupProtocol)
101 if raw == "" {
102 return p, false
103 }
104 p.Protocol = atoiMin1(raw)
105 if m := h.Get(HeaderBackupMinProtocol); m != "" {
106 p.MinProtocol = atoiMin1(m)
107 }
108 p.Version = CleanVersion(h.Get(HeaderBackupVersion))
109 return p, true
110 }
111
112 // CleanVersion houdt een versie kort en toonbaar.
113 func CleanVersion(v string) string {
114 v = strings.TrimSpace(v)
115 out := make([]rune, 0, len(v))
116 for _, r := range v {
117 if r > ' ' && r < 0x7f && r != '<' && r != '>' && r != '"' {
118 out = append(out, r)
119 }
120 if len(out) == 40 {
121 break
122 }
123 }
124 return string(out)
125 }
126
127 // SetOwnHeaders zet de X-BlueGit-koppen.
128 func SetOwnHeaders(h http.Header) {
129 h.Set(HeaderBlueGitProtocol, strconv.Itoa(Protocol()))
130 h.Set(HeaderBlueGitMinProtocol, strconv.Itoa(MinProtocol()))
131 h.Set(HeaderBlueGitVersion, Version())
132 }
133
134 // Compat zegt of deze backup server bij deze BlueGit past. Leeg als de
135 // backup server zich nog niet gemeld heeft.
136 func (c Conn) Compat() string {
137 if !c.Connected() || c.PeerProtocol == 0 {
138 return ""
139 }
140 min := c.PeerMinProtocol
141 if min == 0 {
142 min = 1
143 }
144 return Compat(Protocol(), MinProtocol(), c.PeerProtocol, min)
145 }
146
147 // Incompatible zegt of er iets geüpdatet moet worden.
148 func (c Conn) Incompatible() bool {
149 r := c.Compat()
150 return r == CompatBlueGitTooOld || r == CompatBackupTooOld
151 }
152
153 // SetPeer legt het protocol van de backup server vast. Alleen bij een
154 // verandering wordt backup.json herschreven.
155 func (m *Manager) SetPeer(id string, p Peer) {
156 c, ok := m.Get(id)
157 if !ok || (c.PeerProtocol == p.Protocol && c.PeerMinProtocol == p.MinProtocol && c.PeerVersion == p.Version) {
158 return
159 }
160 _, _ = m.update(id, func(c *Conn) error {
161 c.PeerProtocol, c.PeerMinProtocol, c.PeerVersion = p.Protocol, p.MinProtocol, p.Version
162 return nil
163 })
164 }
165
166 // OverrideProtocol zet protocol en minimum tijdelijk anders (alleen voor
167 // tests). De teruggegeven functie zet ze terug.
168 func OverrideProtocol(protocol, min string) (restore func()) {
169 oldP, oldM := protocolVersion, minBackupProtocol
170 protocolVersion, minBackupProtocol = protocol, min
171 return func() { protocolVersion, minBackupProtocol = oldP, oldM }
172 }
@@ -0,0 +1,172 @@
1package backup
2
3import (
4 "net/http"
5 "runtime/debug"
6 "strconv"
7 "strings"
8)
9
10// Compatibiliteit tussen BlueGit en bluegit-backup.
11//
12// Elke kant heeft een protocolversie (wat hij zelf spreekt) en een
13// minimumversie (de oudste versie van de andere kant die hij nog
14// ondersteunt). Ze zijn compatibel als elk de minimumversie van de ander
15// haalt. Een kant die de koppen niet stuurt, spreekt protocol 1 (zo was het
16// tot en met bluegit-backup v0.1.0).
17//
18// De waarden zijn strings, zodat een test-build ze met
19// -ldflags "-X gitlab.com/Timfa/bluegit/internal/backup.protocolVersion=…"
20// kan overschrijven.
21var (
22 protocolVersion = "1"
23 minBackupProtocol = "1"
24)
25
26// Koppen met de protocolversie. BlueGit zet de X-BlueGit-koppen op zijn
27// verzoeken aan en antwoorden van de backup-API; de backup server zet de
28// X-Backup-koppen op zijn verzoeken en antwoorden.
29const (
30 HeaderBlueGitProtocol = "X-BlueGit-Protocol"
31 HeaderBlueGitMinProtocol = "X-BlueGit-Min-Protocol"
32 HeaderBlueGitVersion = "X-BlueGit-Version"
33 HeaderBackupProtocol = "X-Backup-Protocol"
34 HeaderBackupMinProtocol = "X-Backup-Min-Protocol"
35 HeaderBackupVersion = "X-Backup-Version"
36)
37
38// Uitkomsten van Compat.
39const (
40 CompatOK = "ok"
41 CompatBlueGitTooOld = "bluegit_too_old"
42 CompatBackupTooOld = "backup_too_old"
43)
44
45func atoiMin1(s string) int {
46 n, err := strconv.Atoi(strings.TrimSpace(s))
47 if err != nil || n < 1 {
48 return 1
49 }
50 return n
51}
52
53// Protocol is de protocolversie van deze BlueGit.
54func Protocol() int { return atoiMin1(protocolVersion) }
55
56// MinProtocol is de oudste protocolversie van een backup server die deze
57// BlueGit ondersteunt.
58func MinProtocol() int {
59 if m := atoiMin1(minBackupProtocol); m <= Protocol() {
60 return m
61 }
62 return Protocol()
63}
64
65// Version is de commit waarvan deze BlueGit gebouwd is (of "dev").
66func Version() string {
67 if bi, ok := debug.ReadBuildInfo(); ok {
68 for _, s := range bi.Settings {
69 if s.Key == "vcs.revision" && len(s.Value) >= 12 {
70 return s.Value[:12]
71 }
72 }
73 }
74 return "dev"
75}
76
77// Compat vergelijkt BlueGit (protocol, minimum voor de backup server) met
78// een backup server (protocol, minimum voor BlueGit).
79func Compat(bluegit, bluegitMin, backup, backupMin int) string {
80 switch {
81 case backup < bluegitMin:
82 return CompatBackupTooOld
83 case bluegit < backupMin:
84 return CompatBlueGitTooOld
85 }
86 return CompatOK
87}
88
89// Peer is wat een backup server over zijn protocol zegt.
90type Peer struct {
91 Protocol int
92 MinProtocol int
93 Version string
94}
95
96// PeerFromHeader leest de X-Backup-koppen. Zonder koppen is het protocol 1.
97// ok is false als er geen protocolkop is.
98func PeerFromHeader(h http.Header) (Peer, bool) {
99 p := Peer{Protocol: 1, MinProtocol: 1}
100 raw := h.Get(HeaderBackupProtocol)
101 if raw == "" {
102 return p, false
103 }
104 p.Protocol = atoiMin1(raw)
105 if m := h.Get(HeaderBackupMinProtocol); m != "" {
106 p.MinProtocol = atoiMin1(m)
107 }
108 p.Version = CleanVersion(h.Get(HeaderBackupVersion))
109 return p, true
110}
111
112// CleanVersion houdt een versie kort en toonbaar.
113func CleanVersion(v string) string {
114 v = strings.TrimSpace(v)
115 out := make([]rune, 0, len(v))
116 for _, r := range v {
117 if r > ' ' && r < 0x7f && r != '<' && r != '>' && r != '"' {
118 out = append(out, r)
119 }
120 if len(out) == 40 {
121 break
122 }
123 }
124 return string(out)
125}
126
127// SetOwnHeaders zet de X-BlueGit-koppen.
128func SetOwnHeaders(h http.Header) {
129 h.Set(HeaderBlueGitProtocol, strconv.Itoa(Protocol()))
130 h.Set(HeaderBlueGitMinProtocol, strconv.Itoa(MinProtocol()))
131 h.Set(HeaderBlueGitVersion, Version())
132}
133
134// Compat zegt of deze backup server bij deze BlueGit past. Leeg als de
135// backup server zich nog niet gemeld heeft.
136func (c Conn) Compat() string {
137 if !c.Connected() || c.PeerProtocol == 0 {
138 return ""
139 }
140 min := c.PeerMinProtocol
141 if min == 0 {
142 min = 1
143 }
144 return Compat(Protocol(), MinProtocol(), c.PeerProtocol, min)
145}
146
147// Incompatible zegt of er iets geüpdatet moet worden.
148func (c Conn) Incompatible() bool {
149 r := c.Compat()
150 return r == CompatBlueGitTooOld || r == CompatBackupTooOld
151}
152
153// SetPeer legt het protocol van de backup server vast. Alleen bij een
154// verandering wordt backup.json herschreven.
155func (m *Manager) SetPeer(id string, p Peer) {
156 c, ok := m.Get(id)
157 if !ok || (c.PeerProtocol == p.Protocol && c.PeerMinProtocol == p.MinProtocol && c.PeerVersion == p.Version) {
158 return
159 }
160 _, _ = m.update(id, func(c *Conn) error {
161 c.PeerProtocol, c.PeerMinProtocol, c.PeerVersion = p.Protocol, p.MinProtocol, p.Version
162 return nil
163 })
164}
165
166// OverrideProtocol zet protocol en minimum tijdelijk anders (alleen voor
167// tests). De teruggegeven functie zet ze terug.
168func OverrideProtocol(protocol, min string) (restore func()) {
169 oldP, oldM := protocolVersion, minBackupProtocol
170 protocolVersion, minBackupProtocol = protocol, min
171 return func() { protocolVersion, minBackupProtocol = oldP, oldM }
172}
internal/backup/compat_test.go added +79 −0
@@ -0,0 +1,79 @@
1 package backup
2
3 import (
4 "net/http"
5 "testing"
6 )
7
8 func TestCompat(t *testing.T) {
9 cases := []struct {
10 bg, bgMin, bk, bkMin int
11 want string
12 }{
13 {1, 1, 1, 1, CompatOK},
14 {2, 1, 1, 1, CompatOK}, // oudere backup server, nog ondersteund
15 {1, 1, 2, 1, CompatOK}, // nieuwere backup server die BlueGit 1 nog kent
16 {3, 2, 1, 1, CompatBackupTooOld}, // BlueGit vraagt minstens 2
17 {1, 1, 3, 2, CompatBlueGitTooOld},
18 }
19 for _, c := range cases {
20 if got := Compat(c.bg, c.bgMin, c.bk, c.bkMin); got != c.want {
21 t.Errorf("Compat(%d,%d,%d,%d) = %s, wil %s", c.bg, c.bgMin, c.bk, c.bkMin, got, c.want)
22 }
23 }
24 }
25
26 func TestPeerFromHeader(t *testing.T) {
27 p, ok := PeerFromHeader(http.Header{})
28 if ok || p.Protocol != 1 || p.MinProtocol != 1 {
29 t.Fatalf("zonder koppen: %+v %v", p, ok)
30 }
31 h := http.Header{}
32 h.Set(HeaderBackupProtocol, "3")
33 h.Set(HeaderBackupMinProtocol, "2")
34 h.Set(HeaderBackupVersion, "v0.2.0<script>")
35 p, ok = PeerFromHeader(h)
36 if !ok || p.Protocol != 3 || p.MinProtocol != 2 || p.Version != "v0.2.0script" {
37 t.Fatalf("%+v", p)
38 }
39 h.Set(HeaderBackupProtocol, "onzin")
40 if p, _ := PeerFromHeader(h); p.Protocol != 1 {
41 t.Fatalf("onzin: %+v", p)
42 }
43 }
44
45 func TestSetPeerAndConnCompat(t *testing.T) {
46 m := &Manager{Dir: t.TempDir()}
47 _, c, err := m.Add("nas", "tim")
48 if err != nil {
49 t.Fatal(err)
50 }
51 if c.Compat() != "" {
52 t.Fatal("niet gekoppeld heeft geen oordeel")
53 }
54 if _, err := m.Connect(c.ID, "http://b", "sid"); err != nil {
55 t.Fatal(err)
56 }
57 c, _ = m.Get(c.ID)
58 if c.Compat() != "" {
59 t.Fatal("zonder melding nog onbekend")
60 }
61 m.SetPeer(c.ID, Peer{Protocol: Protocol() + 5, MinProtocol: Protocol() + 1, Version: "x"})
62 c, _ = m.Get(c.ID)
63 if c.Compat() != CompatBlueGitTooOld || !c.Incompatible() || c.PeerVersion != "x" {
64 t.Fatalf("%+v %s", c, c.Compat())
65 }
66 m.SetPeer(c.ID, Peer{Protocol: 1, MinProtocol: 1})
67 c, _ = m.Get(c.ID)
68 if c.Compat() != CompatOK || c.Incompatible() {
69 t.Fatalf("terug naar 1: %s", c.Compat())
70 }
71 // Een nieuwe key wist wat de oude server meldde.
72 if _, _, err := m.RotateKey(c.ID, "tim"); err != nil {
73 t.Fatal(err)
74 }
75 c, _ = m.Get(c.ID)
76 if c.PeerProtocol != 0 {
77 t.Fatal("protocol bleef staan na een nieuwe key")
78 }
79 }
@@ -0,0 +1,79 @@
1package backup
2
3import (
4 "net/http"
5 "testing"
6)
7
8func TestCompat(t *testing.T) {
9 cases := []struct {
10 bg, bgMin, bk, bkMin int
11 want string
12 }{
13 {1, 1, 1, 1, CompatOK},
14 {2, 1, 1, 1, CompatOK}, // oudere backup server, nog ondersteund
15 {1, 1, 2, 1, CompatOK}, // nieuwere backup server die BlueGit 1 nog kent
16 {3, 2, 1, 1, CompatBackupTooOld}, // BlueGit vraagt minstens 2
17 {1, 1, 3, 2, CompatBlueGitTooOld},
18 }
19 for _, c := range cases {
20 if got := Compat(c.bg, c.bgMin, c.bk, c.bkMin); got != c.want {
21 t.Errorf("Compat(%d,%d,%d,%d) = %s, wil %s", c.bg, c.bgMin, c.bk, c.bkMin, got, c.want)
22 }
23 }
24}
25
26func TestPeerFromHeader(t *testing.T) {
27 p, ok := PeerFromHeader(http.Header{})
28 if ok || p.Protocol != 1 || p.MinProtocol != 1 {
29 t.Fatalf("zonder koppen: %+v %v", p, ok)
30 }
31 h := http.Header{}
32 h.Set(HeaderBackupProtocol, "3")
33 h.Set(HeaderBackupMinProtocol, "2")
34 h.Set(HeaderBackupVersion, "v0.2.0<script>")
35 p, ok = PeerFromHeader(h)
36 if !ok || p.Protocol != 3 || p.MinProtocol != 2 || p.Version != "v0.2.0script" {
37 t.Fatalf("%+v", p)
38 }
39 h.Set(HeaderBackupProtocol, "onzin")
40 if p, _ := PeerFromHeader(h); p.Protocol != 1 {
41 t.Fatalf("onzin: %+v", p)
42 }
43}
44
45func TestSetPeerAndConnCompat(t *testing.T) {
46 m := &Manager{Dir: t.TempDir()}
47 _, c, err := m.Add("nas", "tim")
48 if err != nil {
49 t.Fatal(err)
50 }
51 if c.Compat() != "" {
52 t.Fatal("niet gekoppeld heeft geen oordeel")
53 }
54 if _, err := m.Connect(c.ID, "http://b", "sid"); err != nil {
55 t.Fatal(err)
56 }
57 c, _ = m.Get(c.ID)
58 if c.Compat() != "" {
59 t.Fatal("zonder melding nog onbekend")
60 }
61 m.SetPeer(c.ID, Peer{Protocol: Protocol() + 5, MinProtocol: Protocol() + 1, Version: "x"})
62 c, _ = m.Get(c.ID)
63 if c.Compat() != CompatBlueGitTooOld || !c.Incompatible() || c.PeerVersion != "x" {
64 t.Fatalf("%+v %s", c, c.Compat())
65 }
66 m.SetPeer(c.ID, Peer{Protocol: 1, MinProtocol: 1})
67 c, _ = m.Get(c.ID)
68 if c.Compat() != CompatOK || c.Incompatible() {
69 t.Fatalf("terug naar 1: %s", c.Compat())
70 }
71 // Een nieuwe key wist wat de oude server meldde.
72 if _, _, err := m.RotateKey(c.ID, "tim"); err != nil {
73 t.Fatal(err)
74 }
75 c, _ = m.Get(c.ID)
76 if c.PeerProtocol != 0 {
77 t.Fatal("protocol bleef staan na een nieuwe key")
78 }
79}
internal/backup/conn.go +6 −0
@@ -42,6 +42,11 @@ type Conn struct {
42 42 ServerID string `json:"server_id,omitempty"`
43 43 ConnectedAt time.Time `json:"connected_at,omitempty"`
44 44 LastSeen time.Time `json:"last_seen,omitempty"`
45 // Protocol van de backup server zoals hij het laatst meldde (0: nog
46 // onbekend). Zie compat.go.
47 PeerProtocol int `json:"peer_protocol,omitempty"`
48 PeerMinProtocol int `json:"peer_min_protocol,omitempty"`
49 PeerVersion string `json:"peer_version,omitempty"`
45 50 }
46 51
47 52 // HasKey zegt of er een key is uitgegeven.
@@ -239,6 +244,7 @@ func (m *Manager) RotateKey(id, by string) (string, Conn, error) {
239 244 c.KeyHash, c.SignSecret, c.KeyHint = HashKey(key), SigningSecret(key), key[:len(KeyPrefix)+6]
240 245 c.CreatedAt, c.CreatedBy = time.Now().UTC(), by
241 246 c.ServerURL, c.ServerID, c.ConnectedAt = "", "", time.Time{}
247 c.PeerProtocol, c.PeerMinProtocol, c.PeerVersion = 0, 0, ""
242 248 return nil
243 249 })
244 250 if err != nil {
@@ -42,6 +42,11 @@ type Conn struct {
42 ServerID string `json:"server_id,omitempty"`
42 ServerID string `json:"server_id,omitempty"`
43 ConnectedAt time.Time `json:"connected_at,omitempty"`
43 ConnectedAt time.Time `json:"connected_at,omitempty"`
44 LastSeen time.Time `json:"last_seen,omitempty"`
44 LastSeen time.Time `json:"last_seen,omitempty"`
45 // Protocol van de backup server zoals hij het laatst meldde (0: nog
46 // onbekend). Zie compat.go.
47 PeerProtocol int `json:"peer_protocol,omitempty"`
48 PeerMinProtocol int `json:"peer_min_protocol,omitempty"`
49 PeerVersion string `json:"peer_version,omitempty"`
45}
50}
46
51
47// HasKey zegt of er een key is uitgegeven.
52// HasKey zegt of er een key is uitgegeven.
@@ -239,6 +244,7 @@ func (m *Manager) RotateKey(id, by string) (string, Conn, error) {
239 c.KeyHash, c.SignSecret, c.KeyHint = HashKey(key), SigningSecret(key), key[:len(KeyPrefix)+6]
244 c.KeyHash, c.SignSecret, c.KeyHint = HashKey(key), SigningSecret(key), key[:len(KeyPrefix)+6]
240 c.CreatedAt, c.CreatedBy = time.Now().UTC(), by
245 c.CreatedAt, c.CreatedBy = time.Now().UTC(), by
241 c.ServerURL, c.ServerID, c.ConnectedAt = "", "", time.Time{}
246 c.ServerURL, c.ServerID, c.ConnectedAt = "", "", time.Time{}
247 c.PeerProtocol, c.PeerMinProtocol, c.PeerVersion = 0, 0, ""
242 return nil
248 return nil
243 })
249 })
244 if err != nil {
250 if err != nil {
internal/i18n/catalog_backupcompat.go added +45 −0
@@ -0,0 +1,45 @@
1 package i18n
2
3 // Banner en meldingen als een backup server niet bij deze BlueGit past.
4 func init() {
5 addCatalog(en, map[string]string{
6 "backup.compat.title": "Backup server “%s” is not compatible with this BlueGit.",
7 "backup.compat.bluegitOld": "BlueGit is out of date (protocol %d; the backup server needs at least %d). Update BlueGit. Until then no backups are made.",
8 "backup.compat.backupOld": "The backup server is out of date (protocol %d; BlueGit needs at least %d). Update the backup server. Until then no backups are made.",
9 "backup.compat.link": "Admin → Backup",
10 "backup.state.bluegitOld": "not compatible: update BlueGit",
11 "backup.state.backupOld": "not compatible: update the backup server",
12 "backup.status.protocol": "Protocol",
13 "backup.protocol.text": "backup server %d (supports BlueGit ≥ %d) · BlueGit %d (supports backup server ≥ %d)",
14 })
15 addCatalog(nl, map[string]string{
16 "backup.compat.title": "Backup server “%s” is niet compatibel met deze BlueGit.",
17 "backup.compat.bluegitOld": "BlueGit is verouderd (protocol %d; de backup server vraagt minstens %d). Update BlueGit. Tot dan worden er geen backups gemaakt.",
18 "backup.compat.backupOld": "De backup server is verouderd (protocol %d; BlueGit vraagt minstens %d). Update de backup server. Tot dan worden er geen backups gemaakt.",
19 "backup.compat.link": "Beheer → Backup",
20 "backup.state.bluegitOld": "niet compatibel: update BlueGit",
21 "backup.state.backupOld": "niet compatibel: update de backup server",
22 "backup.status.protocol": "Protocol",
23 "backup.protocol.text": "backup server %d (ondersteunt BlueGit ≥ %d) · BlueGit %d (ondersteunt backup server ≥ %d)",
24 })
25 addCatalog(de, map[string]string{
26 "backup.compat.title": "Backup-Server „%s“ ist nicht kompatibel mit diesem BlueGit.",
27 "backup.compat.bluegitOld": "BlueGit ist veraltet (Protokoll %d; der Backup-Server braucht mindestens %d). Aktualisiere BlueGit. Bis dahin werden keine Backups erstellt.",
28 "backup.compat.backupOld": "Der Backup-Server ist veraltet (Protokoll %d; BlueGit braucht mindestens %d). Aktualisiere den Backup-Server. Bis dahin werden keine Backups erstellt.",
29 "backup.compat.link": "Verwaltung → Backup",
30 "backup.state.bluegitOld": "nicht kompatibel: BlueGit aktualisieren",
31 "backup.state.backupOld": "nicht kompatibel: Backup-Server aktualisieren",
32 "backup.status.protocol": "Protokoll",
33 "backup.protocol.text": "Backup-Server %d (unterstützt BlueGit ≥ %d) · BlueGit %d (unterstützt Backup-Server ≥ %d)",
34 })
35 addCatalog(fr, map[string]string{
36 "backup.compat.title": "Le serveur de sauvegarde « %s » n’est pas compatible avec ce BlueGit.",
37 "backup.compat.bluegitOld": "BlueGit est obsolète (protocole %d ; le serveur de sauvegarde exige au moins %d). Mettez BlueGit à jour. D’ici là, aucune sauvegarde n’est faite.",
38 "backup.compat.backupOld": "Le serveur de sauvegarde est obsolète (protocole %d ; BlueGit exige au moins %d). Mettez le serveur de sauvegarde à jour. D’ici là, aucune sauvegarde n’est faite.",
39 "backup.compat.link": "Administration → Sauvegarde",
40 "backup.state.bluegitOld": "incompatible : mettre BlueGit à jour",
41 "backup.state.backupOld": "incompatible : mettre le serveur de sauvegarde à jour",
42 "backup.status.protocol": "Protocole",
43 "backup.protocol.text": "serveur de sauvegarde %d (accepte BlueGit ≥ %d) · BlueGit %d (accepte serveur de sauvegarde ≥ %d)",
44 })
45 }
@@ -0,0 +1,45 @@
1package i18n
2
3// Banner en meldingen als een backup server niet bij deze BlueGit past.
4func init() {
5 addCatalog(en, map[string]string{
6 "backup.compat.title": "Backup server “%s” is not compatible with this BlueGit.",
7 "backup.compat.bluegitOld": "BlueGit is out of date (protocol %d; the backup server needs at least %d). Update BlueGit. Until then no backups are made.",
8 "backup.compat.backupOld": "The backup server is out of date (protocol %d; BlueGit needs at least %d). Update the backup server. Until then no backups are made.",
9 "backup.compat.link": "Admin → Backup",
10 "backup.state.bluegitOld": "not compatible: update BlueGit",
11 "backup.state.backupOld": "not compatible: update the backup server",
12 "backup.status.protocol": "Protocol",
13 "backup.protocol.text": "backup server %d (supports BlueGit ≥ %d) · BlueGit %d (supports backup server ≥ %d)",
14 })
15 addCatalog(nl, map[string]string{
16 "backup.compat.title": "Backup server “%s” is niet compatibel met deze BlueGit.",
17 "backup.compat.bluegitOld": "BlueGit is verouderd (protocol %d; de backup server vraagt minstens %d). Update BlueGit. Tot dan worden er geen backups gemaakt.",
18 "backup.compat.backupOld": "De backup server is verouderd (protocol %d; BlueGit vraagt minstens %d). Update de backup server. Tot dan worden er geen backups gemaakt.",
19 "backup.compat.link": "Beheer → Backup",
20 "backup.state.bluegitOld": "niet compatibel: update BlueGit",
21 "backup.state.backupOld": "niet compatibel: update de backup server",
22 "backup.status.protocol": "Protocol",
23 "backup.protocol.text": "backup server %d (ondersteunt BlueGit ≥ %d) · BlueGit %d (ondersteunt backup server ≥ %d)",
24 })
25 addCatalog(de, map[string]string{
26 "backup.compat.title": "Backup-Server „%s“ ist nicht kompatibel mit diesem BlueGit.",
27 "backup.compat.bluegitOld": "BlueGit ist veraltet (Protokoll %d; der Backup-Server braucht mindestens %d). Aktualisiere BlueGit. Bis dahin werden keine Backups erstellt.",
28 "backup.compat.backupOld": "Der Backup-Server ist veraltet (Protokoll %d; BlueGit braucht mindestens %d). Aktualisiere den Backup-Server. Bis dahin werden keine Backups erstellt.",
29 "backup.compat.link": "Verwaltung → Backup",
30 "backup.state.bluegitOld": "nicht kompatibel: BlueGit aktualisieren",
31 "backup.state.backupOld": "nicht kompatibel: Backup-Server aktualisieren",
32 "backup.status.protocol": "Protokoll",
33 "backup.protocol.text": "Backup-Server %d (unterstützt BlueGit ≥ %d) · BlueGit %d (unterstützt Backup-Server ≥ %d)",
34 })
35 addCatalog(fr, map[string]string{
36 "backup.compat.title": "Le serveur de sauvegarde « %s » n’est pas compatible avec ce BlueGit.",
37 "backup.compat.bluegitOld": "BlueGit est obsolète (protocole %d ; le serveur de sauvegarde exige au moins %d). Mettez BlueGit à jour. D’ici là, aucune sauvegarde n’est faite.",
38 "backup.compat.backupOld": "Le serveur de sauvegarde est obsolète (protocole %d ; BlueGit exige au moins %d). Mettez le serveur de sauvegarde à jour. D’ici là, aucune sauvegarde n’est faite.",
39 "backup.compat.link": "Administration → Sauvegarde",
40 "backup.state.bluegitOld": "incompatible : mettre BlueGit à jour",
41 "backup.state.backupOld": "incompatible : mettre le serveur de sauvegarde à jour",
42 "backup.status.protocol": "Protocole",
43 "backup.protocol.text": "serveur de sauvegarde %d (accepte BlueGit ≥ %d) · BlueGit %d (accepte serveur de sauvegarde ≥ %d)",
44 })
45}
internal/server/backup.go +84 −4
@@ -51,6 +51,44 @@ type BackupServerView struct {
51 51 RemoteErr string
52 52 }
53 53
54 // BackupCompatIssue is een backup server die niet bij deze BlueGit past.
55 // Beheerders zien hem als banner bovenaan elke pagina.
56 type BackupCompatIssue struct {
57 ID, Name string
58 // BlueGitTooOld: BlueGit moet geüpdatet worden; anders de backup server.
59 BlueGitTooOld bool
60 // Protocol en Min van BlueGit en van de backup server.
61 Protocol, Min, PeerProtocol, PeerMin int
62 PeerVersion string
63 }
64
65 // backupCompatIssues leest backup.json (geen netwerk).
66 func (s *Server) backupCompatIssues() []BackupCompatIssue {
67 if s.StateDir == "" {
68 return nil
69 }
70 s.backupInit()
71 list, err := s.backupMgr.List()
72 if err != nil {
73 return nil
74 }
75 var out []BackupCompatIssue
76 for _, c := range list {
77 if !c.Incompatible() {
78 continue
79 }
80 min := c.PeerMinProtocol
81 if min == 0 {
82 min = 1
83 }
84 out = append(out, BackupCompatIssue{
85 ID: c.ID, Name: c.Name, BlueGitTooOld: c.Compat() == backup.CompatBlueGitTooOld,
86 Protocol: backup.Protocol(), Min: backup.MinProtocol(), PeerProtocol: c.PeerProtocol, PeerMin: min, PeerVersion: c.PeerVersion,
87 })
88 }
89 return out
90 }
91
54 92 func (s *Server) backupInit() {
55 93 s.backupOnce.Do(func() {
56 94 s.backupMgr = &backup.Manager{Dir: s.StateDir}
@@ -88,9 +126,9 @@ func (s *Server) backupTree(conn string) backup.Tree {
88 126 func (s *Server) mountBackup(mux *http.ServeMux) {
89 127 mux.HandleFunc("GET /api/v1/backup/info", s.backupKeyed(s.backupInfo))
90 128 mux.HandleFunc("POST /api/v1/backup/connect", s.backupKeyed(s.backupConnect))
91 mux.HandleFunc("GET /api/v1/backup/manifest", s.backupKeyed(s.backupManifest))
92 mux.HandleFunc("GET /api/v1/backup/file", s.backupKeyed(s.backupFile))
93 mux.HandleFunc("POST /api/v1/backup/restore", s.backupKeyed(s.backupRestore))
129 mux.HandleFunc("GET /api/v1/backup/manifest", s.backupKeyed(s.backupCompatible(s.backupManifest)))
130 mux.HandleFunc("GET /api/v1/backup/file", s.backupKeyed(s.backupCompatible(s.backupFile)))
131 mux.HandleFunc("POST /api/v1/backup/restore", s.backupKeyed(s.backupCompatible(s.backupRestore)))
94 132 mux.HandleFunc("GET /admin/backup", s.adminBackup)
95 133 mux.HandleFunc("POST /admin/backup/servers", s.adminBackupAdd)
96 134 mux.HandleFunc("GET /admin/backup/s/{id}", s.adminBackupServer)
@@ -130,6 +168,7 @@ func backupErr(w http.ResponseWriter, code int, msg string) {
130 168 func (s *Server) backupKeyed(h func(http.ResponseWriter, *http.Request)) http.HandlerFunc {
131 169 return func(w http.ResponseWriter, r *http.Request) {
132 170 w.Header().Set("Cache-Control", "no-store")
171 backup.SetOwnHeaders(w.Header())
133 172 if s.StateDir == "" {
134 173 backupErr(w, http.StatusNotFound, "backup niet beschikbaar")
135 174 return
@@ -146,10 +185,37 @@ func (s *Server) backupKeyed(h func(http.ResponseWriter, *http.Request)) http.Ha
146 185 return
147 186 }
148 187 s.backupMgr.Seen(conn.ID)
188 // Zonder koppen is het een backup server van vóór de
189 // protocolversie: protocol 1.
190 peer, _ := backup.PeerFromHeader(r.Header)
191 s.backupMgr.SetPeer(conn.ID, peer)
192 if c, ok := s.backupMgr.Get(conn.ID); ok {
193 conn = c
194 }
149 195 h(w, r.WithContext(context.WithValue(r.Context(), backupConnKey{}, conn)))
150 196 }
151 197 }
152 198
199 // backupCompatible weigert gegevens uit te wisselen met een backup server
200 // die niet bij deze BlueGit past (426, met wie er geüpdatet moet worden).
201 // info en connect blijven werken, zodat beide kanten het kunnen melden.
202 func (s *Server) backupCompatible(h func(http.ResponseWriter, *http.Request)) func(http.ResponseWriter, *http.Request) {
203 return func(w http.ResponseWriter, r *http.Request) {
204 c := backupConnOf(r)
205 if res := c.Compat(); res == backup.CompatBlueGitTooOld || res == backup.CompatBackupTooOld {
206 msg := "backup server te oud voor deze BlueGit; update de backup server"
207 if res == backup.CompatBlueGitTooOld {
208 msg = "BlueGit te oud voor deze backup server; update BlueGit"
209 }
210 writeJSON(w, http.StatusUpgradeRequired, map[string]any{
211 "error": msg, "compat": res, "protocol": backup.Protocol(), "min_protocol": backup.MinProtocol(),
212 })
213 return
214 }
215 h(w, r)
216 }
217 }
218
153 219 type backupConnKey struct{}
154 220
155 221 func backupConnOf(r *http.Request) backup.Conn {
@@ -167,6 +233,8 @@ func (s *Server) backupInfo(w http.ResponseWriter, r *http.Request) {
167 233 writeJSON(w, http.StatusOK, map[string]any{
168 234 "instance_id": id, "base_url": s.Cfg.BaseURL, "name": c.Name, "server_url": c.ServerURL, "server_id": c.ServerID,
169 235 "has_storage": s.StoragePath() != "",
236 "protocol": backup.Protocol(), "min_protocol": backup.MinProtocol(), "version": backup.Version(),
237 "compat": c.Compat(),
170 238 })
171 239 }
172 240
@@ -285,6 +353,12 @@ func (s *Server) backupServerView(ctx context.Context, conn backup.Conn) *Backup
285 353 }
286 354 ctx, cancel := context.WithTimeout(ctx, 8*time.Second)
287 355 defer cancel()
356 // De antwoorden kunnen een nieuw protocol gemeld hebben.
357 defer func() {
358 if fresh, ok := s.backupMgr.Get(conn.ID); ok {
359 v.Conn = fresh
360 }
361 }()
288 362 c := s.backupClient()
289 363 st, err := c.Status(ctx, conn)
290 364 if err != nil {
@@ -582,6 +656,12 @@ func backupConnJSON(c backup.Conn) map[string]any {
582 656 out["connected_at"] = rfcTime(c.ConnectedAt)
583 657 out["last_seen"] = rfcTime(c.LastSeen)
584 658 }
659 // compat: "" (nog onbekend), ok, bluegit_too_old of backup_too_old.
660 out["compat"] = c.Compat()
661 out["protocol"] = map[string]any{
662 "bluegit": backup.Protocol(), "bluegit_min": backup.MinProtocol(),
663 "backup": c.PeerProtocol, "backup_min": c.PeerMinProtocol, "backup_version": c.PeerVersion,
664 }
585 665 return out
586 666 }
587 667
@@ -647,7 +727,7 @@ func (s *Server) apiAdminBackupServer(w http.ResponseWriter, r *http.Request) {
647 727 return
648 728 }
649 729 v := s.backupServerView(r.Context(), c)
650 out := backupConnJSON(c)
730 out := backupConnJSON(v.Conn)
651 731 out["archives"] = v.Archives
652 732 if v.Archives == nil {
653 733 out["archives"] = []backup.Archive{}
@@ -51,6 +51,44 @@ type BackupServerView struct {
51 RemoteErr string
51 RemoteErr string
52}
52}
53
53
54// BackupCompatIssue is een backup server die niet bij deze BlueGit past.
55// Beheerders zien hem als banner bovenaan elke pagina.
56type BackupCompatIssue struct {
57 ID, Name string
58 // BlueGitTooOld: BlueGit moet geüpdatet worden; anders de backup server.
59 BlueGitTooOld bool
60 // Protocol en Min van BlueGit en van de backup server.
61 Protocol, Min, PeerProtocol, PeerMin int
62 PeerVersion string
63}
64
65// backupCompatIssues leest backup.json (geen netwerk).
66func (s *Server) backupCompatIssues() []BackupCompatIssue {
67 if s.StateDir == "" {
68 return nil
69 }
70 s.backupInit()
71 list, err := s.backupMgr.List()
72 if err != nil {
73 return nil
74 }
75 var out []BackupCompatIssue
76 for _, c := range list {
77 if !c.Incompatible() {
78 continue
79 }
80 min := c.PeerMinProtocol
81 if min == 0 {
82 min = 1
83 }
84 out = append(out, BackupCompatIssue{
85 ID: c.ID, Name: c.Name, BlueGitTooOld: c.Compat() == backup.CompatBlueGitTooOld,
86 Protocol: backup.Protocol(), Min: backup.MinProtocol(), PeerProtocol: c.PeerProtocol, PeerMin: min, PeerVersion: c.PeerVersion,
87 })
88 }
89 return out
90}
91
54func (s *Server) backupInit() {
92func (s *Server) backupInit() {
55 s.backupOnce.Do(func() {
93 s.backupOnce.Do(func() {
56 s.backupMgr = &backup.Manager{Dir: s.StateDir}
94 s.backupMgr = &backup.Manager{Dir: s.StateDir}
@@ -88,9 +126,9 @@ func (s *Server) backupTree(conn string) backup.Tree {
88func (s *Server) mountBackup(mux *http.ServeMux) {
126func (s *Server) mountBackup(mux *http.ServeMux) {
89 mux.HandleFunc("GET /api/v1/backup/info", s.backupKeyed(s.backupInfo))
127 mux.HandleFunc("GET /api/v1/backup/info", s.backupKeyed(s.backupInfo))
90 mux.HandleFunc("POST /api/v1/backup/connect", s.backupKeyed(s.backupConnect))
128 mux.HandleFunc("POST /api/v1/backup/connect", s.backupKeyed(s.backupConnect))
91 mux.HandleFunc("GET /api/v1/backup/manifest", s.backupKeyed(s.backupManifest))
129 mux.HandleFunc("GET /api/v1/backup/manifest", s.backupKeyed(s.backupCompatible(s.backupManifest)))
92 mux.HandleFunc("GET /api/v1/backup/file", s.backupKeyed(s.backupFile))
130 mux.HandleFunc("GET /api/v1/backup/file", s.backupKeyed(s.backupCompatible(s.backupFile)))
93 mux.HandleFunc("POST /api/v1/backup/restore", s.backupKeyed(s.backupRestore))
131 mux.HandleFunc("POST /api/v1/backup/restore", s.backupKeyed(s.backupCompatible(s.backupRestore)))
94 mux.HandleFunc("GET /admin/backup", s.adminBackup)
132 mux.HandleFunc("GET /admin/backup", s.adminBackup)
95 mux.HandleFunc("POST /admin/backup/servers", s.adminBackupAdd)
133 mux.HandleFunc("POST /admin/backup/servers", s.adminBackupAdd)
96 mux.HandleFunc("GET /admin/backup/s/{id}", s.adminBackupServer)
134 mux.HandleFunc("GET /admin/backup/s/{id}", s.adminBackupServer)
@@ -130,6 +168,7 @@ func backupErr(w http.ResponseWriter, code int, msg string) {
130func (s *Server) backupKeyed(h func(http.ResponseWriter, *http.Request)) http.HandlerFunc {
168func (s *Server) backupKeyed(h func(http.ResponseWriter, *http.Request)) http.HandlerFunc {
131 return func(w http.ResponseWriter, r *http.Request) {
169 return func(w http.ResponseWriter, r *http.Request) {
132 w.Header().Set("Cache-Control", "no-store")
170 w.Header().Set("Cache-Control", "no-store")
171 backup.SetOwnHeaders(w.Header())
133 if s.StateDir == "" {
172 if s.StateDir == "" {
134 backupErr(w, http.StatusNotFound, "backup niet beschikbaar")
173 backupErr(w, http.StatusNotFound, "backup niet beschikbaar")
135 return
174 return
@@ -146,10 +185,37 @@ func (s *Server) backupKeyed(h func(http.ResponseWriter, *http.Request)) http.Ha
146 return
185 return
147 }
186 }
148 s.backupMgr.Seen(conn.ID)
187 s.backupMgr.Seen(conn.ID)
188 // Zonder koppen is het een backup server van vóór de
189 // protocolversie: protocol 1.
190 peer, _ := backup.PeerFromHeader(r.Header)
191 s.backupMgr.SetPeer(conn.ID, peer)
192 if c, ok := s.backupMgr.Get(conn.ID); ok {
193 conn = c
194 }
149 h(w, r.WithContext(context.WithValue(r.Context(), backupConnKey{}, conn)))
195 h(w, r.WithContext(context.WithValue(r.Context(), backupConnKey{}, conn)))
150 }
196 }
151}
197}
152
198
199// backupCompatible weigert gegevens uit te wisselen met een backup server
200// die niet bij deze BlueGit past (426, met wie er geüpdatet moet worden).
201// info en connect blijven werken, zodat beide kanten het kunnen melden.
202func (s *Server) backupCompatible(h func(http.ResponseWriter, *http.Request)) func(http.ResponseWriter, *http.Request) {
203 return func(w http.ResponseWriter, r *http.Request) {
204 c := backupConnOf(r)
205 if res := c.Compat(); res == backup.CompatBlueGitTooOld || res == backup.CompatBackupTooOld {
206 msg := "backup server te oud voor deze BlueGit; update de backup server"
207 if res == backup.CompatBlueGitTooOld {
208 msg = "BlueGit te oud voor deze backup server; update BlueGit"
209 }
210 writeJSON(w, http.StatusUpgradeRequired, map[string]any{
211 "error": msg, "compat": res, "protocol": backup.Protocol(), "min_protocol": backup.MinProtocol(),
212 })
213 return
214 }
215 h(w, r)
216 }
217}
218
153type backupConnKey struct{}
219type backupConnKey struct{}
154
220
155func backupConnOf(r *http.Request) backup.Conn {
221func backupConnOf(r *http.Request) backup.Conn {
@@ -167,6 +233,8 @@ func (s *Server) backupInfo(w http.ResponseWriter, r *http.Request) {
167 writeJSON(w, http.StatusOK, map[string]any{
233 writeJSON(w, http.StatusOK, map[string]any{
168 "instance_id": id, "base_url": s.Cfg.BaseURL, "name": c.Name, "server_url": c.ServerURL, "server_id": c.ServerID,
234 "instance_id": id, "base_url": s.Cfg.BaseURL, "name": c.Name, "server_url": c.ServerURL, "server_id": c.ServerID,
169 "has_storage": s.StoragePath() != "",
235 "has_storage": s.StoragePath() != "",
236 "protocol": backup.Protocol(), "min_protocol": backup.MinProtocol(), "version": backup.Version(),
237 "compat": c.Compat(),
170 })
238 })
171}
239}
172
240
@@ -285,6 +353,12 @@ func (s *Server) backupServerView(ctx context.Context, conn backup.Conn) *Backup
285 }
353 }
286 ctx, cancel := context.WithTimeout(ctx, 8*time.Second)
354 ctx, cancel := context.WithTimeout(ctx, 8*time.Second)
287 defer cancel()
355 defer cancel()
356 // De antwoorden kunnen een nieuw protocol gemeld hebben.
357 defer func() {
358 if fresh, ok := s.backupMgr.Get(conn.ID); ok {
359 v.Conn = fresh
360 }
361 }()
288 c := s.backupClient()
362 c := s.backupClient()
289 st, err := c.Status(ctx, conn)
363 st, err := c.Status(ctx, conn)
290 if err != nil {
364 if err != nil {
@@ -582,6 +656,12 @@ func backupConnJSON(c backup.Conn) map[string]any {
582 out["connected_at"] = rfcTime(c.ConnectedAt)
656 out["connected_at"] = rfcTime(c.ConnectedAt)
583 out["last_seen"] = rfcTime(c.LastSeen)
657 out["last_seen"] = rfcTime(c.LastSeen)
584 }
658 }
659 // compat: "" (nog onbekend), ok, bluegit_too_old of backup_too_old.
660 out["compat"] = c.Compat()
661 out["protocol"] = map[string]any{
662 "bluegit": backup.Protocol(), "bluegit_min": backup.MinProtocol(),
663 "backup": c.PeerProtocol, "backup_min": c.PeerMinProtocol, "backup_version": c.PeerVersion,
664 }
585 return out
665 return out
586}
666}
587
667
@@ -647,7 +727,7 @@ func (s *Server) apiAdminBackupServer(w http.ResponseWriter, r *http.Request) {
647 return
727 return
648 }
728 }
649 v := s.backupServerView(r.Context(), c)
729 v := s.backupServerView(r.Context(), c)
650 out := backupConnJSON(c)
730 out := backupConnJSON(v.Conn)
651 out["archives"] = v.Archives
731 out["archives"] = v.Archives
652 if v.Archives == nil {
732 if v.Archives == nil {
653 out["archives"] = []backup.Archive{}
733 out["archives"] = []backup.Archive{}
internal/server/backup_test.go +85 −0
@@ -417,3 +417,88 @@ func buildTarFromInstance(t *testing.T, e *backupEnv, key string) string {
417 417 writeTarGz(t, &sb, files)
418 418 return sb.String()
419 419 }
420
421 // Feature: beheerders zien bovenaan elke pagina een banner als een backup
422 // server niet bij deze BlueGit past; BlueGit weigert dan gegevens uit te
423 // wisselen (426), maar info en connect blijven werken.
424 func TestBackupCompatBanner(t *testing.T) {
425 e := newBackupEnv(t)
426 k := addBackupServer(t, e, "nas")
427 call := func(method, path, proto, min string, body io.Reader) (int, []byte, http.Header) {
428 req, _ := http.NewRequest(method, e.base+path, body)
429 req.Header.Set("Authorization", "Bearer "+k.Key)
430 if proto != "" {
431 req.Header.Set(backup.HeaderBackupProtocol, proto)
432 req.Header.Set(backup.HeaderBackupMinProtocol, min)
433 req.Header.Set(backup.HeaderBackupVersion, "v9.9.9")
434 }
435 res, err := http.DefaultClient.Do(req)
436 if err != nil {
437 t.Fatal(err)
438 }
439 defer res.Body.Close()
440 b, _ := io.ReadAll(res.Body)
441 return res.StatusCode, b, res.Header
442 }
443 // Een backup server zonder koppen (v0.1.0) spreekt protocol 1: past.
444 if code, b, h := call("POST", "/api/v1/backup/connect", "", "", strings.NewReader(`{"server_url":"http://127.0.0.1:9","server_id":"s"}`)); code != 200 || h.Get(backup.HeaderBlueGitProtocol) != "1" {
445 t.Fatalf("connect: %d %s %v", code, b, h)
446 }
447 if code, _, _ := call("GET", "/api/v1/backup/manifest", "", "", nil); code != 200 {
448 t.Fatalf("manifest v1: %d", code)
449 }
450 tim, _ := sessionClient(t, e.st, e.base, e.tim.ID)
451 bob, _ := e.st.UpsertUser(context.Background(), 2, "bob", "", false)
452 bobc, _ := sessionClient(t, e.st, e.base, bob.ID)
453 page := func(c *http.Client, p string) string {
454 res, err := c.Get(e.base + p)
455 if err != nil {
456 t.Fatal(err)
457 }
458 return body(t, res)
459 }
460 if strings.Contains(page(tim, "/"), "compat-banner") {
461 t.Fatal("banner terwijl alles past")
462 }
463
464 // De backup server vraagt minstens protocol 9: BlueGit is te oud.
465 code, b, _ := call("GET", "/api/v1/backup/info", "9", "9", nil)
466 if code != 200 || !strings.Contains(string(b), `"compat":"bluegit_too_old"`) || !strings.Contains(string(b), `"protocol":1`) {
467 t.Fatalf("info: %d %s", code, b)
468 }
469 code, b, _ = call("GET", "/api/v1/backup/manifest", "9", "9", nil)
470 if code != http.StatusUpgradeRequired || !strings.Contains(string(b), "bluegit_too_old") {
471 t.Fatalf("manifest bij te oude BlueGit: %d %s", code, b)
472 }
473 for _, p := range []string{"/", "/users/tim", "/admin/backup", "/-/info", "/help"} {
474 html := page(tim, p)
475 if !strings.Contains(html, `class="compat-banner"`) || !strings.Contains(html, "nas") || !strings.Contains(html, `href="/admin/backup"`) || !strings.Contains(html, "Update BlueGit") {
476 t.Fatalf("%s: geen banner voor de beheerder:\n%.2000s", p, html)
477 }
478 }
479 if html := page(bobc, "/"); strings.Contains(html, "compat-banner") || strings.Contains(html, "nas") {
480 t.Fatal("niet-beheerder ziet de banner")
481 }
482 // Ook in de API voor beheerders.
483 if code, b := rapi(t, e.base, e.tok, "GET", "/admin/backup", nil); code != 200 || !strings.Contains(string(b), `"compat":"bluegit_too_old"`) {
484 t.Fatalf("api: %d %s", code, b)
485 }
486
487 // BlueGit vraagt minstens protocol 3; de backup server spreekt 2.
488 restore := backup.OverrideProtocol("4", "3")
489 defer restore()
490 code, b, _ = call("GET", "/api/v1/backup/manifest", "2", "1", nil)
491 if code != http.StatusUpgradeRequired || !strings.Contains(string(b), "backup_too_old") {
492 t.Fatalf("manifest bij te oude backup server: %d %s", code, b)
493 }
494 if html := page(tim, "/"); !strings.Contains(html, "The backup server is out of date") {
495 t.Fatalf("banner zegt niet dat de backup server te oud is:\n%.2000s", html)
496 }
497 // Bijgewerkt: de banner verdwijnt.
498 if code, _, _ := call("GET", "/api/v1/backup/manifest", "4", "1", nil); code != 200 {
499 t.Fatalf("na update: %d", code)
500 }
501 if strings.Contains(page(tim, "/"), "compat-banner") {
502 t.Fatal("banner blijft na de update")
503 }
504 }
@@ -417,3 +417,88 @@ func buildTarFromInstance(t *testing.T, e *backupEnv, key string) string {
417 writeTarGz(t, &sb, files)
417 writeTarGz(t, &sb, files)
418 return sb.String()
418 return sb.String()
419}
419}
420
421// Feature: beheerders zien bovenaan elke pagina een banner als een backup
422// server niet bij deze BlueGit past; BlueGit weigert dan gegevens uit te
423// wisselen (426), maar info en connect blijven werken.
424func TestBackupCompatBanner(t *testing.T) {
425 e := newBackupEnv(t)
426 k := addBackupServer(t, e, "nas")
427 call := func(method, path, proto, min string, body io.Reader) (int, []byte, http.Header) {
428 req, _ := http.NewRequest(method, e.base+path, body)
429 req.Header.Set("Authorization", "Bearer "+k.Key)
430 if proto != "" {
431 req.Header.Set(backup.HeaderBackupProtocol, proto)
432 req.Header.Set(backup.HeaderBackupMinProtocol, min)
433 req.Header.Set(backup.HeaderBackupVersion, "v9.9.9")
434 }
435 res, err := http.DefaultClient.Do(req)
436 if err != nil {
437 t.Fatal(err)
438 }
439 defer res.Body.Close()
440 b, _ := io.ReadAll(res.Body)
441 return res.StatusCode, b, res.Header
442 }
443 // Een backup server zonder koppen (v0.1.0) spreekt protocol 1: past.
444 if code, b, h := call("POST", "/api/v1/backup/connect", "", "", strings.NewReader(`{"server_url":"http://127.0.0.1:9","server_id":"s"}`)); code != 200 || h.Get(backup.HeaderBlueGitProtocol) != "1" {
445 t.Fatalf("connect: %d %s %v", code, b, h)
446 }
447 if code, _, _ := call("GET", "/api/v1/backup/manifest", "", "", nil); code != 200 {
448 t.Fatalf("manifest v1: %d", code)
449 }
450 tim, _ := sessionClient(t, e.st, e.base, e.tim.ID)
451 bob, _ := e.st.UpsertUser(context.Background(), 2, "bob", "", false)
452 bobc, _ := sessionClient(t, e.st, e.base, bob.ID)
453 page := func(c *http.Client, p string) string {
454 res, err := c.Get(e.base + p)
455 if err != nil {
456 t.Fatal(err)
457 }
458 return body(t, res)
459 }
460 if strings.Contains(page(tim, "/"), "compat-banner") {
461 t.Fatal("banner terwijl alles past")
462 }
463
464 // De backup server vraagt minstens protocol 9: BlueGit is te oud.
465 code, b, _ := call("GET", "/api/v1/backup/info", "9", "9", nil)
466 if code != 200 || !strings.Contains(string(b), `"compat":"bluegit_too_old"`) || !strings.Contains(string(b), `"protocol":1`) {
467 t.Fatalf("info: %d %s", code, b)
468 }
469 code, b, _ = call("GET", "/api/v1/backup/manifest", "9", "9", nil)
470 if code != http.StatusUpgradeRequired || !strings.Contains(string(b), "bluegit_too_old") {
471 t.Fatalf("manifest bij te oude BlueGit: %d %s", code, b)
472 }
473 for _, p := range []string{"/", "/users/tim", "/admin/backup", "/-/info", "/help"} {
474 html := page(tim, p)
475 if !strings.Contains(html, `class="compat-banner"`) || !strings.Contains(html, "nas") || !strings.Contains(html, `href="/admin/backup"`) || !strings.Contains(html, "Update BlueGit") {
476 t.Fatalf("%s: geen banner voor de beheerder:\n%.2000s", p, html)
477 }
478 }
479 if html := page(bobc, "/"); strings.Contains(html, "compat-banner") || strings.Contains(html, "nas") {
480 t.Fatal("niet-beheerder ziet de banner")
481 }
482 // Ook in de API voor beheerders.
483 if code, b := rapi(t, e.base, e.tok, "GET", "/admin/backup", nil); code != 200 || !strings.Contains(string(b), `"compat":"bluegit_too_old"`) {
484 t.Fatalf("api: %d %s", code, b)
485 }
486
487 // BlueGit vraagt minstens protocol 3; de backup server spreekt 2.
488 restore := backup.OverrideProtocol("4", "3")
489 defer restore()
490 code, b, _ = call("GET", "/api/v1/backup/manifest", "2", "1", nil)
491 if code != http.StatusUpgradeRequired || !strings.Contains(string(b), "backup_too_old") {
492 t.Fatalf("manifest bij te oude backup server: %d %s", code, b)
493 }
494 if html := page(tim, "/"); !strings.Contains(html, "The backup server is out of date") {
495 t.Fatalf("banner zegt niet dat de backup server te oud is:\n%.2000s", html)
496 }
497 // Bijgewerkt: de banner verdwijnt.
498 if code, _, _ := call("GET", "/api/v1/backup/manifest", "4", "1", nil); code != 200 {
499 t.Fatalf("na update: %d", code)
500 }
501 if strings.Contains(page(tim, "/"), "compat-banner") {
502 t.Fatal("banner blijft na de update")
503 }
504}
internal/server/server.go +9 −3
@@ -323,9 +323,11 @@ func (s *Server) mustTemplates() {
323 323 }
324 324 return strings.Split(p, "/")
325 325 },
326 "iconOf": func(name string) string { return fileIcon(name, "blob") },
327 "t": func(key string, args ...any) string { return i18n.T(l, key, args...) },
328 "date": func(t time.Time) string { return i18n.FormatDate(l, t) },
326 "iconOf": func(name string) string { return fileIcon(name, "blob") },
327 "t": func(key string, args ...any) string { return i18n.T(l, key, args...) },
328 "bgprotocol": backup.Protocol,
329 "bgminprotocol": backup.MinProtocol,
330 "date": func(t time.Time) string { return i18n.FormatDate(l, t) },
329 331 "tn": func(n int, one, many string) string {
330 332 key := many
331 333 if n == 1 {
@@ -598,6 +600,9 @@ func (s *Server) render(w http.ResponseWriter, name string, v View) {
598 600 if tmpl == nil {
599 601 tmpl = s.tmpl
600 602 }
603 if v.User != nil && v.User.InstanceAdmin {
604 v.BackupCompat = s.backupCompatIssues()
605 }
601 606 if err := tmpl.ExecuteTemplate(w, name, v); err != nil && s.Log != nil {
602 607 s.Log.Error("sjabloon", "name", name, "err", err)
603 608 }
@@ -614,6 +619,7 @@ func randomState() (string, error) {
614 619 // View is de gegevensset voor elk scherm.
615 620 type View struct {
616 621 Backup *BackupView
622 BackupCompat []BackupCompatIssue
617 623 RunnerList []RunnerView
618 624 RunnerPref string
619 625 NewRunnerToken string
@@ -323,9 +323,11 @@ func (s *Server) mustTemplates() {
323 }
323 }
324 return strings.Split(p, "/")
324 return strings.Split(p, "/")
325 },
325 },
326 "iconOf": func(name string) string { return fileIcon(name, "blob") },
326 "iconOf": func(name string) string { return fileIcon(name, "blob") },
327 "t": func(key string, args ...any) string { return i18n.T(l, key, args...) },
327 "t": func(key string, args ...any) string { return i18n.T(l, key, args...) },
328 "date": func(t time.Time) string { return i18n.FormatDate(l, t) },
328 "bgprotocol": backup.Protocol,
329 "bgminprotocol": backup.MinProtocol,
330 "date": func(t time.Time) string { return i18n.FormatDate(l, t) },
329 "tn": func(n int, one, many string) string {
331 "tn": func(n int, one, many string) string {
330 key := many
332 key := many
331 if n == 1 {
333 if n == 1 {
@@ -598,6 +600,9 @@ func (s *Server) render(w http.ResponseWriter, name string, v View) {
598 if tmpl == nil {
600 if tmpl == nil {
599 tmpl = s.tmpl
601 tmpl = s.tmpl
600 }
602 }
603 if v.User != nil && v.User.InstanceAdmin {
604 v.BackupCompat = s.backupCompatIssues()
605 }
601 if err := tmpl.ExecuteTemplate(w, name, v); err != nil && s.Log != nil {
606 if err := tmpl.ExecuteTemplate(w, name, v); err != nil && s.Log != nil {
602 s.Log.Error("sjabloon", "name", name, "err", err)
607 s.Log.Error("sjabloon", "name", name, "err", err)
603 }
608 }
@@ -614,6 +619,7 @@ func randomState() (string, error) {
614// View is de gegevensset voor elk scherm.
619// View is de gegevensset voor elk scherm.
615type View struct {
620type View struct {
616 Backup *BackupView
621 Backup *BackupView
622 BackupCompat []BackupCompatIssue
617 RunnerList []RunnerView
623 RunnerList []RunnerView
618 RunnerPref string
624 RunnerPref string
619 NewRunnerToken string
625 NewRunnerToken string
internal/server/static/style.css +5 −0
@@ -1890,3 +1890,8 @@ span.starbtn.starred { color: #9a6700; }
1890 1890 .backup-config { display: grid; gap: 10px; max-width: 46em; }
1891 1891 .backup-config label { display: grid; gap: 2px; }
1892 1892 .backup-status th { width: 14em; }
1893
1894 /* Banner voor beheerders: een backup server past niet bij deze BlueGit. */
1895 .compat-banner { background: #fff4d6; color: #6b4a00; border-bottom: 1px solid #e8c766; padding: var(--sp-2) var(--sp-4); }
1896 .compat-banner strong { margin-right: var(--sp-2); }
1897 .compat-banner a { margin-left: var(--sp-2); font-weight: 600; color: inherit; }
@@ -1890,3 +1890,8 @@ span.starbtn.starred { color: #9a6700; }
1890.backup-config { display: grid; gap: 10px; max-width: 46em; }
1890.backup-config { display: grid; gap: 10px; max-width: 46em; }
1891.backup-config label { display: grid; gap: 2px; }
1891.backup-config label { display: grid; gap: 2px; }
1892.backup-status th { width: 14em; }
1892.backup-status th { width: 14em; }
1893
1894/* Banner voor beheerders: een backup server past niet bij deze BlueGit. */
1895.compat-banner { background: #fff4d6; color: #6b4a00; border-bottom: 1px solid #e8c766; padding: var(--sp-2) var(--sp-4); }
1896.compat-banner strong { margin-right: var(--sp-2); }
1897.compat-banner a { margin-left: var(--sp-2); font-weight: 600; color: inherit; }
internal/server/templates/backup.html +5 −1
@@ -15,6 +15,7 @@
15 15 <h2>{{t "backup.server.title"}}</h2>
16 16 {{if .Conn.Connected}}
17 17 <p>{{t "backup.server.connected" .Conn.ServerURL}} <span class="muted">{{t "backup.server.seen"}} {{date .Conn.LastSeen}}</span></p>
18 {{if .Conn.Incompatible}}<p class="backup-danger-text" id="backup-compat">{{if eq .Conn.Compat "bluegit_too_old"}}{{t "backup.state.bluegitOld"}}{{else}}{{t "backup.state.backupOld"}}{{end}}</p>{{end}}
18 19 {{if .RemoteErr}}<p class="backup-danger-text">{{t "backup.server.unreachable" .RemoteErr}}</p>{{end}}
19 20 {{with .Remote}}
20 21 <table class="rui-table backup-status">
@@ -25,6 +26,7 @@
25 26 <tr><th>{{t "backup.archives.title"}}</th><td>{{.Archives}}{{if not .LastArchive.IsZero}} · {{date .LastArchive}}{{end}}{{if .ArchiveError}} <span class="backup-danger-text">{{.ArchiveError}}</span>{{end}}</td></tr>
26 27 {{if .Rollback.State}}<tr><th>{{t "backup.status.rollback"}}</th><td>{{.Rollback.State}} {{.Rollback.Archive}}{{if .Rollback.Error}} <span class="backup-danger-text">{{.Rollback.Error}}</span>{{end}}</td></tr>{{end}}
27 28 <tr><th>{{t "backup.status.version"}}</th><td>{{.Version}}</td></tr>
29 <tr><th>{{t "backup.status.protocol"}}</th><td>{{template "backupprotocol" $.Backup.Current.Conn}}</td></tr>
28 30 </table>
29 31 <div class="row backup-actions">
30 32 <form method="post" action="/admin/backup/s/{{$.Backup.Current.Conn.ID}}/act/sync"><input type="hidden" name="csrf" value="{{$.CSRF}}"><button type="submit">{{t "backup.act.sync"}}</button></form>
@@ -122,7 +124,7 @@
122 124 <tbody>
123 125 {{range .Servers}}<tr>
124 126 <td><a href="/admin/backup/s/{{.ID}}">{{.Name}}</a></td>
125 <td>{{if .Connected}}{{t "backup.state.connected"}}{{else}}{{t "backup.state.waiting"}}{{end}}</td>
127 <td>{{if .Connected}}{{t "backup.state.connected"}}{{else}}{{t "backup.state.waiting"}}{{end}}{{if .Incompatible}} <span class="backup-danger-text">{{if eq .Compat "bluegit_too_old"}}{{t "backup.state.bluegitOld"}}{{else}}{{t "backup.state.backupOld"}}{{end}}</span>{{end}}</td>
126 128 <td>{{if .ServerURL}}<code>{{.ServerURL}}</code>{{else}}—{{end}}</td>
127 129 <td>{{if .LastSeen.IsZero}}—{{else}}{{date .LastSeen}}{{end}}</td>
128 130 <td><a href="/admin/backup/s/{{.ID}}">{{t "backup.open"}}</a></td>
@@ -147,3 +149,5 @@
147 149 {{end}}
148 150 {{template "layout-end" .}}
149 151 {{end}}
152
153 {{define "backupprotocol"}}{{if .PeerProtocol}}{{t "backup.protocol.text" .PeerProtocol .PeerMinProtocol (bgprotocol) (bgminprotocol)}}{{else}}—{{end}}{{end}}
@@ -15,6 +15,7 @@
15 <h2>{{t "backup.server.title"}}</h2>
15 <h2>{{t "backup.server.title"}}</h2>
16 {{if .Conn.Connected}}
16 {{if .Conn.Connected}}
17 <p>{{t "backup.server.connected" .Conn.ServerURL}} <span class="muted">{{t "backup.server.seen"}} {{date .Conn.LastSeen}}</span></p>
17 <p>{{t "backup.server.connected" .Conn.ServerURL}} <span class="muted">{{t "backup.server.seen"}} {{date .Conn.LastSeen}}</span></p>
18 {{if .Conn.Incompatible}}<p class="backup-danger-text" id="backup-compat">{{if eq .Conn.Compat "bluegit_too_old"}}{{t "backup.state.bluegitOld"}}{{else}}{{t "backup.state.backupOld"}}{{end}}</p>{{end}}
18 {{if .RemoteErr}}<p class="backup-danger-text">{{t "backup.server.unreachable" .RemoteErr}}</p>{{end}}
19 {{if .RemoteErr}}<p class="backup-danger-text">{{t "backup.server.unreachable" .RemoteErr}}</p>{{end}}
19 {{with .Remote}}
20 {{with .Remote}}
20 <table class="rui-table backup-status">
21 <table class="rui-table backup-status">
@@ -25,6 +26,7 @@
25 <tr><th>{{t "backup.archives.title"}}</th><td>{{.Archives}}{{if not .LastArchive.IsZero}} · {{date .LastArchive}}{{end}}{{if .ArchiveError}} <span class="backup-danger-text">{{.ArchiveError}}</span>{{end}}</td></tr>
26 <tr><th>{{t "backup.archives.title"}}</th><td>{{.Archives}}{{if not .LastArchive.IsZero}} · {{date .LastArchive}}{{end}}{{if .ArchiveError}} <span class="backup-danger-text">{{.ArchiveError}}</span>{{end}}</td></tr>
26 {{if .Rollback.State}}<tr><th>{{t "backup.status.rollback"}}</th><td>{{.Rollback.State}} {{.Rollback.Archive}}{{if .Rollback.Error}} <span class="backup-danger-text">{{.Rollback.Error}}</span>{{end}}</td></tr>{{end}}
27 {{if .Rollback.State}}<tr><th>{{t "backup.status.rollback"}}</th><td>{{.Rollback.State}} {{.Rollback.Archive}}{{if .Rollback.Error}} <span class="backup-danger-text">{{.Rollback.Error}}</span>{{end}}</td></tr>{{end}}
27 <tr><th>{{t "backup.status.version"}}</th><td>{{.Version}}</td></tr>
28 <tr><th>{{t "backup.status.version"}}</th><td>{{.Version}}</td></tr>
29 <tr><th>{{t "backup.status.protocol"}}</th><td>{{template "backupprotocol" $.Backup.Current.Conn}}</td></tr>
28 </table>
30 </table>
29 <div class="row backup-actions">
31 <div class="row backup-actions">
30 <form method="post" action="/admin/backup/s/{{$.Backup.Current.Conn.ID}}/act/sync"><input type="hidden" name="csrf" value="{{$.CSRF}}"><button type="submit">{{t "backup.act.sync"}}</button></form>
32 <form method="post" action="/admin/backup/s/{{$.Backup.Current.Conn.ID}}/act/sync"><input type="hidden" name="csrf" value="{{$.CSRF}}"><button type="submit">{{t "backup.act.sync"}}</button></form>
@@ -122,7 +124,7 @@
122 <tbody>
124 <tbody>
123 {{range .Servers}}<tr>
125 {{range .Servers}}<tr>
124 <td><a href="/admin/backup/s/{{.ID}}">{{.Name}}</a></td>
126 <td><a href="/admin/backup/s/{{.ID}}">{{.Name}}</a></td>
125 <td>{{if .Connected}}{{t "backup.state.connected"}}{{else}}{{t "backup.state.waiting"}}{{end}}</td>
127 <td>{{if .Connected}}{{t "backup.state.connected"}}{{else}}{{t "backup.state.waiting"}}{{end}}{{if .Incompatible}} <span class="backup-danger-text">{{if eq .Compat "bluegit_too_old"}}{{t "backup.state.bluegitOld"}}{{else}}{{t "backup.state.backupOld"}}{{end}}</span>{{end}}</td>
126 <td>{{if .ServerURL}}<code>{{.ServerURL}}</code>{{else}}—{{end}}</td>
128 <td>{{if .ServerURL}}<code>{{.ServerURL}}</code>{{else}}—{{end}}</td>
127 <td>{{if .LastSeen.IsZero}}—{{else}}{{date .LastSeen}}{{end}}</td>
129 <td>{{if .LastSeen.IsZero}}—{{else}}{{date .LastSeen}}{{end}}</td>
128 <td><a href="/admin/backup/s/{{.ID}}">{{t "backup.open"}}</a></td>
130 <td><a href="/admin/backup/s/{{.ID}}">{{t "backup.open"}}</a></td>
@@ -147,3 +149,5 @@
147{{end}}
149{{end}}
148{{template "layout-end" .}}
150{{template "layout-end" .}}
149{{end}}
151{{end}}
152
153{{define "backupprotocol"}}{{if .PeerProtocol}}{{t "backup.protocol.text" .PeerProtocol .PeerMinProtocol (bgprotocol) (bgminprotocol)}}{{else}}—{{end}}{{end}}
internal/server/templates/layout.html +7 −0
@@ -47,6 +47,13 @@
47 47 {{end}}
48 48 </nav>
49 49 </header>
50 {{range .BackupCompat}}
51 <div class="compat-banner" role="alert" data-backup-compat="{{.ID}}">
52 <strong>{{t "backup.compat.title" .Name}}</strong>
53 {{if .BlueGitTooOld}}{{t "backup.compat.bluegitOld" .Protocol .PeerMin}}{{else}}{{t "backup.compat.backupOld" .PeerProtocol .Min}}{{end}}
54 <a href="/admin/backup">{{t "backup.compat.link"}}</a>
55 </div>
56 {{end}}
50 57 <div class="frame{{if or .Repo .Group .Info .Help .User}} with-side{{end}}">
51 58 {{if .Repo}}{{template "reposide" .}}{{else if .Group}}{{template "groupside" .}}{{else if .Info}}{{template "infoside" .}}{{else if .Help}}{{template "helpside" .}}{{else if .User}}{{template "dashside" .}}{{end}}
52 59 <div class="content">
@@ -47,6 +47,13 @@
47 {{end}}
47 {{end}}
48 </nav>
48 </nav>
49</header>
49</header>
50{{range .BackupCompat}}
51<div class="compat-banner" role="alert" data-backup-compat="{{.ID}}">
52 <strong>{{t "backup.compat.title" .Name}}</strong>
53 {{if .BlueGitTooOld}}{{t "backup.compat.bluegitOld" .Protocol .PeerMin}}{{else}}{{t "backup.compat.backupOld" .PeerProtocol .Min}}{{end}}
54 <a href="/admin/backup">{{t "backup.compat.link"}}</a>
55</div>
56{{end}}
50<div class="frame{{if or .Repo .Group .Info .Help .User}} with-side{{end}}">
57<div class="frame{{if or .Repo .Group .Info .Help .User}} with-side{{end}}">
51{{if .Repo}}{{template "reposide" .}}{{else if .Group}}{{template "groupside" .}}{{else if .Info}}{{template "infoside" .}}{{else if .Help}}{{template "helpside" .}}{{else if .User}}{{template "dashside" .}}{{end}}
58{{if .Repo}}{{template "reposide" .}}{{else if .Group}}{{template "groupside" .}}{{else if .Info}}{{template "infoside" .}}{{else if .Help}}{{template "helpside" .}}{{else if .User}}{{template "dashside" .}}{{end}}
52<div class="content">
59<div class="content">