BlueGit

timfa bluegit

Web-UI op :8080, beheer-API met volledige pariteit, bediening vanuit BlueGit, meerdere backup servers per BlueGit

- Eén actielijst stuurt API-routes, UI-formulieren en BlueGit-proxy aan
- Instellingen live aanpasbaar (settings.yml boven config.yml)
- Login met sessie + CSRF, rate limit op mislukte logins
- CLI: config, set, disconnect, delete, rollback, actions, token
- Integratietests tegen een echte BlueGit voor UI, API, pariteit en multi-instance

timfa Grok Bot · pushed by timfa

Authored 2026-11-15 · 2 days ago

Hash
411d902489aba36670ae9841c7cbce11827105c4
Parent
2fcf33c0
21 files changed +2253 −184
cmd/bluegit-backup/main.go +112 −0
@@ -12,6 +12,7 @@ import (
12 12 "log/slog"
13 13 "net"
14 14 "net/http"
15 "net/url"
15 16 "os"
16 17 "os/signal"
17 18 "strings"
@@ -32,6 +33,13 @@ func usage() {
32 33 bluegit-backup archive [--config …] nu een archief maken
33 34 bluegit-backup sync [--config …] nu synchroniseren
34 35 bluegit-backup prune [--config …] bewaarregels nu toepassen
36 bluegit-backup config [--config …] instellingen tonen
37 bluegit-backup set [--config …] sleutel=waarde … instellingen wijzigen
38 bluegit-backup delete [--config …] ARCHIEF
39 bluegit-backup rollback [--config …] ARCHIEF (vraagt om de naam over te typen)
40 bluegit-backup disconnect [--config …]
41 bluegit-backup actions [--config …] alle API-acties
42 bluegit-backup token [--config …] het beheertoken voor de webinterface
35 43 bluegit-backup example-config
36 44 bluegit-backup version
37 45
@@ -60,6 +68,22 @@ func main() {
60 68 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/sync")
61 69 case "prune":
62 70 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/prune")
71 case "config":
72 err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/config")
73 case "set":
74 err = setConfig(os.Args[2:])
75 case "disconnect":
76 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/disconnect")
77 case "delete":
78 err = withName(os.Args[2:], func(c *client, name string) (int, []byte, error) {
79 return c.do(http.MethodDelete, "/api/v1/admin/archives/"+url.PathEscape(name), nil)
80 })
81 case "rollback":
82 err = rollback(os.Args[2:], os.Stdin, os.Stdout)
83 case "actions":
84 err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/actions")
85 case "token":
86 err = printToken(os.Args[2:])
63 87 case "example-config":
64 88 fmt.Print(config.Example())
65 89 case "version":
@@ -102,6 +126,7 @@ func serve(args []string) error {
102 126 }
103 127 ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
104 128 defer stop()
129 cfg = srv.Cfg // met settings.yml
105 130 ln, err := net.Listen("tcp", cfg.Listen)
106 131 if err != nil {
107 132 return err
@@ -130,6 +155,9 @@ func newClient(cfgPath string) (*client, error) {
130 155 if err != nil {
131 156 return nil, err
132 157 }
158 if set, err := config.LoadSettings(cfg.DataDir); err == nil {
159 _ = cfg.Apply(set)
160 }
133 161 tok, err := server.ReadAdminToken(cfg.DataDir)
134 162 if err != nil {
135 163 return nil, fmt.Errorf("admin.token lezen (draai als de gebruiker van de dienst of root): %w", err)
@@ -162,6 +190,90 @@ func (c *client) do(method, p string, in any) (int, []byte, error) {
162 190 return resp.StatusCode, b, nil
163 191 }
164 192
193 func printResult(code int, b []byte) error {
194 var pretty bytes.Buffer
195 if json.Indent(&pretty, b, "", " ") == nil {
196 b = pretty.Bytes()
197 }
198 fmt.Println(strings.TrimSpace(string(b)))
199 if code >= 300 {
200 return fmt.Errorf("HTTP %d", code)
201 }
202 return nil
203 }
204
205 func setConfig(args []string) error {
206 fs := flag.NewFlagSet("set", flag.ExitOnError)
207 cfgPath := fs.String("config", "", "pad naar config.yml")
208 _ = fs.Parse(args)
209 set := map[string]string{}
210 for _, kv := range fs.Args() {
211 k, v, ok := strings.Cut(kv, "=")
212 if !ok {
213 return fmt.Errorf("verwacht sleutel=waarde, kreeg %q", kv)
214 }
215 set[k] = v
216 }
217 if len(set) == 0 {
218 return fmt.Errorf("geef minstens één sleutel=waarde")
219 }
220 c, err := newClient(*cfgPath)
221 if err != nil {
222 return err
223 }
224 code, b, err := c.do(http.MethodPut, "/api/v1/admin/config", set)
225 if err != nil {
226 return err
227 }
228 return printResult(code, b)
229 }
230
231 func withName(args []string, f func(c *client, name string) (int, []byte, error)) error {
232 fs := flag.NewFlagSet("cmd", flag.ExitOnError)
233 cfgPath := fs.String("config", "", "pad naar config.yml")
234 _ = fs.Parse(args)
235 if fs.NArg() != 1 {
236 return fmt.Errorf("geef precies één archiefnaam")
237 }
238 c, err := newClient(*cfgPath)
239 if err != nil {
240 return err
241 }
242 code, b, err := f(c, fs.Arg(0))
243 if err != nil {
244 return err
245 }
246 return printResult(code, b)
247 }
248
249 func rollback(args []string, stdin io.Reader, stdout io.Writer) error {
250 return withName(args, func(c *client, name string) (int, []byte, error) {
251 fmt.Fprintln(stdout, "LET OP: een rollback vervangt alle gegevens van BlueGit door dit archief en kan niet ongedaan worden gemaakt.")
252 fmt.Fprint(stdout, "Typ de archiefnaam over om door te gaan: ")
253 line, _ := bufio.NewReader(stdin).ReadString('\n')
254 if strings.TrimSpace(line) != name {
255 return 0, nil, fmt.Errorf("afgebroken; er is niets veranderd")
256 }
257 return c.do(http.MethodPost, "/api/v1/admin/rollback", map[string]string{"archive": name, "confirm": name})
258 })
259 }
260
261 func printToken(args []string) error {
262 fs := flag.NewFlagSet("token", flag.ExitOnError)
263 cfgPath := fs.String("config", "", "pad naar config.yml")
264 _ = fs.Parse(args)
265 cfg, err := config.Load(configPath(*cfgPath))
266 if err != nil {
267 return err
268 }
269 tok, err := server.ReadAdminToken(cfg.DataDir)
270 if err != nil {
271 return fmt.Errorf("admin.token niet leesbaar (start de server eerst, en draai als de gebruiker bluegit-backup): %w", err)
272 }
273 fmt.Println(tok)
274 return nil
275 }
276
165 277 func simple(args []string, method, p string) error {
166 278 fs := flag.NewFlagSet("cmd", flag.ExitOnError)
167 279 cfgPath := fs.String("config", "", "pad naar config.yml")
@@ -12,6 +12,7 @@ import (
12 "log/slog"
12 "log/slog"
13 "net"
13 "net"
14 "net/http"
14 "net/http"
15 "net/url"
15 "os"
16 "os"
16 "os/signal"
17 "os/signal"
17 "strings"
18 "strings"
@@ -32,6 +33,13 @@ func usage() {
32 bluegit-backup archive [--config …] nu een archief maken
33 bluegit-backup archive [--config …] nu een archief maken
33 bluegit-backup sync [--config …] nu synchroniseren
34 bluegit-backup sync [--config …] nu synchroniseren
34 bluegit-backup prune [--config …] bewaarregels nu toepassen
35 bluegit-backup prune [--config …] bewaarregels nu toepassen
36 bluegit-backup config [--config …] instellingen tonen
37 bluegit-backup set [--config …] sleutel=waarde … instellingen wijzigen
38 bluegit-backup delete [--config …] ARCHIEF
39 bluegit-backup rollback [--config …] ARCHIEF (vraagt om de naam over te typen)
40 bluegit-backup disconnect [--config …]
41 bluegit-backup actions [--config …] alle API-acties
42 bluegit-backup token [--config …] het beheertoken voor de webinterface
35 bluegit-backup example-config
43 bluegit-backup example-config
36 bluegit-backup version
44 bluegit-backup version
37
45
@@ -60,6 +68,22 @@ func main() {
60 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/sync")
68 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/sync")
61 case "prune":
69 case "prune":
62 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/prune")
70 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/prune")
71 case "config":
72 err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/config")
73 case "set":
74 err = setConfig(os.Args[2:])
75 case "disconnect":
76 err = simple(os.Args[2:], http.MethodPost, "/api/v1/admin/disconnect")
77 case "delete":
78 err = withName(os.Args[2:], func(c *client, name string) (int, []byte, error) {
79 return c.do(http.MethodDelete, "/api/v1/admin/archives/"+url.PathEscape(name), nil)
80 })
81 case "rollback":
82 err = rollback(os.Args[2:], os.Stdin, os.Stdout)
83 case "actions":
84 err = simple(os.Args[2:], http.MethodGet, "/api/v1/admin/actions")
85 case "token":
86 err = printToken(os.Args[2:])
63 case "example-config":
87 case "example-config":
64 fmt.Print(config.Example())
88 fmt.Print(config.Example())
65 case "version":
89 case "version":
@@ -102,6 +126,7 @@ func serve(args []string) error {
102 }
126 }
103 ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
127 ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
104 defer stop()
128 defer stop()
129 cfg = srv.Cfg // met settings.yml
105 ln, err := net.Listen("tcp", cfg.Listen)
130 ln, err := net.Listen("tcp", cfg.Listen)
106 if err != nil {
131 if err != nil {
107 return err
132 return err
@@ -130,6 +155,9 @@ func newClient(cfgPath string) (*client, error) {
130 if err != nil {
155 if err != nil {
131 return nil, err
156 return nil, err
132 }
157 }
158 if set, err := config.LoadSettings(cfg.DataDir); err == nil {
159 _ = cfg.Apply(set)
160 }
133 tok, err := server.ReadAdminToken(cfg.DataDir)
161 tok, err := server.ReadAdminToken(cfg.DataDir)
134 if err != nil {
162 if err != nil {
135 return nil, fmt.Errorf("admin.token lezen (draai als de gebruiker van de dienst of root): %w", err)
163 return nil, fmt.Errorf("admin.token lezen (draai als de gebruiker van de dienst of root): %w", err)
@@ -162,6 +190,90 @@ func (c *client) do(method, p string, in any) (int, []byte, error) {
162 return resp.StatusCode, b, nil
190 return resp.StatusCode, b, nil
163}
191}
164
192
193func printResult(code int, b []byte) error {
194 var pretty bytes.Buffer
195 if json.Indent(&pretty, b, "", " ") == nil {
196 b = pretty.Bytes()
197 }
198 fmt.Println(strings.TrimSpace(string(b)))
199 if code >= 300 {
200 return fmt.Errorf("HTTP %d", code)
201 }
202 return nil
203}
204
205func setConfig(args []string) error {
206 fs := flag.NewFlagSet("set", flag.ExitOnError)
207 cfgPath := fs.String("config", "", "pad naar config.yml")
208 _ = fs.Parse(args)
209 set := map[string]string{}
210 for _, kv := range fs.Args() {
211 k, v, ok := strings.Cut(kv, "=")
212 if !ok {
213 return fmt.Errorf("verwacht sleutel=waarde, kreeg %q", kv)
214 }
215 set[k] = v
216 }
217 if len(set) == 0 {
218 return fmt.Errorf("geef minstens één sleutel=waarde")
219 }
220 c, err := newClient(*cfgPath)
221 if err != nil {
222 return err
223 }
224 code, b, err := c.do(http.MethodPut, "/api/v1/admin/config", set)
225 if err != nil {
226 return err
227 }
228 return printResult(code, b)
229}
230
231func withName(args []string, f func(c *client, name string) (int, []byte, error)) error {
232 fs := flag.NewFlagSet("cmd", flag.ExitOnError)
233 cfgPath := fs.String("config", "", "pad naar config.yml")
234 _ = fs.Parse(args)
235 if fs.NArg() != 1 {
236 return fmt.Errorf("geef precies één archiefnaam")
237 }
238 c, err := newClient(*cfgPath)
239 if err != nil {
240 return err
241 }
242 code, b, err := f(c, fs.Arg(0))
243 if err != nil {
244 return err
245 }
246 return printResult(code, b)
247}
248
249func rollback(args []string, stdin io.Reader, stdout io.Writer) error {
250 return withName(args, func(c *client, name string) (int, []byte, error) {
251 fmt.Fprintln(stdout, "LET OP: een rollback vervangt alle gegevens van BlueGit door dit archief en kan niet ongedaan worden gemaakt.")
252 fmt.Fprint(stdout, "Typ de archiefnaam over om door te gaan: ")
253 line, _ := bufio.NewReader(stdin).ReadString('\n')
254 if strings.TrimSpace(line) != name {
255 return 0, nil, fmt.Errorf("afgebroken; er is niets veranderd")
256 }
257 return c.do(http.MethodPost, "/api/v1/admin/rollback", map[string]string{"archive": name, "confirm": name})
258 })
259}
260
261func printToken(args []string) error {
262 fs := flag.NewFlagSet("token", flag.ExitOnError)
263 cfgPath := fs.String("config", "", "pad naar config.yml")
264 _ = fs.Parse(args)
265 cfg, err := config.Load(configPath(*cfgPath))
266 if err != nil {
267 return err
268 }
269 tok, err := server.ReadAdminToken(cfg.DataDir)
270 if err != nil {
271 return fmt.Errorf("admin.token niet leesbaar (start de server eerst, en draai als de gebruiker bluegit-backup): %w", err)
272 }
273 fmt.Println(tok)
274 return nil
275}
276
165func simple(args []string, method, p string) error {
277func simple(args []string, method, p string) error {
166 fs := flag.NewFlagSet("cmd", flag.ExitOnError)
278 fs := flag.NewFlagSet("cmd", flag.ExitOnError)
167 cfgPath := fs.String("config", "", "pad naar config.yml")
279 cfgPath := fs.String("config", "", "pad naar config.yml")
docs/ASSUMPTIONS.md +37 −8
@@ -5,18 +5,47 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
5 5 ## Opzet
6 6
7 7 - **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.
8 - **Geen webinterface op de backup server.** Je bedient hem met een configbestand en de CLI. Archieven bekijken en een rollback starten gebeurt in BlueGit, zoals gevraagd.
9 - De CLI praat met de draaiende server via `data_dir/admin.token` (een `bba_…`-token, 0600). Er komt geen tweede inlogsysteem.
10 8 - Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.
11 9
10 ## Webinterface en API
11
12 - De webinterface draait op hetzelfde adres als de API, standaard `0.0.0.0:8080`. Er komt geen aparte poort voor BlueGit: BlueGit praat met dezelfde server (ondertekend).
13 - **Inloggen gaat met het beheertoken** uit `data_dir/admin.token` (`bba_…`, 0600). Dat token gebruiken ook de API en de CLI. Er komt geen apart gebruikersbeheer: de backup server heeft één beheerder. `bluegit-backup token` toont het token.
14 - Sessies staan alleen in het geheugen. Een herstart logt iedereen uit.
15 - Elke handeling staat in één lijst (`Actions`). De API-routes en de formulieren van de webinterface komen allebei uit die lijst, en een formulier roept dezelfde code aan als de API. Daardoor kan de API alles wat de webinterface kan, en andersom. Een unit-test controleert dat elke wijzigende actie een formulier heeft en elk formulier een actie. De integratietests falen als er een actie bij komt die niet getest wordt.
16 - "Alles instellen" betekent: alle velden uit `config.yml` behalve `data_dir`. In die map staan de instellingen zelf, dus die blijft in `config.yml`. Wat via de webinterface, API of BlueGit is ingesteld, gaat naar `data_dir/settings.yml`. Dat bestand gaat boven `config.yml`, zodat `config.yml` van root kan blijven. `listen` geldt pas na een herstart, de rest meteen (ook de downloadsnelheid tijdens een lopende sync).
17 - In de webinterface kun je ook een rollback starten en een archief downloaden of verwijderen. De rollback heeft dezelfde waarschuwing en bevestiging als in BlueGit.
18 - De webinterface is gewone HTML zonder JavaScript, in het Nederlands. Hij weigert framing (`X-Frame-Options: DENY`). Daarom bedient BlueGit de backup server via de API en niet met een iframe.
19
20 ## Bediening vanuit BlueGit
21
22 - Tim gaf de keuze tussen een iframe of een API-koppeling met een vergelijkbare interface. Ik koos de **API-koppeling**:
23 - Een iframe zou een tweede login vragen.
24 - Het werkt niet als de backup server alleen voor BlueGit bereikbaar is en niet voor de browser.
25 - Het opent de deur voor clickjacking.
26 - BlueGit vraagt de lijst met acties op (`GET /api/v1/admin/actions`) en stuurt een gekozen actie ondertekend door. Een nieuwe actie in de backup server werkt daardoor in BlueGit zonder BlueGit aan te passen, zolang hij voor BlueGit is opengezet.
27 - **Niet** vanuit BlueGit:
28 - **koppelen**: dat vraagt de key op de backup server zelf.
29 - **een archief downloaden**: een archief van gigabytes hoort niet door BlueGit heen te lopen.
30 - De instellingen in BlueGit tonen de labels en uitleg van de backup server, dus in het Nederlands. Wat BlueGit er zelf omheen zet, is vertaald (en, nl, de, fr).
31 - Verwijdert een beheerder een backup server in BlueGit, dan vraagt BlueGit de backup server eerst om te ontkoppelen. De kopie en de archieven blijven op de backup server staan.
32
33 ## Meerdere backup servers
34
35 - Eén BlueGit kan tot **16** backup servers hebben, elk met een eigen naam en key. Dat zijn er genoeg voor een paar plekken (bijvoorbeeld thuis en offsite), en het begrenst het aantal meldingen per wijziging.
36 - Elke backup server krijgt elke melding, parallel. Een server die niet reageert, houdt de andere niet op.
37 - Een rollback kan vanaf elke gekoppelde backup server. De andere servers zien de teruggezette stand bij hun volgende sync.
38 - Koppelt een tweede backup server met dezelfde key, dan gaat de koppeling (het adres voor meldingen) naar die server. Een key hoort bij één server. Geef een nieuwe server een eigen key.
39 - `backup.json` bevat nu een lijst met servers. De oude vorm met één koppeling wordt bij het lezen omgezet.
40
12 41 ## Key en authenticatie
13 42
14 - BlueGit maakt de Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
15 - Er is maar één key tegelijk. Een nieuwe key maken maakt de oude ongeldig. Verwijderen ontkoppelt de server.
43 - BlueGit maakt per backup server een Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
44 - Een nieuwe key voor een server maakt zijn oude key ongeldig. Verwijderen ontkoppelt die server.
16 45 - **Backup server → BlueGit:** `Authorization: Bearer bgbk_…` op `/api/v1/backup/*`. Vijf foute pogingen per minuut per IP-adres geven `429`.
17 - **BlueGit → backup server:** BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen.
46 - **BlueGit → backup server** (meldingen, archieflijst, status, rollback en de beheeracties): BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen. Binnen die 5 minuten kan een afgeluisterd verzoek wel opnieuw worden gestuurd. Gebruik TLS als het netwerk tussen BlueGit en de backup server niet te vertrouwen is.
18 47 - De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.
19 - Je koppelt met `bluegit-backup connect --url … ` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
48 - Je koppelt in de webinterface, met de API, of met `bluegit-backup connect --url …` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
20 49
21 50 ## Wat wordt geback-upt
22 51
@@ -89,7 +118,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
89 118 - een self-update van een geïnstalleerde server vanuit de pipeline (via een systemd-unit, net als BlueGit)
90 119 - binaries bij een tag
91 120 - Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit uit `timfa/bluegit` en draait alle featuretests. Faalt er één, dan komt er geen release.
92 - **Releases vanaf master staan pas aan zodra `.release-enabled` in de repository staat.** Tim beslist wanneer, en zet ook de geheimen (AUR-sleutel, update-token). Tags zet Tim zelf.
93 - De integratietests bouwen BlueGit van de ref in `.bluegit-ref`. Tot de BlueGit-kant gemerged is, is dat `feature/backup-server`. Daarna wordt het `master`.
121 - Releases vanaf master staan aan zodra `.release-enabled` in de repository staat. Zonder dat bestand doen de release-scripts niets.
122 - De integratietests bouwen BlueGit van de ref in `.bluegit-ref` (`master` zodra de BlueGit-kant gemerged is).
94 123 - De integratietests draaien nooit tegen een echte BlueGit-installatie. Elke test start een eigen BlueGit in een tijdelijke map, met de dev-login en zonder SSH of CI-runner.
95 124 - Het AUR-pakket haalt de broncode van `https://git.timfalken.com/timfa/bluegit-backup/-/archive/<commit>/…`. Daarom is de repository openbaar, net als `timfa/bluegit`.
@@ -5,18 +5,47 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
5## Opzet
5## Opzet
6
6
7- **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.
7- **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.
8- **Geen webinterface op de backup server.** Je bedient hem met een configbestand en de CLI. Archieven bekijken en een rollback starten gebeurt in BlueGit, zoals gevraagd.
9- De CLI praat met de draaiende server via `data_dir/admin.token` (een `bba_…`-token, 0600). Er komt geen tweede inlogsysteem.
10- Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.
8- Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.
11
9
10## Webinterface en API
11
12- De webinterface draait op hetzelfde adres als de API, standaard `0.0.0.0:8080`. Er komt geen aparte poort voor BlueGit: BlueGit praat met dezelfde server (ondertekend).
13- **Inloggen gaat met het beheertoken** uit `data_dir/admin.token` (`bba_…`, 0600). Dat token gebruiken ook de API en de CLI. Er komt geen apart gebruikersbeheer: de backup server heeft één beheerder. `bluegit-backup token` toont het token.
14- Sessies staan alleen in het geheugen. Een herstart logt iedereen uit.
15- Elke handeling staat in één lijst (`Actions`). De API-routes en de formulieren van de webinterface komen allebei uit die lijst, en een formulier roept dezelfde code aan als de API. Daardoor kan de API alles wat de webinterface kan, en andersom. Een unit-test controleert dat elke wijzigende actie een formulier heeft en elk formulier een actie. De integratietests falen als er een actie bij komt die niet getest wordt.
16- "Alles instellen" betekent: alle velden uit `config.yml` behalve `data_dir`. In die map staan de instellingen zelf, dus die blijft in `config.yml`. Wat via de webinterface, API of BlueGit is ingesteld, gaat naar `data_dir/settings.yml`. Dat bestand gaat boven `config.yml`, zodat `config.yml` van root kan blijven. `listen` geldt pas na een herstart, de rest meteen (ook de downloadsnelheid tijdens een lopende sync).
17- In de webinterface kun je ook een rollback starten en een archief downloaden of verwijderen. De rollback heeft dezelfde waarschuwing en bevestiging als in BlueGit.
18- De webinterface is gewone HTML zonder JavaScript, in het Nederlands. Hij weigert framing (`X-Frame-Options: DENY`). Daarom bedient BlueGit de backup server via de API en niet met een iframe.
19
20## Bediening vanuit BlueGit
21
22- Tim gaf de keuze tussen een iframe of een API-koppeling met een vergelijkbare interface. Ik koos de **API-koppeling**:
23 - Een iframe zou een tweede login vragen.
24 - Het werkt niet als de backup server alleen voor BlueGit bereikbaar is en niet voor de browser.
25 - Het opent de deur voor clickjacking.
26- BlueGit vraagt de lijst met acties op (`GET /api/v1/admin/actions`) en stuurt een gekozen actie ondertekend door. Een nieuwe actie in de backup server werkt daardoor in BlueGit zonder BlueGit aan te passen, zolang hij voor BlueGit is opengezet.
27- **Niet** vanuit BlueGit:
28 - **koppelen**: dat vraagt de key op de backup server zelf.
29 - **een archief downloaden**: een archief van gigabytes hoort niet door BlueGit heen te lopen.
30- De instellingen in BlueGit tonen de labels en uitleg van de backup server, dus in het Nederlands. Wat BlueGit er zelf omheen zet, is vertaald (en, nl, de, fr).
31- Verwijdert een beheerder een backup server in BlueGit, dan vraagt BlueGit de backup server eerst om te ontkoppelen. De kopie en de archieven blijven op de backup server staan.
32
33## Meerdere backup servers
34
35- Eén BlueGit kan tot **16** backup servers hebben, elk met een eigen naam en key. Dat zijn er genoeg voor een paar plekken (bijvoorbeeld thuis en offsite), en het begrenst het aantal meldingen per wijziging.
36- Elke backup server krijgt elke melding, parallel. Een server die niet reageert, houdt de andere niet op.
37- Een rollback kan vanaf elke gekoppelde backup server. De andere servers zien de teruggezette stand bij hun volgende sync.
38- Koppelt een tweede backup server met dezelfde key, dan gaat de koppeling (het adres voor meldingen) naar die server. Een key hoort bij één server. Geef een nieuwe server een eigen key.
39- `backup.json` bevat nu een lijst met servers. De oude vorm met één koppeling wordt bij het lezen omgezet.
40
12## Key en authenticatie
41## Key en authenticatie
13
42
14- BlueGit maakt de Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
43- BlueGit maakt per backup server een Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
15- Er is maar één key tegelijk. Een nieuwe key maken maakt de oude ongeldig. Verwijderen ontkoppelt de server.
44- Een nieuwe key voor een server maakt zijn oude key ongeldig. Verwijderen ontkoppelt die server.
16- **Backup server → BlueGit:** `Authorization: Bearer bgbk_…` op `/api/v1/backup/*`. Vijf foute pogingen per minuut per IP-adres geven `429`.
45- **Backup server → BlueGit:** `Authorization: Bearer bgbk_…` op `/api/v1/backup/*`. Vijf foute pogingen per minuut per IP-adres geven `429`.
17- **BlueGit → backup server:** BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen.
46- **BlueGit → backup server** (meldingen, archieflijst, status, rollback en de beheeracties): BlueGit kent de key zelf niet meer, alleen de hash. Daarom ondertekent BlueGit met een afgeleid geheim, `sha256("bluegit-backup-sign:" + key)`, dat BlueGit bij het maken van de key bewaart. De handtekening is HMAC-SHA256 over `METHODE\nPAD\nTIJDSTEMPEL\nsha256(body)`, met hoogstens 5 minuten klokverschil. Zo kan iemand die het netwerk ziet geen rollback starten of meldingen vervalsen. Binnen die 5 minuten kan een afgeluisterd verzoek wel opnieuw worden gestuurd. Gebruik TLS als het netwerk tussen BlueGit en de backup server niet te vertrouwen is.
18- De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.
47- De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.
19- Je koppelt met `bluegit-backup connect --url … ` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
48- Je koppelt in de webinterface, met de API, of met `bluegit-backup connect --url …` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
20
49
21## Wat wordt geback-upt
50## Wat wordt geback-upt
22
51
@@ -89,7 +118,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
89 - een self-update van een geïnstalleerde server vanuit de pipeline (via een systemd-unit, net als BlueGit)
118 - een self-update van een geïnstalleerde server vanuit de pipeline (via een systemd-unit, net als BlueGit)
90 - binaries bij een tag
119 - binaries bij een tag
91- Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit uit `timfa/bluegit` en draait alle featuretests. Faalt er één, dan komt er geen release.
120- Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit uit `timfa/bluegit` en draait alle featuretests. Faalt er één, dan komt er geen release.
92- **Releases vanaf master staan pas aan zodra `.release-enabled` in de repository staat.** Tim beslist wanneer, en zet ook de geheimen (AUR-sleutel, update-token). Tags zet Tim zelf.
121- Releases vanaf master staan aan zodra `.release-enabled` in de repository staat. Zonder dat bestand doen de release-scripts niets.
93- De integratietests bouwen BlueGit van de ref in `.bluegit-ref`. Tot de BlueGit-kant gemerged is, is dat `feature/backup-server`. Daarna wordt het `master`.
122- De integratietests bouwen BlueGit van de ref in `.bluegit-ref` (`master` zodra de BlueGit-kant gemerged is).
94- De integratietests draaien nooit tegen een echte BlueGit-installatie. Elke test start een eigen BlueGit in een tijdelijke map, met de dev-login en zonder SSH of CI-runner.
123- De integratietests draaien nooit tegen een echte BlueGit-installatie. Elke test start een eigen BlueGit in een tijdelijke map, met de dev-login en zonder SSH of CI-runner.
95- Het AUR-pakket haalt de broncode van `https://git.timfalken.com/timfa/bluegit-backup/-/archive/<commit>/…`. Daarom is de repository openbaar, net als `timfa/bluegit`.
124- Het AUR-pakket haalt de broncode van `https://git.timfalken.com/timfa/bluegit-backup/-/archive/<commit>/…`. Daarom is de repository openbaar, net als `timfa/bluegit`.
docs/BACKUP-PROTOCOL.md +25 −12
@@ -1,23 +1,35 @@
1 # Backup server (bluegit-backup)
1 # Backup servers (bluegit-backup)
2 2
3 3 Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
4 4
5 Eén BlueGit kan meerdere backup servers hebben (hoogstens 16), elk met een eigen Backupserver-Key. Een backup server hoort bij één BlueGit.
6
5 7 ## In BlueGit
6 8
7 **Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders):
9 **Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders) toont de lijst met backup servers: naam, gekoppeld of wachtend op de key, adres en laatste contact. **Backup server toevoegen** maakt een nieuwe server met een eigen key, die één keer wordt getoond.
10
11 Per backup server (`/admin/backup/s/<id>`) staat dezelfde bediening als in de webinterface van de backup server zelf:
8 12
9 - **Backupserver-Key** maken (één keer getoond), vervangen of intrekken. Er is altijd hoogstens één key; een nieuwe key maakt de oude ongeldig en vergeet de gekoppelde server.
10 - **Gekoppelde backup server**: adres, laatste contact, archiefinterval en bewaartermijn.
11 - **Backup-archieven** als lijst, met per archief een rollback. Die staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.
13 - **Status**: laatste sync en het resultaat ervan, aantal syncs en meldingen, grootte van de kopie, archieven, de laatste rollback en de versie. Met de knoppen *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.
14 - **Instellingen** van de backup server: archiefinterval, bewaartermijn, minimale vrije ruimte, downloadsnelheid, syncintervallen, publiek adres en luisteradres. BlueGit krijgt de velden van de backup server en toont ze zoals ze daar staan.
15 - **Backup-archieven** met *Verwijderen* en *Rollback*. Een rollback staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.
16 - **Backupserver-Key** vervangen (de oude key werkt meteen niet meer; de server moet opnieuw koppelen), de server hernoemen, of key intrekken en de server verwijderen. Bij verwijderen vraagt BlueGit de backup server eerst om te ontkoppelen. De archieven blijven op de backup server staan.
17
18 BlueGit kent de acties niet vooraf. Het vraagt ze op bij de backup server (`GET /api/v1/admin/actions`) en stuurt ze ondertekend door. Alles wat de backup server voor BlueGit openzet, kan dus ook hier. Koppelen en een archief downloaden kan alleen op de backup server zelf.
12 19
13 20 Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):
14 21
15 22 | | |
16 23 |---|---|
17 | `GET /api/v1/admin/backup` | status, gekoppelde server, archieven |
18 | `POST /api/v1/admin/backup/key` | nieuwe key, `{"key": "bgbk_…"}` (eenmalig) |
19 | `DELETE /api/v1/admin/backup/key` | key intrekken |
20 | `POST /api/v1/admin/backup/rollback` | `{"archive": "naam", "confirm": "naam"}` |
24 | `GET /api/v1/admin/backup` | `instance_id` en de lijst met backup servers |
25 | `POST /api/v1/admin/backup/servers` | `{"name"}`: nieuwe backup server; het antwoord bevat eenmalig `key` |
26 | `GET /api/v1/admin/backup/servers/{id}` | server met `remote` (status), `archives` en `config`, zoals de backup server ze meldt |
27 | `PUT /api/v1/admin/backup/servers/{id}` | `{"name"}`: hernoemen |
28 | `POST /api/v1/admin/backup/servers/{id}/key` | nieuwe key (eenmalig in het antwoord) |
29 | `DELETE /api/v1/admin/backup/servers/{id}` | ontkoppelen en vergeten |
30 | `POST /api/v1/admin/backup/servers/{id}/actions/{name}` | actie van de backup server, bijvoorbeeld `config.update` met `{"retention_days": "14"}`, `sync`, `archive`, `prune`, `archive.delete` met `{"name"}`, of `rollback` met `{"archive": "naam", "confirm": "naam"}` |
31
32 Het antwoord van een actie is het antwoord van de backup server, met dezelfde statuscode.
21 33
22 34 ## Protocol
23 35
@@ -25,7 +37,7 @@ Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):
25 37
26 38 | | |
27 39 |---|---|
28 | `GET /api/v1/backup/info` | `instance_id`, `base_url`, gekoppelde server |
40 | `GET /api/v1/backup/info` | `instance_id`, `base_url`, naam en adres van de server bij deze key |
29 41 | `POST /api/v1/backup/connect` | `{"server_url", "server_id"}`: waar BlueGit meldingen heen stuurt |
30 42 | `GET /api/v1/backup/manifest` | alle bestanden: pad, grootte, mtime, mode; de database ook met sha256 |
31 43 | `GET /api/v1/backup/file?path=…` | één bestand |
@@ -47,8 +59,9 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha256
47 59 | `GET /api/v1/archives` | `{"archives": [{name, created_at, size}]}` |
48 60 | `GET /api/v1/status` | interval, bewaartermijn, stand van de laatste rollback |
49 61 | `POST /api/v1/rollback` | `{"archive": "naam"}` |
62 | `* /api/v1/admin/…` | de beheeracties van de backup server (lijst: `GET /api/v1/admin/actions`, veld `bluegit: true`) |
50 63
51 **Meldingen.** 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.
52 65
53 66 ## Wat er in een backup zit
54 67
@@ -62,7 +75,7 @@ data/releases/… release-assets (zonder .incoming)
62 75 data/artifacts/… CI-artifacts
63 76 ```
64 77
65 Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppeling staat in `<state>/backup.json` (0600, alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.
78 Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppelingen staan in `<state>/backup.json` (0600, per server alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.
66 79
67 80 ## Terugzetten
68 81
@@ -1,23 +1,35 @@
1# Backup server (bluegit-backup)
1# Backup servers (bluegit-backup)
2
2
3Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
3Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
4
4
5Eén BlueGit kan meerdere backup servers hebben (hoogstens 16), elk met een eigen Backupserver-Key. Een backup server hoort bij één BlueGit.
6
5## In BlueGit
7## In BlueGit
6
8
7**Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders):
9**Beheer > Backup** (`/admin/backup`, alleen installatiebeheerders) toont de lijst met backup servers: naam, gekoppeld of wachtend op de key, adres en laatste contact. **Backup server toevoegen** maakt een nieuwe server met een eigen key, die één keer wordt getoond.
10
11Per backup server (`/admin/backup/s/<id>`) staat dezelfde bediening als in de webinterface van de backup server zelf:
8
12
9- **Backupserver-Key** maken (één keer getoond), vervangen of intrekken. Er is altijd hoogstens één key; een nieuwe key maakt de oude ongeldig en vergeet de gekoppelde server.
13- **Status**: laatste sync en het resultaat ervan, aantal syncs en meldingen, grootte van de kopie, archieven, de laatste rollback en de versie. Met de knoppen *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.
10- **Gekoppelde backup server**: adres, laatste contact, archiefinterval en bewaartermijn.
14- **Instellingen** van de backup server: archiefinterval, bewaartermijn, minimale vrije ruimte, downloadsnelheid, syncintervallen, publiek adres en luisteradres. BlueGit krijgt de velden van de backup server en toont ze zoals ze daar staan.
11- **Backup-archieven** als lijst, met per archief een rollback. Die staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.
15- **Backup-archieven** met *Verwijderen* en *Rollback*. Een rollback staat achter een grote rode waarschuwing, een vinkje ("ik begrijp dat dit niet terug te draaien is"), het intypen van de archiefnaam en een bevestigingsdialoog.
16- **Backupserver-Key** vervangen (de oude key werkt meteen niet meer; de server moet opnieuw koppelen), de server hernoemen, of key intrekken en de server verwijderen. Bij verwijderen vraagt BlueGit de backup server eerst om te ontkoppelen. De archieven blijven op de backup server staan.
17
18BlueGit kent de acties niet vooraf. Het vraagt ze op bij de backup server (`GET /api/v1/admin/actions`) en stuurt ze ondertekend door. Alles wat de backup server voor BlueGit openzet, kan dus ook hier. Koppelen en een archief downloaden kan alleen op de backup server zelf.
12
19
13Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):
20Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):
14
21
15| | |
22| | |
16|---|---|
23|---|---|
17| `GET /api/v1/admin/backup` | status, gekoppelde server, archieven |
24| `GET /api/v1/admin/backup` | `instance_id` en de lijst met backup servers |
18| `POST /api/v1/admin/backup/key` | nieuwe key, `{"key": "bgbk_…"}` (eenmalig) |
25| `POST /api/v1/admin/backup/servers` | `{"name"}`: nieuwe backup server; het antwoord bevat eenmalig `key` |
19| `DELETE /api/v1/admin/backup/key` | key intrekken |
26| `GET /api/v1/admin/backup/servers/{id}` | server met `remote` (status), `archives` en `config`, zoals de backup server ze meldt |
20| `POST /api/v1/admin/backup/rollback` | `{"archive": "naam", "confirm": "naam"}` |
27| `PUT /api/v1/admin/backup/servers/{id}` | `{"name"}`: hernoemen |
28| `POST /api/v1/admin/backup/servers/{id}/key` | nieuwe key (eenmalig in het antwoord) |
29| `DELETE /api/v1/admin/backup/servers/{id}` | ontkoppelen en vergeten |
30| `POST /api/v1/admin/backup/servers/{id}/actions/{name}` | actie van de backup server, bijvoorbeeld `config.update` met `{"retention_days": "14"}`, `sync`, `archive`, `prune`, `archive.delete` met `{"name"}`, of `rollback` met `{"archive": "naam", "confirm": "naam"}` |
31
32Het antwoord van een actie is het antwoord van de backup server, met dezelfde statuscode.
21
33
22## Protocol
34## Protocol
23
35
@@ -25,7 +37,7 @@ Dezelfde acties via de API (token van een beheerder, scope `api`/`admin`):
25
37
26| | |
38| | |
27|---|---|
39|---|---|
28| `GET /api/v1/backup/info` | `instance_id`, `base_url`, gekoppelde server |
40| `GET /api/v1/backup/info` | `instance_id`, `base_url`, naam en adres van de server bij deze key |
29| `POST /api/v1/backup/connect` | `{"server_url", "server_id"}`: waar BlueGit meldingen heen stuurt |
41| `POST /api/v1/backup/connect` | `{"server_url", "server_id"}`: waar BlueGit meldingen heen stuurt |
30| `GET /api/v1/backup/manifest` | alle bestanden: pad, grootte, mtime, mode; de database ook met sha256 |
42| `GET /api/v1/backup/manifest` | alle bestanden: pad, grootte, mtime, mode; de database ook met sha256 |
31| `GET /api/v1/backup/file?path=…` | één bestand |
43| `GET /api/v1/backup/file?path=…` | één bestand |
@@ -47,8 +59,9 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha256
47| `GET /api/v1/archives` | `{"archives": [{name, created_at, size}]}` |
59| `GET /api/v1/archives` | `{"archives": [{name, created_at, size}]}` |
48| `GET /api/v1/status` | interval, bewaartermijn, stand van de laatste rollback |
60| `GET /api/v1/status` | interval, bewaartermijn, stand van de laatste rollback |
49| `POST /api/v1/rollback` | `{"archive": "naam"}` |
61| `POST /api/v1/rollback` | `{"archive": "naam"}` |
62| `* /api/v1/admin/…` | de beheeracties van de backup server (lijst: `GET /api/v1/admin/actions`, veld `bluegit: true`) |
50
63
51**Meldingen.** 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.
52
65
53## Wat er in een backup zit
66## Wat er in een backup zit
54
67
@@ -62,7 +75,7 @@ data/releases/… release-assets (zonder .incoming)
62data/artifacts/… CI-artifacts
75data/artifacts/… CI-artifacts
63```
76```
64
77
65Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppeling staat in `<state>/backup.json` (0600, alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.
78Niet mee: `config.yml`, `storage_path`, `cache.json`, `backup.json` en `instance_id` (horen bij deze installatie), `data/work`, `*.lock` en symlinks. De koppelingen staan in `<state>/backup.json` (0600, per server alleen de hash van de key) en niet in de database, zodat een rollback naar een oud archief de koppeling niet terugdraait.
66
79
67## Terugzetten
80## Terugzetten
68
81
docs/BACKUP-SERVER.md +63 −15
@@ -8,7 +8,9 @@ Een losse backup server voor één [BlueGit](https://git.timfalken.com/timfa/blu
8 8 - Elk `archive_interval` (standaard dagelijks) gaat de hele kopie gecomprimeerd in een archief (`tar.gz`).
9 9 - Archieven ouder dan `retention_days` gaan weg. Is de schijf vol (minder dan `min_free_mb` vrij), dan gaat het oudste archief weg. Het nieuwste archief blijft altijd staan.
10 10 - In BlueGit ziet de beheerder de archieven en kan hij een **rollback** starten, met een grote waarschuwing dat die niet terug te draaien is. De backup server pakt het archief uit, vervangt zijn kopie en stuurt alles naar BlueGit. BlueGit zet de data terug en herstart.
11 - Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata.
11 - Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata. Eén BlueGit kan wel meerdere backup servers hebben, elk met een eigen key.
12 - Een **webinterface** (standaard op poort 8080) waarin alles in te stellen en te bedienen is, en een **API** die precies hetzelfde kan. Beide lopen via één lijst met acties (`GET /api/v1/admin/actions`).
13 - Vanuit **BlueGit** (*Beheer → Backup → server*) is de backup server ook te bedienen: status, instellingen, sync, archiveren, opruimen, archieven verwijderen en rollback. BlueGit vraagt de acties op bij de backup server en stuurt ze ondertekend door.
12 14
13 15 Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md). De aannames staan in [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md).
14 16
@@ -36,8 +38,8 @@ go build -o bluegit-backup ./cmd/bluegit-backup
36 38
37 39 1. Zet in `config.yml` `public_url` op het adres waarop BlueGit deze server bereikt.
38 40 2. Start de server: `systemctl enable --now bluegit-backup`.
39 3. Maak in BlueGit onder *Beheer → Backup* een Backupserver-Key. Die wordt één keer getoond.
40 4. Koppel:
41 3. Voeg in BlueGit onder *Beheer → Backup* een backup server toe. De Backupserver-Key wordt één keer getoond.
42 4. Koppel in de webinterface (`http://<server>:8080`, sectie *Koppeling*), of met de CLI:
41 43
42 44 ```sh
43 45 BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com
@@ -54,27 +56,66 @@ go build -o bluegit-backup ./cmd/bluegit-backup
54 56
55 57 Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.
56 58
57 ## Bedienen
59 ## Webinterface
60
61 Open `http://<server>:8080` en log in met het beheertoken uit `data_dir/admin.token`:
58 62
59 63 ```sh
60 bluegit-backup status # koppeling, laatste sync, laatste archief
61 bluegit-backup list # archieven
62 bluegit-backup sync # nu synchroniseren
63 bluegit-backup archive # nu een archief maken
64 bluegit-backup prune # bewaarregels nu toepassen
64 sudo -u bluegit-backup bluegit-backup token
65 65 ```
66 66
67 Deze commando's praten met de draaiende server via `data_dir/admin.token` en moeten dus draaien als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).
67 Daar staan:
68
69 - **Overzicht**: koppeling, laatste sync, kopie, archieven en de laatste rollback, met *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.
70 - **Koppeling**: koppelen (met de keuze wissen of herstellen bij een andere BlueGit) en ontkoppelen.
71 - **Instellingen**: elk veld uit de tabel hieronder. Ze gaan naar `data_dir/settings.yml`, dat boven `config.yml` gaat. `listen` geldt pas na een herstart, de rest meteen.
72 - **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
73 - **API**: de lijst met alle acties.
74
75 De sessie is een HttpOnly-cookie (SameSite=Strict, 12 uur), elk formulier heeft een CSRF-token, en vijf foute logins per minuut per IP-adres geven `429`. De interface mag niet in een frame van een andere site. Gebruik een TLS-proxy als de server buiten je eigen netwerk bereikbaar is.
76
77 ## API
78
79 Elke actie uit de webinterface is ook een API-aanroep, met `Authorization: Bearer <admin.token>`:
80
81 | Methode | Pad | Actie | BlueGit |
82 |---|---|---|---|
83 | GET | `/api/v1/admin/status` | Status | ✓ |
84 | GET | `/api/v1/admin/actions` | Alle acties | ✓ |
85 | GET | `/api/v1/admin/config` | Instellingen met uitleg | ✓ |
86 | PUT | `/api/v1/admin/config` | Instellingen wijzigen, bv. `{"retention_days": 14}` | ✓ |
87 | POST | `/api/v1/admin/connect` | `{"url", "key", "on_conflict": ""\|"wipe"\|"restore"}` | |
88 | POST | `/api/v1/admin/disconnect` | Ontkoppelen (kopie en archieven blijven) | ✓ |
89 | POST | `/api/v1/admin/sync` | Nu synchroniseren (`{"wait": false}`: op de achtergrond) | ✓ |
90 | POST | `/api/v1/admin/archive` | Nu archiveren | ✓ |
91 | POST | `/api/v1/admin/prune` | Bewaarregels nu toepassen | ✓ |
92 | GET | `/api/v1/admin/archives` | Archieven | ✓ |
93 | GET | `/api/v1/admin/archives/{name}/download` | Archief downloaden | |
94 | DELETE | `/api/v1/admin/archives/{name}` | Archief verwijderen | ✓ |
95 | POST | `/api/v1/admin/rollback` | `{"archive", "confirm": archiefnaam}`; niet terug te draaien | ✓ |
68 96
69 Een rollback start je in BlueGit, niet hier.
97 ✓ betekent dat de gekoppelde BlueGit dit ook mag, met een ondertekend verzoek. Een sessie van de webinterface mag de API ook gebruiken, met het CSRF-token in `X-CSRF-Token`.
98
99 ## CLI
100
101 ```sh
102 bluegit-backup status | list | config | actions
103 bluegit-backup sync | archive | prune | disconnect
104 bluegit-backup set retention_days=14 archive_interval=12h
105 bluegit-backup delete bluegit-20261115-030000.tar.gz
106 bluegit-backup rollback bluegit-20261115-030000.tar.gz # vraagt om de naam over te typen
107 bluegit-backup token # beheertoken voor de webinterface
108 ```
109
110 Deze commando's praten met de draaiende server via `data_dir/admin.token`. Draai ze dus als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).
70 111
71 112 ## Configuratie
72 113
73 114 | Sleutel | Standaard | Betekenis |
74 115 |---|---|---|
75 | `listen` | `0.0.0.0:8790` | Adres van de HTTP-server |
116 | `listen` | `0.0.0.0:8080` | Adres van de webinterface en API (na herstart) |
76 117 | `public_url` | (leeg) | Adres waarop BlueGit deze server bereikt |
77 | `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling |
118 | `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling (alleen in `config.yml`) |
78 119 | `archive_interval` | `24h` | Hoe vaak een archief |
79 120 | `retention_days` | `30` | Archieven ouder dan dit weg (0 = nooit) |
80 121 | `min_free_mb` | `1024` | Minder vrij: oudste archief weg |
@@ -87,7 +128,8 @@ In `data_dir`:
87 128 - `mirror/` is de lopende kopie.
88 129 - `archives/` bevat `bluegit-YYYYMMDD-HHMMSS.tar.gz` (UTC).
89 130 - `state.json` (0600) is de koppeling met de key.
90 - `admin.token` (0600) is voor de CLI.
131 - `admin.token` (0600) is voor de webinterface, de API en de CLI.
132 - `settings.yml` (0600) bevat wat via de webinterface, API of BlueGit is ingesteld.
91 133
92 134 ## Releases
93 135
@@ -107,6 +149,8 @@ go test ./... # unit-tests
107 149 BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/
108 150 ```
109 151
152 Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.
153
110 154 De integratietests starten per test een echte BlueGit in een tijdelijke map (dev-login, geen SSH, geen CI-runner). Ze maken een beheerderstoken en daarmee repositories, issues en een Backupserver-Key. Daarna testen ze tegen die BlueGit:
111 155
112 156 | Test | Feature |
@@ -121,8 +165,12 @@ De integratietests starten per test een echte BlueGit in een tijdelijke map (dev
121 165 | `TestNewInstanceWipe` | Nieuwe instantie, keuze wissen |
122 166 | `TestNewInstanceRestore` | Nieuwe instantie, keuze herstellen |
123 167 | `TestCLIConnectAsksOnConflict` | `connect` vraagt de keuze |
168 | `TestWebUIConfiguresAndOperatesEverything` | Webinterface: inloggen, alle instellingen, koppelen, sync, archief, download, opruimen, rollback, verwijderen, ontkoppelen |
169 | `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |
170 | `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |
171 | `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |
124 172
125 De BlueGit-kant (key, meldingen, beheerpagina, rollback) zit in BlueGit op `feature/backup-server`. Zolang die niet gemerged is, bouwt de pipeline BlueGit van die branch (`.bluegit-ref`). Zet `.bluegit-ref` op `master` zodra hij gemerged is.
173 De pipeline bouwt BlueGit van de ref in `.bluegit-ref`.
126 174
127 175 ## Licentie
128 176
@@ -8,7 +8,9 @@ Een losse backup server voor één [BlueGit](https://git.timfalken.com/timfa/blu
8- Elk `archive_interval` (standaard dagelijks) gaat de hele kopie gecomprimeerd in een archief (`tar.gz`).
8- Elk `archive_interval` (standaard dagelijks) gaat de hele kopie gecomprimeerd in een archief (`tar.gz`).
9- Archieven ouder dan `retention_days` gaan weg. Is de schijf vol (minder dan `min_free_mb` vrij), dan gaat het oudste archief weg. Het nieuwste archief blijft altijd staan.
9- Archieven ouder dan `retention_days` gaan weg. Is de schijf vol (minder dan `min_free_mb` vrij), dan gaat het oudste archief weg. Het nieuwste archief blijft altijd staan.
10- In BlueGit ziet de beheerder de archieven en kan hij een **rollback** starten, met een grote waarschuwing dat die niet terug te draaien is. De backup server pakt het archief uit, vervangt zijn kopie en stuurt alles naar BlueGit. BlueGit zet de data terug en herstart.
10- In BlueGit ziet de beheerder de archieven en kan hij een **rollback** starten, met een grote waarschuwing dat die niet terug te draaien is. De backup server pakt het archief uit, vervangt zijn kopie en stuurt alles naar BlueGit. BlueGit zet de data terug en herstart.
11- Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata.
11- Eén backup server hoort bij één BlueGit. Koppel je een andere instantie, dan kies je: **oude backups wissen** of **de nieuwe instantie herstellen** met de backupdata. Eén BlueGit kan wel meerdere backup servers hebben, elk met een eigen key.
12- Een **webinterface** (standaard op poort 8080) waarin alles in te stellen en te bedienen is, en een **API** die precies hetzelfde kan. Beide lopen via één lijst met acties (`GET /api/v1/admin/actions`).
13- Vanuit **BlueGit** (*Beheer → Backup → server*) is de backup server ook te bedienen: status, instellingen, sync, archiveren, opruimen, archieven verwijderen en rollback. BlueGit vraagt de acties op bij de backup server en stuurt ze ondertekend door.
12
14
13Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md). De aannames staan in [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md).
15Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md). De aannames staan in [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md).
14
16
@@ -36,8 +38,8 @@ go build -o bluegit-backup ./cmd/bluegit-backup
36
38
371. Zet in `config.yml` `public_url` op het adres waarop BlueGit deze server bereikt.
391. Zet in `config.yml` `public_url` op het adres waarop BlueGit deze server bereikt.
382. Start de server: `systemctl enable --now bluegit-backup`.
402. Start de server: `systemctl enable --now bluegit-backup`.
393. Maak in BlueGit onder *Beheer → Backup* een Backupserver-Key. Die wordt één keer getoond.
413. Voeg in BlueGit onder *Beheer → Backup* een backup server toe. De Backupserver-Key wordt één keer getoond.
404. Koppel:
424. Koppel in de webinterface (`http://<server>:8080`, sectie *Koppeling*), of met de CLI:
41
43
42 ```sh
44 ```sh
43 BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com
45 BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com
@@ -54,27 +56,66 @@ go build -o bluegit-backup ./cmd/bluegit-backup
54
56
55Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.
57Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.
56
58
57## Bedienen
59## Webinterface
60
61Open `http://<server>:8080` en log in met het beheertoken uit `data_dir/admin.token`:
58
62
59```sh
63```sh
60bluegit-backup status # koppeling, laatste sync, laatste archief
64sudo -u bluegit-backup bluegit-backup token
61bluegit-backup list # archieven
62bluegit-backup sync # nu synchroniseren
63bluegit-backup archive # nu een archief maken
64bluegit-backup prune # bewaarregels nu toepassen
65```
65```
66
66
67Deze commando's praten met de draaiende server via `data_dir/admin.token` en moeten dus draaien als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).
67Daar staan:
68
69- **Overzicht**: koppeling, laatste sync, kopie, archieven en de laatste rollback, met *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.
70- **Koppeling**: koppelen (met de keuze wissen of herstellen bij een andere BlueGit) en ontkoppelen.
71- **Instellingen**: elk veld uit de tabel hieronder. Ze gaan naar `data_dir/settings.yml`, dat boven `config.yml` gaat. `listen` geldt pas na een herstart, de rest meteen.
72- **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
73- **API**: de lijst met alle acties.
74
75De sessie is een HttpOnly-cookie (SameSite=Strict, 12 uur), elk formulier heeft een CSRF-token, en vijf foute logins per minuut per IP-adres geven `429`. De interface mag niet in een frame van een andere site. Gebruik een TLS-proxy als de server buiten je eigen netwerk bereikbaar is.
76
77## API
78
79Elke actie uit de webinterface is ook een API-aanroep, met `Authorization: Bearer <admin.token>`:
80
81| Methode | Pad | Actie | BlueGit |
82|---|---|---|---|
83| GET | `/api/v1/admin/status` | Status | ✓ |
84| GET | `/api/v1/admin/actions` | Alle acties | ✓ |
85| GET | `/api/v1/admin/config` | Instellingen met uitleg | ✓ |
86| PUT | `/api/v1/admin/config` | Instellingen wijzigen, bv. `{"retention_days": 14}` | ✓ |
87| POST | `/api/v1/admin/connect` | `{"url", "key", "on_conflict": ""\|"wipe"\|"restore"}` | |
88| POST | `/api/v1/admin/disconnect` | Ontkoppelen (kopie en archieven blijven) | ✓ |
89| POST | `/api/v1/admin/sync` | Nu synchroniseren (`{"wait": false}`: op de achtergrond) | ✓ |
90| POST | `/api/v1/admin/archive` | Nu archiveren | ✓ |
91| POST | `/api/v1/admin/prune` | Bewaarregels nu toepassen | ✓ |
92| GET | `/api/v1/admin/archives` | Archieven | ✓ |
93| GET | `/api/v1/admin/archives/{name}/download` | Archief downloaden | |
94| DELETE | `/api/v1/admin/archives/{name}` | Archief verwijderen | ✓ |
95| POST | `/api/v1/admin/rollback` | `{"archive", "confirm": archiefnaam}`; niet terug te draaien | ✓ |
68
96
69Een rollback start je in BlueGit, niet hier.
97✓ betekent dat de gekoppelde BlueGit dit ook mag, met een ondertekend verzoek. Een sessie van de webinterface mag de API ook gebruiken, met het CSRF-token in `X-CSRF-Token`.
98
99## CLI
100
101```sh
102bluegit-backup status | list | config | actions
103bluegit-backup sync | archive | prune | disconnect
104bluegit-backup set retention_days=14 archive_interval=12h
105bluegit-backup delete bluegit-20261115-030000.tar.gz
106bluegit-backup rollback bluegit-20261115-030000.tar.gz # vraagt om de naam over te typen
107bluegit-backup token # beheertoken voor de webinterface
108```
109
110Deze commando's praten met de draaiende server via `data_dir/admin.token`. Draai ze dus als een gebruiker die dat bestand kan lezen (`sudo -u bluegit-backup …`).
70
111
71## Configuratie
112## Configuratie
72
113
73| Sleutel | Standaard | Betekenis |
114| Sleutel | Standaard | Betekenis |
74|---|---|---|
115|---|---|---|
75| `listen` | `0.0.0.0:8790` | Adres van de HTTP-server |
116| `listen` | `0.0.0.0:8080` | Adres van de webinterface en API (na herstart) |
76| `public_url` | (leeg) | Adres waarop BlueGit deze server bereikt |
117| `public_url` | (leeg) | Adres waarop BlueGit deze server bereikt |
77| `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling |
118| `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven en koppeling (alleen in `config.yml`) |
78| `archive_interval` | `24h` | Hoe vaak een archief |
119| `archive_interval` | `24h` | Hoe vaak een archief |
79| `retention_days` | `30` | Archieven ouder dan dit weg (0 = nooit) |
120| `retention_days` | `30` | Archieven ouder dan dit weg (0 = nooit) |
80| `min_free_mb` | `1024` | Minder vrij: oudste archief weg |
121| `min_free_mb` | `1024` | Minder vrij: oudste archief weg |
@@ -87,7 +128,8 @@ In `data_dir`:
87- `mirror/` is de lopende kopie.
128- `mirror/` is de lopende kopie.
88- `archives/` bevat `bluegit-YYYYMMDD-HHMMSS.tar.gz` (UTC).
129- `archives/` bevat `bluegit-YYYYMMDD-HHMMSS.tar.gz` (UTC).
89- `state.json` (0600) is de koppeling met de key.
130- `state.json` (0600) is de koppeling met de key.
90- `admin.token` (0600) is voor de CLI.
131- `admin.token` (0600) is voor de webinterface, de API en de CLI.
132- `settings.yml` (0600) bevat wat via de webinterface, API of BlueGit is ingesteld.
91
133
92## Releases
134## Releases
93
135
@@ -107,6 +149,8 @@ go test ./... # unit-tests
107BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/
149BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/
108```
150```
109
151
152Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.
153
110De integratietests starten per test een echte BlueGit in een tijdelijke map (dev-login, geen SSH, geen CI-runner). Ze maken een beheerderstoken en daarmee repositories, issues en een Backupserver-Key. Daarna testen ze tegen die BlueGit:
154De integratietests starten per test een echte BlueGit in een tijdelijke map (dev-login, geen SSH, geen CI-runner). Ze maken een beheerderstoken en daarmee repositories, issues en een Backupserver-Key. Daarna testen ze tegen die BlueGit:
111
155
112| Test | Feature |
156| Test | Feature |
@@ -121,8 +165,12 @@ De integratietests starten per test een echte BlueGit in een tijdelijke map (dev
121| `TestNewInstanceWipe` | Nieuwe instantie, keuze wissen |
165| `TestNewInstanceWipe` | Nieuwe instantie, keuze wissen |
122| `TestNewInstanceRestore` | Nieuwe instantie, keuze herstellen |
166| `TestNewInstanceRestore` | Nieuwe instantie, keuze herstellen |
123| `TestCLIConnectAsksOnConflict` | `connect` vraagt de keuze |
167| `TestCLIConnectAsksOnConflict` | `connect` vraagt de keuze |
168| `TestWebUIConfiguresAndOperatesEverything` | Webinterface: inloggen, alle instellingen, koppelen, sync, archief, download, opruimen, rollback, verwijderen, ontkoppelen |
169| `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |
170| `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |
171| `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |
124
172
125De BlueGit-kant (key, meldingen, beheerpagina, rollback) zit in BlueGit op `feature/backup-server`. Zolang die niet gemerged is, bouwt de pipeline BlueGit van die branch (`.bluegit-ref`). Zet `.bluegit-ref` op `master` zodra hij gemerged is.
173De pipeline bouwt BlueGit van de ref in `.bluegit-ref`.
126
174
127## Licentie
175## Licentie
128
176
internal/backupserver/archive/archive.go +9 −0
@@ -96,6 +96,15 @@ func (s *Store) Path(name string) (string, error) {
96 96 return p, nil
97 97 }
98 98
99 // Delete verwijdert één archief.
100 func (s *Store) Delete(name string) error {
101 p, err := s.Path(name)
102 if err != nil {
103 return err
104 }
105 return os.Remove(p)
106 }
107
99 108 // DeleteAll verwijdert alle archieven.
100 109 func (s *Store) DeleteAll() error {
101 110 list, err := s.List()
@@ -96,6 +96,15 @@ func (s *Store) Path(name string) (string, error) {
96 return p, nil
96 return p, nil
97}
97}
98
98
99// Delete verwijdert één archief.
100func (s *Store) Delete(name string) error {
101 p, err := s.Path(name)
102 if err != nil {
103 return err
104 }
105 return os.Remove(p)
106}
107
99// DeleteAll verwijdert alle archieven.
108// DeleteAll verwijdert alle archieven.
100func (s *Store) DeleteAll() error {
109func (s *Store) DeleteAll() error {
101 list, err := s.List()
110 list, err := s.List()
internal/backupserver/config/config.go +6 −3
@@ -70,7 +70,7 @@ func (d Duration) MarshalYAML() (any, error) { return d.String(), nil }
70 70 // Defaults vult lege velden.
71 71 func (c *Config) Defaults() {
72 72 if c.Listen == "" {
73 c.Listen = "0.0.0.0:8790"
73 c.Listen = "0.0.0.0:8080"
74 74 }
75 75 if c.DataDir == "" {
76 76 c.DataDir = "/var/lib/bluegit-backup"
@@ -106,6 +106,9 @@ func (c Config) Validate() error {
106 106 if c.ArchiveInterval.Duration < time.Second {
107 107 return fmt.Errorf("archive_interval moet minstens 1s zijn")
108 108 }
109 if c.FullSyncInterval.Duration < time.Second || c.MinSyncInterval.Duration < 0 {
110 return fmt.Errorf("full_sync_interval moet minstens 1s zijn")
111 }
109 112 if c.PublicURL != "" && !strings.HasPrefix(c.PublicURL, "http://") && !strings.HasPrefix(c.PublicURL, "https://") {
110 113 return fmt.Errorf("public_url moet met http:// of https:// beginnen")
111 114 }
@@ -131,9 +134,9 @@ func Load(path string) (Config, error) {
131 134 // Example is een voorbeeldconfiguratie.
132 135 func Example() string {
133 136 return `# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
134 listen: 0.0.0.0:8790
137 listen: 0.0.0.0:8080
135 138 # Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
136 public_url: http://backup.lan:8790
139 public_url: http://backup.lan:8080
137 140 data_dir: /var/lib/bluegit-backup
138 141 # Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
139 142 archive_interval: 24h
@@ -70,7 +70,7 @@ func (d Duration) MarshalYAML() (any, error) { return d.String(), nil }
70// Defaults vult lege velden.
70// Defaults vult lege velden.
71func (c *Config) Defaults() {
71func (c *Config) Defaults() {
72 if c.Listen == "" {
72 if c.Listen == "" {
73 c.Listen = "0.0.0.0:8790"
73 c.Listen = "0.0.0.0:8080"
74 }
74 }
75 if c.DataDir == "" {
75 if c.DataDir == "" {
76 c.DataDir = "/var/lib/bluegit-backup"
76 c.DataDir = "/var/lib/bluegit-backup"
@@ -106,6 +106,9 @@ func (c Config) Validate() error {
106 if c.ArchiveInterval.Duration < time.Second {
106 if c.ArchiveInterval.Duration < time.Second {
107 return fmt.Errorf("archive_interval moet minstens 1s zijn")
107 return fmt.Errorf("archive_interval moet minstens 1s zijn")
108 }
108 }
109 if c.FullSyncInterval.Duration < time.Second || c.MinSyncInterval.Duration < 0 {
110 return fmt.Errorf("full_sync_interval moet minstens 1s zijn")
111 }
109 if c.PublicURL != "" && !strings.HasPrefix(c.PublicURL, "http://") && !strings.HasPrefix(c.PublicURL, "https://") {
112 if c.PublicURL != "" && !strings.HasPrefix(c.PublicURL, "http://") && !strings.HasPrefix(c.PublicURL, "https://") {
110 return fmt.Errorf("public_url moet met http:// of https:// beginnen")
113 return fmt.Errorf("public_url moet met http:// of https:// beginnen")
111 }
114 }
@@ -131,9 +134,9 @@ func Load(path string) (Config, error) {
131// Example is een voorbeeldconfiguratie.
134// Example is een voorbeeldconfiguratie.
132func Example() string {
135func Example() string {
133 return `# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
136 return `# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
134listen: 0.0.0.0:8790
137listen: 0.0.0.0:8080
135# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
138# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
136public_url: http://backup.lan:8790
139public_url: http://backup.lan:8080
137data_dir: /var/lib/bluegit-backup
140data_dir: /var/lib/bluegit-backup
138# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
141# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
139archive_interval: 24h
142archive_interval: 24h
internal/backupserver/config/config_test.go +52 −1
@@ -12,7 +12,7 @@ func TestDefaults(t *testing.T) {
12 12 if err != nil {
13 13 t.Fatal(err)
14 14 }
15 if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8790" {
15 if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8080" {
16 16 t.Fatalf("%+v", c)
17 17 }
18 18 }
@@ -42,3 +42,54 @@ func TestLoad(t *testing.T) {
42 42 t.Fatal("geen voorbeeld")
43 43 }
44 44 }
45
46 func TestFieldsRoundTrip(t *testing.T) {
47 var c Config
48 c.Defaults()
49 for _, f := range Fields {
50 v := c.Get(f.Key)
51 if f.Key != "public_url" && v == "" {
52 t.Errorf("%s: leeg", f.Key)
53 }
54 if err := c.Set(f.Key, v); err != nil && f.Key != "public_url" {
55 t.Errorf("%s=%q: %v", f.Key, v, err)
56 }
57 if got := c.Get(f.Key); got != v {
58 t.Errorf("%s: %q != %q", f.Key, got, v)
59 }
60 }
61 if c.Listen != "0.0.0.0:8080" {
62 t.Fatalf("standaardpoort %s", c.Listen)
63 }
64 }
65
66 func TestApplyIsAtomic(t *testing.T) {
67 var c Config
68 c.Defaults()
69 if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "nee"}); err == nil {
70 t.Fatal("fout verwacht")
71 }
72 if c.RetentionDays != 30 {
73 t.Fatal("half toegepast")
74 }
75 if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "7d", "public_url": "http://b:8080/"}); err != nil {
76 t.Fatal(err)
77 }
78 if c.RetentionDays != 7 || c.ArchiveInterval.Duration != 7*24*time.Hour || c.PublicURL != "http://b:8080" {
79 t.Fatalf("%+v", c)
80 }
81 if err := c.Apply(map[string]string{"data_dir": "/tmp"}); err == nil {
82 t.Fatal("data_dir mag niet")
83 }
84 }
85
86 func TestSettingsFile(t *testing.T) {
87 d := t.TempDir()
88 if err := SaveSettings(d, map[string]string{"retention_days": "3"}); err != nil {
89 t.Fatal(err)
90 }
91 m, err := LoadSettings(d)
92 if err != nil || m["retention_days"] != "3" {
93 t.Fatal(m, err)
94 }
95 }
@@ -12,7 +12,7 @@ func TestDefaults(t *testing.T) {
12 if err != nil {
12 if err != nil {
13 t.Fatal(err)
13 t.Fatal(err)
14 }
14 }
15 if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8790" {
15 if c.ArchiveInterval.Duration != 24*time.Hour || c.RetentionDays != 30 || c.RateLimitKiB != 1024 || c.Listen != "0.0.0.0:8080" {
16 t.Fatalf("%+v", c)
16 t.Fatalf("%+v", c)
17 }
17 }
18}
18}
@@ -42,3 +42,54 @@ func TestLoad(t *testing.T) {
42 t.Fatal("geen voorbeeld")
42 t.Fatal("geen voorbeeld")
43 }
43 }
44}
44}
45
46func TestFieldsRoundTrip(t *testing.T) {
47 var c Config
48 c.Defaults()
49 for _, f := range Fields {
50 v := c.Get(f.Key)
51 if f.Key != "public_url" && v == "" {
52 t.Errorf("%s: leeg", f.Key)
53 }
54 if err := c.Set(f.Key, v); err != nil && f.Key != "public_url" {
55 t.Errorf("%s=%q: %v", f.Key, v, err)
56 }
57 if got := c.Get(f.Key); got != v {
58 t.Errorf("%s: %q != %q", f.Key, got, v)
59 }
60 }
61 if c.Listen != "0.0.0.0:8080" {
62 t.Fatalf("standaardpoort %s", c.Listen)
63 }
64}
65
66func TestApplyIsAtomic(t *testing.T) {
67 var c Config
68 c.Defaults()
69 if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "nee"}); err == nil {
70 t.Fatal("fout verwacht")
71 }
72 if c.RetentionDays != 30 {
73 t.Fatal("half toegepast")
74 }
75 if err := c.Apply(map[string]string{"retention_days": "7", "archive_interval": "7d", "public_url": "http://b:8080/"}); err != nil {
76 t.Fatal(err)
77 }
78 if c.RetentionDays != 7 || c.ArchiveInterval.Duration != 7*24*time.Hour || c.PublicURL != "http://b:8080" {
79 t.Fatalf("%+v", c)
80 }
81 if err := c.Apply(map[string]string{"data_dir": "/tmp"}); err == nil {
82 t.Fatal("data_dir mag niet")
83 }
84}
85
86func TestSettingsFile(t *testing.T) {
87 d := t.TempDir()
88 if err := SaveSettings(d, map[string]string{"retention_days": "3"}); err != nil {
89 t.Fatal(err)
90 }
91 m, err := LoadSettings(d)
92 if err != nil || m["retention_days"] != "3" {
93 t.Fatal(m, err)
94 }
95}
internal/backupserver/config/fields.go added +211 −0
@@ -0,0 +1,211 @@
1 package config
2
3 import (
4 "errors"
5 "fmt"
6 "net"
7 "os"
8 "path/filepath"
9 "sort"
10 "strconv"
11 "strings"
12 "time"
13
14 "gopkg.in/yaml.v3"
15 )
16
17 // Field beschrijft één instelling die de webinterface, de API en BlueGit
18 // kunnen lezen en wijzigen. Alles wat in Fields staat, is overal hetzelfde
19 // instelbaar.
20 type Field struct {
21 Key string `json:"key"`
22 Label string `json:"label"`
23 Help string `json:"help"`
24 // Kind is duration, int of text.
25 Kind string `json:"kind"`
26 // Restart: pas na een herstart van kracht.
27 Restart bool `json:"restart,omitempty"`
28 }
29
30 // Fields zijn de instelbare velden, in de volgorde van de webinterface.
31 var Fields = []Field{
32 {Key: "public_url", Label: "Publiek adres", Help: "Waar BlueGit deze server bereikt, bijvoorbeeld http://backup.lan:8080.", Kind: "text"},
33 {Key: "archive_interval", Label: "Archiefinterval", Help: "Zo vaak wordt de hele kopie gecomprimeerd opgeslagen (bijvoorbeeld 24h, 12h, 7d).", Kind: "duration"},
34 {Key: "retention_days", Label: "Bewaartermijn (dagen)", Help: "Archieven ouder dan dit gaan weg. 0 = nooit op leeftijd. Het nieuwste blijft altijd staan.", Kind: "int"},
35 {Key: "min_free_mb", Label: "Minimaal vrij (MB)", Help: "Minder vrije schijfruimte dan dit: het oudste archief gaat weg.", Kind: "int"},
36 {Key: "rate_limit_kib", Label: "Downloadsnelheid (KiB/s)", Help: "Zo snel wordt BlueGit hoogstens gelezen. 0 = onbeperkt.", Kind: "int"},
37 {Key: "full_sync_interval", Label: "Volledige controle", Help: "Ook zonder melding zo vaak alles nalopen.", Kind: "duration"},
38 {Key: "min_sync_interval", Label: "Minimale tijd tussen syncs", Help: "Na een melding wacht de server minstens zo lang sinds de vorige sync.", Kind: "duration"},
39 {Key: "listen", Label: "Luisteradres", Help: "Adres en poort van de webinterface en API. Geldt na een herstart.", Kind: "text", Restart: true},
40 }
41
42 // FieldByKey zoekt een veld.
43 func FieldByKey(key string) (Field, bool) {
44 for _, f := range Fields {
45 if f.Key == key {
46 return f, true
47 }
48 }
49 return Field{}, false
50 }
51
52 // Get geeft de waarde van key als tekst.
53 func (c Config) Get(key string) string {
54 switch key {
55 case "listen":
56 return c.Listen
57 case "public_url":
58 return c.PublicURL
59 case "data_dir":
60 return c.DataDir
61 case "archive_interval":
62 return FormatDuration(c.ArchiveInterval.Duration)
63 case "retention_days":
64 return strconv.Itoa(c.RetentionDays)
65 case "min_free_mb":
66 return strconv.FormatInt(c.MinFreeMB, 10)
67 case "rate_limit_kib":
68 return strconv.FormatInt(c.RateLimitKiB, 10)
69 case "full_sync_interval":
70 return FormatDuration(c.FullSyncInterval.Duration)
71 case "min_sync_interval":
72 return FormatDuration(c.MinSyncInterval.Duration)
73 }
74 return ""
75 }
76
77 // FormatDuration schrijft 24h als "24h" en 30m als "30m".
78 func FormatDuration(d time.Duration) string {
79 if d%(24*time.Hour) == 0 && d >= 48*time.Hour {
80 return fmt.Sprintf("%dd", d/(24*time.Hour))
81 }
82 switch {
83 case d == 0:
84 return "0s"
85 case d%time.Hour == 0:
86 return fmt.Sprintf("%dh", d/time.Hour)
87 case d%time.Minute == 0:
88 return fmt.Sprintf("%dm", d/time.Minute)
89 case d%time.Second == 0:
90 return fmt.Sprintf("%ds", d/time.Second)
91 }
92 return d.String()
93 }
94
95 // ParseDuration leest een Go-duur of een aantal dagen ("7d").
96 func ParseDuration(s string) (time.Duration, error) {
97 s = strings.TrimSpace(s)
98 if strings.HasSuffix(s, "d") {
99 n, err := strconv.Atoi(strings.TrimSuffix(s, "d"))
100 if err == nil && n >= 0 {
101 return time.Duration(n) * 24 * time.Hour, nil
102 }
103 }
104 d, err := time.ParseDuration(s)
105 if err != nil {
106 return 0, fmt.Errorf("ongeldige duur %q", s)
107 }
108 return d, nil
109 }
110
111 // Set zet key op val. Alleen velden uit Fields.
112 func (c *Config) Set(key, val string) error {
113 f, ok := FieldByKey(key)
114 if !ok {
115 return fmt.Errorf("onbekende instelling %q", key)
116 }
117 val = strings.TrimSpace(val)
118 switch f.Kind {
119 case "duration":
120 d, err := ParseDuration(val)
121 if err != nil {
122 return fmt.Errorf("%s: %w", key, err)
123 }
124 switch key {
125 case "archive_interval":
126 c.ArchiveInterval.Duration = d
127 case "full_sync_interval":
128 c.FullSyncInterval.Duration = d
129 case "min_sync_interval":
130 c.MinSyncInterval.Duration = d
131 }
132 case "int":
133 n, err := strconv.ParseInt(val, 10, 64)
134 if err != nil || n < 0 {
135 return fmt.Errorf("%s: geef een geheel getal van 0 of meer", key)
136 }
137 switch key {
138 case "retention_days":
139 c.RetentionDays = int(n)
140 case "min_free_mb":
141 c.MinFreeMB = n
142 case "rate_limit_kib":
143 c.RateLimitKiB = n
144 }
145 default:
146 switch key {
147 case "public_url":
148 c.PublicURL = strings.TrimRight(val, "/")
149 case "listen":
150 if _, _, err := net.SplitHostPort(val); err != nil {
151 return fmt.Errorf("listen: verwacht host:poort, bijvoorbeeld 0.0.0.0:8080")
152 }
153 c.Listen = val
154 }
155 }
156 return nil
157 }
158
159 // Apply zet een reeks instellingen in één keer. Bij een fout verandert er niets.
160 func (c *Config) Apply(set map[string]string) error {
161 next := *c
162 keys := make([]string, 0, len(set))
163 for k := range set {
164 keys = append(keys, k)
165 }
166 sort.Strings(keys)
167 for _, k := range keys {
168 if err := next.Set(k, set[k]); err != nil {
169 return err
170 }
171 }
172 if err := next.Validate(); err != nil {
173 return err
174 }
175 *c = next
176 return nil
177 }
178
179 // SettingsFile bewaart wat via de webinterface, API of BlueGit is ingesteld.
180 // Het gaat boven config.yml, zodat config.yml van root mag blijven.
181 const SettingsFile = "settings.yml"
182
183 // LoadSettings leest data_dir/settings.yml (ontbreekt: leeg).
184 func LoadSettings(dataDir string) (map[string]string, error) {
185 out := map[string]string{}
186 b, err := os.ReadFile(filepath.Join(dataDir, SettingsFile))
187 if errors.Is(err, os.ErrNotExist) {
188 return out, nil
189 }
190 if err != nil {
191 return nil, err
192 }
193 if err := yaml.Unmarshal(b, &out); err != nil {
194 return nil, fmt.Errorf("%s: %w", SettingsFile, err)
195 }
196 return out, nil
197 }
198
199 // SaveSettings schrijft data_dir/settings.yml.
200 func SaveSettings(dataDir string, set map[string]string) error {
201 b, err := yaml.Marshal(set)
202 if err != nil {
203 return err
204 }
205 b = append([]byte("# Door de webinterface, API of BlueGit ingesteld. Gaat boven config.yml.\n"), b...)
206 tmp := filepath.Join(dataDir, SettingsFile+".tmp")
207 if err := os.WriteFile(tmp, b, 0o600); err != nil {
208 return err
209 }
210 return os.Rename(tmp, filepath.Join(dataDir, SettingsFile))
211 }
@@ -0,0 +1,211 @@
1package config
2
3import (
4 "errors"
5 "fmt"
6 "net"
7 "os"
8 "path/filepath"
9 "sort"
10 "strconv"
11 "strings"
12 "time"
13
14 "gopkg.in/yaml.v3"
15)
16
17// Field beschrijft één instelling die de webinterface, de API en BlueGit
18// kunnen lezen en wijzigen. Alles wat in Fields staat, is overal hetzelfde
19// instelbaar.
20type Field struct {
21 Key string `json:"key"`
22 Label string `json:"label"`
23 Help string `json:"help"`
24 // Kind is duration, int of text.
25 Kind string `json:"kind"`
26 // Restart: pas na een herstart van kracht.
27 Restart bool `json:"restart,omitempty"`
28}
29
30// Fields zijn de instelbare velden, in de volgorde van de webinterface.
31var Fields = []Field{
32 {Key: "public_url", Label: "Publiek adres", Help: "Waar BlueGit deze server bereikt, bijvoorbeeld http://backup.lan:8080.", Kind: "text"},
33 {Key: "archive_interval", Label: "Archiefinterval", Help: "Zo vaak wordt de hele kopie gecomprimeerd opgeslagen (bijvoorbeeld 24h, 12h, 7d).", Kind: "duration"},
34 {Key: "retention_days", Label: "Bewaartermijn (dagen)", Help: "Archieven ouder dan dit gaan weg. 0 = nooit op leeftijd. Het nieuwste blijft altijd staan.", Kind: "int"},
35 {Key: "min_free_mb", Label: "Minimaal vrij (MB)", Help: "Minder vrije schijfruimte dan dit: het oudste archief gaat weg.", Kind: "int"},
36 {Key: "rate_limit_kib", Label: "Downloadsnelheid (KiB/s)", Help: "Zo snel wordt BlueGit hoogstens gelezen. 0 = onbeperkt.", Kind: "int"},
37 {Key: "full_sync_interval", Label: "Volledige controle", Help: "Ook zonder melding zo vaak alles nalopen.", Kind: "duration"},
38 {Key: "min_sync_interval", Label: "Minimale tijd tussen syncs", Help: "Na een melding wacht de server minstens zo lang sinds de vorige sync.", Kind: "duration"},
39 {Key: "listen", Label: "Luisteradres", Help: "Adres en poort van de webinterface en API. Geldt na een herstart.", Kind: "text", Restart: true},
40}
41
42// FieldByKey zoekt een veld.
43func FieldByKey(key string) (Field, bool) {
44 for _, f := range Fields {
45 if f.Key == key {
46 return f, true
47 }
48 }
49 return Field{}, false
50}
51
52// Get geeft de waarde van key als tekst.
53func (c Config) Get(key string) string {
54 switch key {
55 case "listen":
56 return c.Listen
57 case "public_url":
58 return c.PublicURL
59 case "data_dir":
60 return c.DataDir
61 case "archive_interval":
62 return FormatDuration(c.ArchiveInterval.Duration)
63 case "retention_days":
64 return strconv.Itoa(c.RetentionDays)
65 case "min_free_mb":
66 return strconv.FormatInt(c.MinFreeMB, 10)
67 case "rate_limit_kib":
68 return strconv.FormatInt(c.RateLimitKiB, 10)
69 case "full_sync_interval":
70 return FormatDuration(c.FullSyncInterval.Duration)
71 case "min_sync_interval":
72 return FormatDuration(c.MinSyncInterval.Duration)
73 }
74 return ""
75}
76
77// FormatDuration schrijft 24h als "24h" en 30m als "30m".
78func FormatDuration(d time.Duration) string {
79 if d%(24*time.Hour) == 0 && d >= 48*time.Hour {
80 return fmt.Sprintf("%dd", d/(24*time.Hour))
81 }
82 switch {
83 case d == 0:
84 return "0s"
85 case d%time.Hour == 0:
86 return fmt.Sprintf("%dh", d/time.Hour)
87 case d%time.Minute == 0:
88 return fmt.Sprintf("%dm", d/time.Minute)
89 case d%time.Second == 0:
90 return fmt.Sprintf("%ds", d/time.Second)
91 }
92 return d.String()
93}
94
95// ParseDuration leest een Go-duur of een aantal dagen ("7d").
96func ParseDuration(s string) (time.Duration, error) {
97 s = strings.TrimSpace(s)
98 if strings.HasSuffix(s, "d") {
99 n, err := strconv.Atoi(strings.TrimSuffix(s, "d"))
100 if err == nil && n >= 0 {
101 return time.Duration(n) * 24 * time.Hour, nil
102 }
103 }
104 d, err := time.ParseDuration(s)
105 if err != nil {
106 return 0, fmt.Errorf("ongeldige duur %q", s)
107 }
108 return d, nil
109}
110
111// Set zet key op val. Alleen velden uit Fields.
112func (c *Config) Set(key, val string) error {
113 f, ok := FieldByKey(key)
114 if !ok {
115 return fmt.Errorf("onbekende instelling %q", key)
116 }
117 val = strings.TrimSpace(val)
118 switch f.Kind {
119 case "duration":
120 d, err := ParseDuration(val)
121 if err != nil {
122 return fmt.Errorf("%s: %w", key, err)
123 }
124 switch key {
125 case "archive_interval":
126 c.ArchiveInterval.Duration = d
127 case "full_sync_interval":
128 c.FullSyncInterval.Duration = d
129 case "min_sync_interval":
130 c.MinSyncInterval.Duration = d
131 }
132 case "int":
133 n, err := strconv.ParseInt(val, 10, 64)
134 if err != nil || n < 0 {
135 return fmt.Errorf("%s: geef een geheel getal van 0 of meer", key)
136 }
137 switch key {
138 case "retention_days":
139 c.RetentionDays = int(n)
140 case "min_free_mb":
141 c.MinFreeMB = n
142 case "rate_limit_kib":
143 c.RateLimitKiB = n
144 }
145 default:
146 switch key {
147 case "public_url":
148 c.PublicURL = strings.TrimRight(val, "/")
149 case "listen":
150 if _, _, err := net.SplitHostPort(val); err != nil {
151 return fmt.Errorf("listen: verwacht host:poort, bijvoorbeeld 0.0.0.0:8080")
152 }
153 c.Listen = val
154 }
155 }
156 return nil
157}
158
159// Apply zet een reeks instellingen in één keer. Bij een fout verandert er niets.
160func (c *Config) Apply(set map[string]string) error {
161 next := *c
162 keys := make([]string, 0, len(set))
163 for k := range set {
164 keys = append(keys, k)
165 }
166 sort.Strings(keys)
167 for _, k := range keys {
168 if err := next.Set(k, set[k]); err != nil {
169 return err
170 }
171 }
172 if err := next.Validate(); err != nil {
173 return err
174 }
175 *c = next
176 return nil
177}
178
179// SettingsFile bewaart wat via de webinterface, API of BlueGit is ingesteld.
180// Het gaat boven config.yml, zodat config.yml van root mag blijven.
181const SettingsFile = "settings.yml"
182
183// LoadSettings leest data_dir/settings.yml (ontbreekt: leeg).
184func LoadSettings(dataDir string) (map[string]string, error) {
185 out := map[string]string{}
186 b, err := os.ReadFile(filepath.Join(dataDir, SettingsFile))
187 if errors.Is(err, os.ErrNotExist) {
188 return out, nil
189 }
190 if err != nil {
191 return nil, err
192 }
193 if err := yaml.Unmarshal(b, &out); err != nil {
194 return nil, fmt.Errorf("%s: %w", SettingsFile, err)
195 }
196 return out, nil
197}
198
199// SaveSettings schrijft data_dir/settings.yml.
200func SaveSettings(dataDir string, set map[string]string) error {
201 b, err := yaml.Marshal(set)
202 if err != nil {
203 return err
204 }
205 b = append([]byte("# Door de webinterface, API of BlueGit ingesteld. Gaat boven config.yml.\n"), b...)
206 tmp := filepath.Join(dataDir, SettingsFile+".tmp")
207 if err := os.WriteFile(tmp, b, 0o600); err != nil {
208 return err
209 }
210 return os.Rename(tmp, filepath.Join(dataDir, SettingsFile))
211}
internal/backupserver/integration/backup_test.go +5 −5
@@ -49,7 +49,7 @@ func TestKeyGenerationAndConnect(t *testing.T) {
49 49 t.Fatal("BlueGit bewaart de key leesbaar")
50 50 }
51 51 // Een nieuwe key maakt de oude ongeldig: de backup server kan niet meer syncen.
52 g.NewKey()
52 g.RotateKey()
53 53 code, raw = b.Admin("POST", "/sync", nil)
54 54 if code == 200 {
55 55 t.Fatalf("sync met ingetrokken key gelukt: %s", raw)
@@ -183,7 +183,7 @@ func TestArchiveIntervalAndListInBlueGit(t *testing.T) {
183 183 t.Fatalf("BlueGit toont de archieven niet: %+v vs %v", st.Archives, names)
184 184 }
185 185 // De beheerpagina toont de lijst met de grote waarschuwing.
186 res, err := g.Session().Get(g.URL + "/admin/backup")
186 res, err := g.Session().Get(g.URL + "/admin/backup/s/" + g.Server)
187 187 if err != nil {
188 188 t.Fatal(err)
189 189 }
@@ -269,7 +269,7 @@ func TestRollbackFromBlueGit(t *testing.T) {
269 269 }
270 270
271 271 // Zonder juiste bevestiging gebeurt er niets.
272 code, raw := g.API("POST", "/admin/backup/rollback", map[string]any{"archive": archiveName, "confirm": "ja"})
272 code, raw := g.Action(g.Server, "rollback", map[string]any{"archive": archiveName, "confirm": "ja"})
273 273 if code != 400 {
274 274 t.Fatalf("rollback zonder bevestiging: %d %s", code, raw)
275 275 }
@@ -328,7 +328,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b
328 328 t.Helper()
329 329 hc := g.Session()
330 330 hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }
331 res, err := hc.Get(g.URL + "/admin/backup")
331 res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)
332 332 if err != nil {
333 333 t.Fatal(err)
334 334 }
@@ -342,7 +342,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b
342 342 if understood {
343 343 form.Set("understood", "1")
344 344 }
345 res, err = hc.PostForm(g.URL+"/admin/backup/rollback", form)
345 res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/rollback", form)
346 346 if err != nil {
347 347 t.Fatal(err)
348 348 }
@@ -49,7 +49,7 @@ func TestKeyGenerationAndConnect(t *testing.T) {
49 t.Fatal("BlueGit bewaart de key leesbaar")
49 t.Fatal("BlueGit bewaart de key leesbaar")
50 }
50 }
51 // Een nieuwe key maakt de oude ongeldig: de backup server kan niet meer syncen.
51 // Een nieuwe key maakt de oude ongeldig: de backup server kan niet meer syncen.
52 g.NewKey()
52 g.RotateKey()
53 code, raw = b.Admin("POST", "/sync", nil)
53 code, raw = b.Admin("POST", "/sync", nil)
54 if code == 200 {
54 if code == 200 {
55 t.Fatalf("sync met ingetrokken key gelukt: %s", raw)
55 t.Fatalf("sync met ingetrokken key gelukt: %s", raw)
@@ -183,7 +183,7 @@ func TestArchiveIntervalAndListInBlueGit(t *testing.T) {
183 t.Fatalf("BlueGit toont de archieven niet: %+v vs %v", st.Archives, names)
183 t.Fatalf("BlueGit toont de archieven niet: %+v vs %v", st.Archives, names)
184 }
184 }
185 // De beheerpagina toont de lijst met de grote waarschuwing.
185 // De beheerpagina toont de lijst met de grote waarschuwing.
186 res, err := g.Session().Get(g.URL + "/admin/backup")
186 res, err := g.Session().Get(g.URL + "/admin/backup/s/" + g.Server)
187 if err != nil {
187 if err != nil {
188 t.Fatal(err)
188 t.Fatal(err)
189 }
189 }
@@ -269,7 +269,7 @@ func TestRollbackFromBlueGit(t *testing.T) {
269 }
269 }
270
270
271 // Zonder juiste bevestiging gebeurt er niets.
271 // Zonder juiste bevestiging gebeurt er niets.
272 code, raw := g.API("POST", "/admin/backup/rollback", map[string]any{"archive": archiveName, "confirm": "ja"})
272 code, raw := g.Action(g.Server, "rollback", map[string]any{"archive": archiveName, "confirm": "ja"})
273 if code != 400 {
273 if code != 400 {
274 t.Fatalf("rollback zonder bevestiging: %d %s", code, raw)
274 t.Fatalf("rollback zonder bevestiging: %d %s", code, raw)
275 }
275 }
@@ -328,7 +328,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b
328 t.Helper()
328 t.Helper()
329 hc := g.Session()
329 hc := g.Session()
330 hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }
330 hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }
331 res, err := hc.Get(g.URL + "/admin/backup")
331 res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)
332 if err != nil {
332 if err != nil {
333 t.Fatal(err)
333 t.Fatal(err)
334 }
334 }
@@ -342,7 +342,7 @@ func postRollbackForm(t *testing.T, g *BlueGit, archiveName string, understood b
342 if understood {
342 if understood {
343 form.Set("understood", "1")
343 form.Set("understood", "1")
344 }
344 }
345 res, err = hc.PostForm(g.URL+"/admin/backup/rollback", form)
345 res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/rollback", form)
346 if err != nil {
346 if err != nil {
347 t.Fatal(err)
347 t.Fatal(err)
348 }
348 }
internal/backupserver/integration/harness_test.go +64 −10
@@ -65,6 +65,8 @@ type BlueGit struct {
65 65 Token string
66 66 cmd *exec.Cmd
67 67 log *syncBuf
68 // Server is het id van de laatst toegevoegde backup server in BlueGit.
69 Server string
68 70 }
69 71
70 72 type syncBuf struct {
@@ -204,17 +206,39 @@ func (g *BlueGit) MustAPI(method, path string, in any) []byte {
204 206 return b
205 207 }
206 208
207 // NewKey maakt een Backupserver-Key via de beheer-API.
209 // AddServer voegt een backup server toe in BlueGit en geeft id en key.
210 func (g *BlueGit) AddServer(name string) (string, string) {
211 g.t.Helper()
212 var out struct{ ID, Key string }
213 _ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers", map[string]any{"name": name}), &out)
214 if !strings.HasPrefix(out.Key, "bgbk_") || out.ID == "" {
215 g.t.Fatalf("server %+v", out)
216 }
217 return out.ID, out.Key
218 }
219
220 // NewKey voegt een backup server toe en geeft zijn Backupserver-Key.
208 221 func (g *BlueGit) NewKey() string {
222 g.t.Helper()
223 id, key := g.AddServer("test")
224 g.Server = id
225 return key
226 }
227
228 // RotateKey geeft de laatst toegevoegde backup server een nieuwe key.
229 func (g *BlueGit) RotateKey() string {
209 230 g.t.Helper()
210 231 var out struct{ Key string }
211 _ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/key", nil), &out)
212 if !strings.HasPrefix(out.Key, "bgbk_") {
213 g.t.Fatalf("key %q", out.Key)
214 }
232 _ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers/"+g.Server+"/key", nil), &out)
215 233 return out.Key
216 234 }
217 235
236 // Action voert een actie van backup server id uit via BlueGit.
237 func (g *BlueGit) Action(id, name string, in any) (int, []byte) {
238 g.t.Helper()
239 return g.API("POST", "/admin/backup/servers/"+id+"/actions/"+name, in)
240 }
241
218 242 // Project maakt een project met één commit.
219 243 func (g *BlueGit) Project(name, file, content string) {
220 244 g.t.Helper()
@@ -276,23 +300,53 @@ func (g *BlueGit) ProjectCode(repo string) int {
276 300 return code
277 301 }
278 302
279 // BackupStatus is GET /admin/backup in BlueGit.
303 // BackupStatus is wat BlueGit over een backup server weet.
280 304 type BackupStatus struct {
281 305 InstanceID string `json:"instance_id"`
282 HasKey bool `json:"has_key"`
306 HasKey bool `json:"-"`
307 Name string `json:"name"`
283 308 Connected bool `json:"connected"`
284 309 ServerURL string `json:"server_url"`
285 310 Archives []struct {
286 311 Name string `json:"name"`
287 312 Size int64 `json:"size"`
288 313 } `json:"archives"`
314 Config struct {
315 Fields []struct {
316 Key string `json:"key"`
317 Value string `json:"value"`
318 } `json:"fields"`
319 } `json:"config"`
289 320 RemoteError string `json:"remote_error"`
290 321 }
291 322
292 func (g *BlueGit) BackupStatus() BackupStatus {
323 // BackupStatus geeft de stand van de laatst toegevoegde backup server.
324 func (g *BlueGit) BackupStatus() BackupStatus { return g.ServerStatus(g.Server) }
325
326 // ServerStatus geeft de stand van backup server id ("" = de eerste).
327 func (g *BlueGit) ServerStatus(id string) BackupStatus {
293 328 g.t.Helper()
294 var st BackupStatus
295 _ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &st)
329 var list struct {
330 InstanceID string `json:"instance_id"`
331 Servers []struct {
332 ID string `json:"id"`
333 } `json:"servers"`
334 }
335 _ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &list)
336 st := BackupStatus{InstanceID: list.InstanceID}
337 if id == "" && len(list.Servers) > 0 {
338 id = list.Servers[0].ID
339 }
340 found := false
341 for _, s := range list.Servers {
342 found = found || s.ID == id
343 }
344 if !found {
345 return st
346 }
347 _ = json.Unmarshal(g.MustAPI("GET", "/admin/backup/servers/"+id, nil), &st)
348 st.HasKey = true
349 st.InstanceID = list.InstanceID
296 350 return st
297 351 }
298 352
@@ -65,6 +65,8 @@ type BlueGit struct {
65 Token string
65 Token string
66 cmd *exec.Cmd
66 cmd *exec.Cmd
67 log *syncBuf
67 log *syncBuf
68 // Server is het id van de laatst toegevoegde backup server in BlueGit.
69 Server string
68}
70}
69
71
70type syncBuf struct {
72type syncBuf struct {
@@ -204,17 +206,39 @@ func (g *BlueGit) MustAPI(method, path string, in any) []byte {
204 return b
206 return b
205}
207}
206
208
207// NewKey maakt een Backupserver-Key via de beheer-API.
209// AddServer voegt een backup server toe in BlueGit en geeft id en key.
210func (g *BlueGit) AddServer(name string) (string, string) {
211 g.t.Helper()
212 var out struct{ ID, Key string }
213 _ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers", map[string]any{"name": name}), &out)
214 if !strings.HasPrefix(out.Key, "bgbk_") || out.ID == "" {
215 g.t.Fatalf("server %+v", out)
216 }
217 return out.ID, out.Key
218}
219
220// NewKey voegt een backup server toe en geeft zijn Backupserver-Key.
208func (g *BlueGit) NewKey() string {
221func (g *BlueGit) NewKey() string {
222 g.t.Helper()
223 id, key := g.AddServer("test")
224 g.Server = id
225 return key
226}
227
228// RotateKey geeft de laatst toegevoegde backup server een nieuwe key.
229func (g *BlueGit) RotateKey() string {
209 g.t.Helper()
230 g.t.Helper()
210 var out struct{ Key string }
231 var out struct{ Key string }
211 _ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/key", nil), &out)
232 _ = json.Unmarshal(g.MustAPI("POST", "/admin/backup/servers/"+g.Server+"/key", nil), &out)
212 if !strings.HasPrefix(out.Key, "bgbk_") {
213 g.t.Fatalf("key %q", out.Key)
214 }
215 return out.Key
233 return out.Key
216}
234}
217
235
236// Action voert een actie van backup server id uit via BlueGit.
237func (g *BlueGit) Action(id, name string, in any) (int, []byte) {
238 g.t.Helper()
239 return g.API("POST", "/admin/backup/servers/"+id+"/actions/"+name, in)
240}
241
218// Project maakt een project met één commit.
242// Project maakt een project met één commit.
219func (g *BlueGit) Project(name, file, content string) {
243func (g *BlueGit) Project(name, file, content string) {
220 g.t.Helper()
244 g.t.Helper()
@@ -276,23 +300,53 @@ func (g *BlueGit) ProjectCode(repo string) int {
276 return code
300 return code
277}
301}
278
302
279// BackupStatus is GET /admin/backup in BlueGit.
303// BackupStatus is wat BlueGit over een backup server weet.
280type BackupStatus struct {
304type BackupStatus struct {
281 InstanceID string `json:"instance_id"`
305 InstanceID string `json:"instance_id"`
282 HasKey bool `json:"has_key"`
306 HasKey bool `json:"-"`
307 Name string `json:"name"`
283 Connected bool `json:"connected"`
308 Connected bool `json:"connected"`
284 ServerURL string `json:"server_url"`
309 ServerURL string `json:"server_url"`
285 Archives []struct {
310 Archives []struct {
286 Name string `json:"name"`
311 Name string `json:"name"`
287 Size int64 `json:"size"`
312 Size int64 `json:"size"`
288 } `json:"archives"`
313 } `json:"archives"`
314 Config struct {
315 Fields []struct {
316 Key string `json:"key"`
317 Value string `json:"value"`
318 } `json:"fields"`
319 } `json:"config"`
289 RemoteError string `json:"remote_error"`
320 RemoteError string `json:"remote_error"`
290}
321}
291
322
292func (g *BlueGit) BackupStatus() BackupStatus {
323// BackupStatus geeft de stand van de laatst toegevoegde backup server.
324func (g *BlueGit) BackupStatus() BackupStatus { return g.ServerStatus(g.Server) }
325
326// ServerStatus geeft de stand van backup server id ("" = de eerste).
327func (g *BlueGit) ServerStatus(id string) BackupStatus {
293 g.t.Helper()
328 g.t.Helper()
294 var st BackupStatus
329 var list struct {
295 _ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &st)
330 InstanceID string `json:"instance_id"`
331 Servers []struct {
332 ID string `json:"id"`
333 } `json:"servers"`
334 }
335 _ = json.Unmarshal(g.MustAPI("GET", "/admin/backup", nil), &list)
336 st := BackupStatus{InstanceID: list.InstanceID}
337 if id == "" && len(list.Servers) > 0 {
338 id = list.Servers[0].ID
339 }
340 found := false
341 for _, s := range list.Servers {
342 found = found || s.ID == id
343 }
344 if !found {
345 return st
346 }
347 _ = json.Unmarshal(g.MustAPI("GET", "/admin/backup/servers/"+id, nil), &st)
348 st.HasKey = true
349 st.InstanceID = list.InstanceID
296 return st
350 return st
297}
351}
298
352
internal/backupserver/integration/ui_test.go added +399 −0
@@ -0,0 +1,399 @@
1 //go:build integration
2
3 package integration
4
5 import (
6 "encoding/json"
7 "io"
8 "net/http"
9 "net/http/cookiejar"
10 "net/url"
11 "os"
12 "path/filepath"
13 "sort"
14 "strings"
15 "testing"
16 "time"
17 )
18
19 // webUI is een browser op de webinterface van de backup server.
20 type webUI struct {
21 t *testing.T
22 b *Backup
23 hc *http.Client
24 csrf string
25 }
26
27 func openUI(t *testing.T, b *Backup) *webUI {
28 t.Helper()
29 jar, _ := cookiejar.New(nil)
30 u := &webUI{t: t, b: b, hc: &http.Client{Jar: jar, CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}}
31 res, err := u.hc.Get(b.URL + "/")
32 if err != nil {
33 t.Fatal(err)
34 }
35 res.Body.Close()
36 if res.StatusCode != 303 || res.Header.Get("Location") != "/login" {
37 t.Fatalf("zonder login: %d %s", res.StatusCode, res.Header.Get("Location"))
38 }
39 res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {"bba_fout"}})
40 res.Body.Close()
41 if res.Header.Get("Location") != "/login?fout=1" {
42 t.Fatal("fout token geaccepteerd")
43 }
44 res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {b.Srv.AdminToken()}})
45 res.Body.Close()
46 if res.StatusCode != 303 || res.Header.Get("Location") != "/" {
47 t.Fatalf("login: %d", res.StatusCode)
48 }
49 u.Page()
50 return u
51 }
52
53 // Page haalt de hoofdpagina op en onthoudt het CSRF-token.
54 func (u *webUI) Page() string {
55 u.t.Helper()
56 res, err := u.hc.Get(u.b.URL + "/")
57 if err != nil {
58 u.t.Fatal(err)
59 }
60 b, _ := io.ReadAll(res.Body)
61 res.Body.Close()
62 if res.StatusCode != 200 {
63 u.t.Fatalf("pagina: %d", res.StatusCode)
64 }
65 u.csrf = between(string(b), `name="csrf" value="`, `"`)
66 return string(b)
67 }
68
69 // Act verstuurt het formulier van een actie en geeft de melding erna.
70 func (u *webUI) Act(name string, form url.Values) string {
71 u.t.Helper()
72 if form == nil {
73 form = url.Values{}
74 }
75 form.Set("csrf", u.csrf)
76 res, err := u.hc.PostForm(u.b.URL+"/ui/act/"+name, form)
77 if err != nil {
78 u.t.Fatal(err)
79 }
80 res.Body.Close()
81 if res.StatusCode != 303 {
82 u.t.Fatalf("%s: %d", name, res.StatusCode)
83 }
84 return between(u.Page(), `role="status">`, `</div>`)
85 }
86
87 func actionNames(t *testing.T, b *Backup, withGet bool) []string {
88 t.Helper()
89 code, raw := b.Admin("GET", "/actions", nil)
90 if code != 200 {
91 t.Fatalf("actions: %d", code)
92 }
93 var out struct {
94 Actions []struct{ Name, Method string }
95 }
96 _ = json.Unmarshal(raw, &out)
97 var names []string
98 for _, a := range out.Actions {
99 if withGet || a.Method != "GET" {
100 names = append(names, a.Name)
101 }
102 }
103 sort.Strings(names)
104 return names
105 }
106
107 func requireAll(t *testing.T, what string, want []string, done map[string]bool) {
108 t.Helper()
109 for _, n := range want {
110 if !done[n] {
111 t.Errorf("%s: actie %s niet getest", what, n)
112 }
113 }
114 }
115
116 // Feature: alles is in te stellen en te bedienen via de webinterface (poort 8080 standaard).
117 func TestWebUIConfiguresAndOperatesEverything(t *testing.T) {
118 g := startBlueGit(t)
119 g.Project("Alpha", "README.md", "v1")
120 b := startBackup(t, nil)
121 u := openUI(t, b)
122 done := map[string]bool{}
123
124 // Instellingen.
125 msg := u.Act("config.update", url.Values{"archive_interval": {"3h"}, "retention_days": {"5"}, "rate_limit_kib": {"2048"}, "min_free_mb": {"2"}, "full_sync_interval": {"2h"}, "min_sync_interval": {"1s"}, "public_url": {b.URL}, "listen": {b.Cfg.Listen}})
126 if !strings.Contains(msg, "opgeslagen") {
127 t.Fatalf("instellingen: %q", msg)
128 }
129 done["config.update"] = true
130 st := b.Status()
131 if st.Interval != "3h0m0s" || st.RetentionDays != 5 || st.RateLimitKiB != 2048 {
132 t.Fatalf("niet toegepast: %+v", st)
133 }
134 if msg := u.Act("config.update", url.Values{"archive_interval": {"nooit"}}); !strings.Contains(msg, "mislukt") {
135 t.Fatalf("ongeldige waarde: %q", msg)
136 }
137 u.Act("config.update", url.Values{"rate_limit_kib": {"0"}})
138
139 // Koppelen met een key uit BlueGit.
140 if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {"bgbk_fout"}, "on_conflict": {""}}); !strings.Contains(msg, "mislukt") {
141 t.Fatalf("verkeerde key: %q", msg)
142 }
143 if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {g.NewKey()}, "on_conflict": {""}}); !strings.Contains(msg, "gelukt") {
144 t.Fatalf("koppelen: %q", msg)
145 }
146 done["connect"] = true
147 if st := g.BackupStatus(); !st.Connected || st.ServerURL != b.URL {
148 t.Fatalf("BlueGit ziet de koppeling niet: %+v", st)
149 }
150
151 // Sync, archief, opruimen.
152 if msg := u.Act("sync", nil); !strings.Contains(msg, "gestart") {
153 t.Fatalf("sync: %q", msg)
154 }
155 done["sync"] = true
156 Eventually(t, 15*time.Second, "kopie na sync uit de webinterface", func() bool {
157 _, err := os.Stat(b.Mirror("data/repos/tim/alpha.git/HEAD"))
158 return err == nil
159 })
160 b.Sync()
161 if msg := u.Act("archive", nil); !strings.Contains(msg, "Archief gemaakt") {
162 t.Fatalf("archief: %q", msg)
163 }
164 done["archive"] = true
165 name := b.Archives()[0]
166 page := u.Page()
167 if !strings.Contains(page, name) || !strings.Contains(page, "gekoppeld") {
168 t.Fatal("pagina toont het archief of de koppeling niet")
169 }
170 // Download vanuit de pagina.
171 res, err := u.hc.Get(b.URL + "/api/v1/admin/archives/" + name + "/download")
172 if err != nil {
173 t.Fatal(err)
174 }
175 got, _ := io.ReadAll(res.Body)
176 res.Body.Close()
177 want, _ := os.ReadFile(filepath.Join(b.Dir, "archives", name))
178 if res.StatusCode != 200 || len(got) == 0 || string(got) != string(want) {
179 t.Fatalf("download: %d %d bytes", res.StatusCode, len(got))
180 }
181 if msg := u.Act("prune", nil); !strings.Contains(msg, "Opgeruimd") {
182 t.Fatalf("opruimen: %q", msg)
183 }
184 done["prune"] = true
185
186 // Rollback vanuit de webinterface: zonder vinkje niets, daarna echt.
187 g.Commit("alpha", "README.md", "v2", "update")
188 b.Sync()
189 if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}}); !strings.Contains(msg, "Vink aan") {
190 t.Fatalf("zonder vinkje: %q", msg)
191 }
192 if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {"verkeerd"}, "understood": {"1"}}); !strings.Contains(msg, "mislukt") {
193 t.Fatalf("verkeerde bevestiging: %q", msg)
194 }
195 if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}, "understood": {"1"}}); !strings.Contains(msg, "Rollback gestart") {
196 t.Fatalf("rollback: %q", msg)
197 }
198 done["rollback"] = true
199 Eventually(t, 60*time.Second, "rollback klaar", func() bool {
200 st := b.Status().Rollback
201 if st.State == "failed" {
202 t.Fatalf("rollback mislukt: %s", st.Error)
203 }
204 return st.State == "done"
205 })
206 g.WaitUp(30 * time.Second)
207 if _, s := g.File("alpha", "README.md"); s != "v1" {
208 t.Fatalf("README na rollback: %q", s)
209 }
210
211 // Archief verwijderen en ontkoppelen.
212 if msg := u.Act("archive.delete", url.Values{"name": {name}}); !strings.Contains(msg, "gelukt") {
213 t.Fatalf("verwijderen: %q", msg)
214 }
215 done["archive.delete"] = true
216 if len(b.Archives()) != 0 {
217 t.Fatal("archief staat er nog")
218 }
219 if msg := u.Act("disconnect", nil); !strings.Contains(msg, "gelukt") {
220 t.Fatalf("ontkoppelen: %q", msg)
221 }
222 done["disconnect"] = true
223 if b.Status().Connected {
224 t.Fatal("nog gekoppeld")
225 }
226 requireAll(t, "webinterface", actionNames(t, b, false), done)
227 }
228
229 // Feature: de API kan alles wat de webinterface kan, en andersom.
230 func TestAPIDoesEverythingTheUICan(t *testing.T) {
231 g := startBlueGit(t)
232 g.Project("Alpha", "README.md", "v1")
233 b := startBackup(t, nil)
234 done := map[string]bool{}
235 call := func(name, method, path string, in any, want int) []byte {
236 t.Helper()
237 code, raw := b.Admin(method, path, in)
238 if code != want {
239 t.Fatalf("%s %s: %d %s", method, path, code, raw)
240 }
241 done[name] = true
242 return raw
243 }
244 call("status", "GET", "/status", nil, 200)
245 call("actions", "GET", "/actions", nil, 200)
246 raw := call("config", "GET", "/config", nil, 200)
247 if !strings.Contains(string(raw), `"key":"listen"`) {
248 t.Fatalf("config: %s", raw)
249 }
250 call("config.update", "PUT", "/config", map[string]any{"retention_days": 7, "archive_interval": "6h"}, 200)
251 if b.Status().RetentionDays != 7 {
252 t.Fatal("config niet toegepast")
253 }
254 call("connect", "POST", "/connect", map[string]any{"url": g.URL, "key": g.NewKey()}, 200)
255 call("sync", "POST", "/sync", nil, 200)
256 raw = call("archive", "POST", "/archive", nil, 201)
257 var a struct{ Name string }
258 _ = json.Unmarshal(raw, &a)
259 raw = call("archives", "GET", "/archives", nil, 200)
260 if !strings.Contains(string(raw), a.Name) {
261 t.Fatalf("archives: %s", raw)
262 }
263 raw = call("archive.download", "GET", "/archives/"+a.Name+"/download", nil, 200)
264 if len(raw) < 100 || raw[0] != 0x1f || raw[1] != 0x8b {
265 t.Fatal("download is geen gzip")
266 }
267 call("prune", "POST", "/prune", nil, 200)
268 call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name}, 400) // bevestiging ontbreekt
269 call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name, "confirm": a.Name}, 202)
270 Eventually(t, 60*time.Second, "rollback klaar", func() bool { return b.Status().Rollback.State == "done" })
271 g.WaitUp(30 * time.Second)
272 call("archive.delete", "DELETE", "/archives/"+a.Name, nil, 200)
273 call("disconnect", "POST", "/disconnect", nil, 200)
274 requireAll(t, "API", actionNames(t, b, true), done)
275 }
276
277 // Feature: vanuit BlueGit is de backup server te bedienen zoals in zijn eigen webinterface.
278 func TestBlueGitControlsBackupServer(t *testing.T) {
279 g := startBlueGit(t)
280 g.Project("Alpha", "README.md", "v1")
281 b := startBackup(t, nil)
282 b.Connect(g, g.NewKey())
283 b.Sync()
284
285 // Instellingen lezen en wijzigen via de BlueGit-API.
286 st := g.BackupStatus()
287 if len(st.Config.Fields) == 0 {
288 t.Fatalf("BlueGit ziet geen instellingen: %+v", st)
289 }
290 if code, raw := g.Action(g.Server, "config.update", map[string]any{"retention_days": "11", "archive_interval": "5h"}); code != 200 {
291 t.Fatalf("config via BlueGit: %d %s", code, raw)
292 }
293 if s := b.Status(); s.RetentionDays != 11 || s.Interval != "5h0m0s" {
294 t.Fatalf("niet toegepast: %+v", s)
295 }
296 // Archief maken, synchroniseren en verwijderen via BlueGit.
297 if code, raw := g.Action(g.Server, "archive", nil); code != 201 {
298 t.Fatalf("archief via BlueGit: %d %s", code, raw)
299 }
300 name := b.Archives()[0]
301 g.Commit("alpha", "x.txt", "x", "create")
302 before := b.Status().Syncs
303 if code, raw := g.Action(g.Server, "sync", nil); code != 202 {
304 t.Fatalf("sync via BlueGit: %d %s", code, raw)
305 }
306 Eventually(t, 15*time.Second, "sync gestart door BlueGit", func() bool { return b.Status().Syncs > before })
307 if code, raw := g.Action(g.Server, "archive.delete", map[string]any{"name": name}); code != 200 {
308 t.Fatalf("verwijderen via BlueGit: %d %s", code, raw)
309 }
310 if len(b.Archives()) != 0 {
311 t.Fatal("archief niet verwijderd")
312 }
313 // Koppelen kan BlueGit niet namens de backup server (alleen lokaal).
314 if code, _ := g.Action(g.Server, "connect", map[string]any{"url": g.URL, "key": "bgbk_x"}); code != 404 {
315 t.Fatalf("connect via BlueGit: %d", code)
316 }
317
318 // Dezelfde bediening in de BlueGit-webinterface.
319 hc := g.Session()
320 hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }
321 res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)
322 if err != nil {
323 t.Fatal(err)
324 }
325 page, _ := io.ReadAll(res.Body)
326 res.Body.Close()
327 for _, want := range []string{`name="retention_days" value="11"`, "/act/sync", "/act/archive", "/act/prune", "/act/config.update"} {
328 if !strings.Contains(string(page), want) {
329 t.Fatalf("BlueGit-pagina mist %q", want)
330 }
331 }
332 csrf := between(string(page), `name="csrf" value="`, `"`)
333 res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"12"}})
334 if err != nil {
335 t.Fatal(err)
336 }
337 res.Body.Close()
338 if b.Status().RetentionDays != 12 {
339 t.Fatalf("formulier in BlueGit: %d", b.Status().RetentionDays)
340 }
341 res, _ = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/archive", url.Values{"csrf": {csrf}})
342 res.Body.Close()
343 if len(b.Archives()) != 1 {
344 t.Fatal("archief via het BlueGit-formulier ontbreekt")
345 }
346 }
347
348 // Feature: één BlueGit kan meerdere backup servers hebben; elke backup server hoort bij één BlueGit.
349 func TestMultipleBackupServers(t *testing.T) {
350 g := startBlueGit(t)
351 g.Project("Alpha", "README.md", "v1")
352 b1, b2 := startBackup(t, nil), startBackup(t, nil)
353 id1, key1 := g.AddServer("nas")
354 id2, key2 := g.AddServer("offsite")
355 b1.Connect(g, key1)
356 b2.Connect(g, key2)
357 for _, id := range []string{id1, id2} {
358 if st := g.ServerStatus(id); !st.Connected || st.RemoteError != "" {
359 t.Fatalf("%s: %+v", id, st)
360 }
361 }
362 if g.ServerStatus(id1).ServerURL != b1.URL || g.ServerStatus(id2).ServerURL != b2.URL {
363 t.Fatal("adressen verwisseld")
364 }
365 // Elke wijziging komt bij beide aan.
366 g.Commit("alpha", "beide.txt", "x", "create")
367 for _, b := range []*Backup{b1, b2} {
368 Eventually(t, 15*time.Second, "melding bij "+b.URL, func() bool {
369 return strings.Contains(gitLog(t, b.Mirror("data/repos/tim/alpha.git")), "zet beide.txt")
370 })
371 }
372 // Een key hoort bij één server: key1 werkt niet voor de tweede server.
373 b3 := startBackup(t, nil)
374 b3.Connect(g, key1) // dezelfde key: BlueGit verplaatst de koppeling van nas naar b3
375 if st := g.ServerStatus(id1); st.ServerURL != b3.URL {
376 t.Fatalf("koppeling niet verplaatst: %+v", st)
377 }
378 // Verwijderen in BlueGit ontkoppelt alleen die server.
379 if code, raw := g.API("DELETE", "/admin/backup/servers/"+id2, nil); code != 204 {
380 t.Fatalf("verwijderen: %d %s", code, raw)
381 }
382 if b2.Status().Connected {
383 t.Fatal("verwijderde backup server is nog gekoppeld")
384 }
385 g.Commit("alpha", "daarna.txt", "x", "create")
386 Eventually(t, 15*time.Second, "overgebleven server krijgt meldingen", func() bool {
387 return strings.Contains(gitLog(t, b3.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt")
388 })
389 time.Sleep(time.Second)
390 if strings.Contains(gitLog(t, b2.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt") {
391 t.Fatal("verwijderde server synchroniseert nog")
392 }
393 // Een backup server hoort bij één BlueGit: koppelen aan een andere vraagt om een keuze.
394 other := startBlueGit(t)
395 code, raw := b3.Admin("POST", "/connect", map[string]any{"url": other.URL, "key": other.NewKey()})
396 if code != 409 || !strings.Contains(string(raw), `"choices":["wipe","restore"]`) {
397 t.Fatalf("tweede BlueGit: %d %s", code, raw)
398 }
399 }
@@ -0,0 +1,399 @@
1//go:build integration
2
3package integration
4
5import (
6 "encoding/json"
7 "io"
8 "net/http"
9 "net/http/cookiejar"
10 "net/url"
11 "os"
12 "path/filepath"
13 "sort"
14 "strings"
15 "testing"
16 "time"
17)
18
19// webUI is een browser op de webinterface van de backup server.
20type webUI struct {
21 t *testing.T
22 b *Backup
23 hc *http.Client
24 csrf string
25}
26
27func openUI(t *testing.T, b *Backup) *webUI {
28 t.Helper()
29 jar, _ := cookiejar.New(nil)
30 u := &webUI{t: t, b: b, hc: &http.Client{Jar: jar, CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}}
31 res, err := u.hc.Get(b.URL + "/")
32 if err != nil {
33 t.Fatal(err)
34 }
35 res.Body.Close()
36 if res.StatusCode != 303 || res.Header.Get("Location") != "/login" {
37 t.Fatalf("zonder login: %d %s", res.StatusCode, res.Header.Get("Location"))
38 }
39 res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {"bba_fout"}})
40 res.Body.Close()
41 if res.Header.Get("Location") != "/login?fout=1" {
42 t.Fatal("fout token geaccepteerd")
43 }
44 res, _ = u.hc.PostForm(b.URL+"/login", url.Values{"token": {b.Srv.AdminToken()}})
45 res.Body.Close()
46 if res.StatusCode != 303 || res.Header.Get("Location") != "/" {
47 t.Fatalf("login: %d", res.StatusCode)
48 }
49 u.Page()
50 return u
51}
52
53// Page haalt de hoofdpagina op en onthoudt het CSRF-token.
54func (u *webUI) Page() string {
55 u.t.Helper()
56 res, err := u.hc.Get(u.b.URL + "/")
57 if err != nil {
58 u.t.Fatal(err)
59 }
60 b, _ := io.ReadAll(res.Body)
61 res.Body.Close()
62 if res.StatusCode != 200 {
63 u.t.Fatalf("pagina: %d", res.StatusCode)
64 }
65 u.csrf = between(string(b), `name="csrf" value="`, `"`)
66 return string(b)
67}
68
69// Act verstuurt het formulier van een actie en geeft de melding erna.
70func (u *webUI) Act(name string, form url.Values) string {
71 u.t.Helper()
72 if form == nil {
73 form = url.Values{}
74 }
75 form.Set("csrf", u.csrf)
76 res, err := u.hc.PostForm(u.b.URL+"/ui/act/"+name, form)
77 if err != nil {
78 u.t.Fatal(err)
79 }
80 res.Body.Close()
81 if res.StatusCode != 303 {
82 u.t.Fatalf("%s: %d", name, res.StatusCode)
83 }
84 return between(u.Page(), `role="status">`, `</div>`)
85}
86
87func actionNames(t *testing.T, b *Backup, withGet bool) []string {
88 t.Helper()
89 code, raw := b.Admin("GET", "/actions", nil)
90 if code != 200 {
91 t.Fatalf("actions: %d", code)
92 }
93 var out struct {
94 Actions []struct{ Name, Method string }
95 }
96 _ = json.Unmarshal(raw, &out)
97 var names []string
98 for _, a := range out.Actions {
99 if withGet || a.Method != "GET" {
100 names = append(names, a.Name)
101 }
102 }
103 sort.Strings(names)
104 return names
105}
106
107func requireAll(t *testing.T, what string, want []string, done map[string]bool) {
108 t.Helper()
109 for _, n := range want {
110 if !done[n] {
111 t.Errorf("%s: actie %s niet getest", what, n)
112 }
113 }
114}
115
116// Feature: alles is in te stellen en te bedienen via de webinterface (poort 8080 standaard).
117func TestWebUIConfiguresAndOperatesEverything(t *testing.T) {
118 g := startBlueGit(t)
119 g.Project("Alpha", "README.md", "v1")
120 b := startBackup(t, nil)
121 u := openUI(t, b)
122 done := map[string]bool{}
123
124 // Instellingen.
125 msg := u.Act("config.update", url.Values{"archive_interval": {"3h"}, "retention_days": {"5"}, "rate_limit_kib": {"2048"}, "min_free_mb": {"2"}, "full_sync_interval": {"2h"}, "min_sync_interval": {"1s"}, "public_url": {b.URL}, "listen": {b.Cfg.Listen}})
126 if !strings.Contains(msg, "opgeslagen") {
127 t.Fatalf("instellingen: %q", msg)
128 }
129 done["config.update"] = true
130 st := b.Status()
131 if st.Interval != "3h0m0s" || st.RetentionDays != 5 || st.RateLimitKiB != 2048 {
132 t.Fatalf("niet toegepast: %+v", st)
133 }
134 if msg := u.Act("config.update", url.Values{"archive_interval": {"nooit"}}); !strings.Contains(msg, "mislukt") {
135 t.Fatalf("ongeldige waarde: %q", msg)
136 }
137 u.Act("config.update", url.Values{"rate_limit_kib": {"0"}})
138
139 // Koppelen met een key uit BlueGit.
140 if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {"bgbk_fout"}, "on_conflict": {""}}); !strings.Contains(msg, "mislukt") {
141 t.Fatalf("verkeerde key: %q", msg)
142 }
143 if msg := u.Act("connect", url.Values{"url": {g.URL}, "key": {g.NewKey()}, "on_conflict": {""}}); !strings.Contains(msg, "gelukt") {
144 t.Fatalf("koppelen: %q", msg)
145 }
146 done["connect"] = true
147 if st := g.BackupStatus(); !st.Connected || st.ServerURL != b.URL {
148 t.Fatalf("BlueGit ziet de koppeling niet: %+v", st)
149 }
150
151 // Sync, archief, opruimen.
152 if msg := u.Act("sync", nil); !strings.Contains(msg, "gestart") {
153 t.Fatalf("sync: %q", msg)
154 }
155 done["sync"] = true
156 Eventually(t, 15*time.Second, "kopie na sync uit de webinterface", func() bool {
157 _, err := os.Stat(b.Mirror("data/repos/tim/alpha.git/HEAD"))
158 return err == nil
159 })
160 b.Sync()
161 if msg := u.Act("archive", nil); !strings.Contains(msg, "Archief gemaakt") {
162 t.Fatalf("archief: %q", msg)
163 }
164 done["archive"] = true
165 name := b.Archives()[0]
166 page := u.Page()
167 if !strings.Contains(page, name) || !strings.Contains(page, "gekoppeld") {
168 t.Fatal("pagina toont het archief of de koppeling niet")
169 }
170 // Download vanuit de pagina.
171 res, err := u.hc.Get(b.URL + "/api/v1/admin/archives/" + name + "/download")
172 if err != nil {
173 t.Fatal(err)
174 }
175 got, _ := io.ReadAll(res.Body)
176 res.Body.Close()
177 want, _ := os.ReadFile(filepath.Join(b.Dir, "archives", name))
178 if res.StatusCode != 200 || len(got) == 0 || string(got) != string(want) {
179 t.Fatalf("download: %d %d bytes", res.StatusCode, len(got))
180 }
181 if msg := u.Act("prune", nil); !strings.Contains(msg, "Opgeruimd") {
182 t.Fatalf("opruimen: %q", msg)
183 }
184 done["prune"] = true
185
186 // Rollback vanuit de webinterface: zonder vinkje niets, daarna echt.
187 g.Commit("alpha", "README.md", "v2", "update")
188 b.Sync()
189 if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}}); !strings.Contains(msg, "Vink aan") {
190 t.Fatalf("zonder vinkje: %q", msg)
191 }
192 if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {"verkeerd"}, "understood": {"1"}}); !strings.Contains(msg, "mislukt") {
193 t.Fatalf("verkeerde bevestiging: %q", msg)
194 }
195 if msg := u.Act("rollback", url.Values{"archive": {name}, "confirm": {name}, "understood": {"1"}}); !strings.Contains(msg, "Rollback gestart") {
196 t.Fatalf("rollback: %q", msg)
197 }
198 done["rollback"] = true
199 Eventually(t, 60*time.Second, "rollback klaar", func() bool {
200 st := b.Status().Rollback
201 if st.State == "failed" {
202 t.Fatalf("rollback mislukt: %s", st.Error)
203 }
204 return st.State == "done"
205 })
206 g.WaitUp(30 * time.Second)
207 if _, s := g.File("alpha", "README.md"); s != "v1" {
208 t.Fatalf("README na rollback: %q", s)
209 }
210
211 // Archief verwijderen en ontkoppelen.
212 if msg := u.Act("archive.delete", url.Values{"name": {name}}); !strings.Contains(msg, "gelukt") {
213 t.Fatalf("verwijderen: %q", msg)
214 }
215 done["archive.delete"] = true
216 if len(b.Archives()) != 0 {
217 t.Fatal("archief staat er nog")
218 }
219 if msg := u.Act("disconnect", nil); !strings.Contains(msg, "gelukt") {
220 t.Fatalf("ontkoppelen: %q", msg)
221 }
222 done["disconnect"] = true
223 if b.Status().Connected {
224 t.Fatal("nog gekoppeld")
225 }
226 requireAll(t, "webinterface", actionNames(t, b, false), done)
227}
228
229// Feature: de API kan alles wat de webinterface kan, en andersom.
230func TestAPIDoesEverythingTheUICan(t *testing.T) {
231 g := startBlueGit(t)
232 g.Project("Alpha", "README.md", "v1")
233 b := startBackup(t, nil)
234 done := map[string]bool{}
235 call := func(name, method, path string, in any, want int) []byte {
236 t.Helper()
237 code, raw := b.Admin(method, path, in)
238 if code != want {
239 t.Fatalf("%s %s: %d %s", method, path, code, raw)
240 }
241 done[name] = true
242 return raw
243 }
244 call("status", "GET", "/status", nil, 200)
245 call("actions", "GET", "/actions", nil, 200)
246 raw := call("config", "GET", "/config", nil, 200)
247 if !strings.Contains(string(raw), `"key":"listen"`) {
248 t.Fatalf("config: %s", raw)
249 }
250 call("config.update", "PUT", "/config", map[string]any{"retention_days": 7, "archive_interval": "6h"}, 200)
251 if b.Status().RetentionDays != 7 {
252 t.Fatal("config niet toegepast")
253 }
254 call("connect", "POST", "/connect", map[string]any{"url": g.URL, "key": g.NewKey()}, 200)
255 call("sync", "POST", "/sync", nil, 200)
256 raw = call("archive", "POST", "/archive", nil, 201)
257 var a struct{ Name string }
258 _ = json.Unmarshal(raw, &a)
259 raw = call("archives", "GET", "/archives", nil, 200)
260 if !strings.Contains(string(raw), a.Name) {
261 t.Fatalf("archives: %s", raw)
262 }
263 raw = call("archive.download", "GET", "/archives/"+a.Name+"/download", nil, 200)
264 if len(raw) < 100 || raw[0] != 0x1f || raw[1] != 0x8b {
265 t.Fatal("download is geen gzip")
266 }
267 call("prune", "POST", "/prune", nil, 200)
268 call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name}, 400) // bevestiging ontbreekt
269 call("rollback", "POST", "/rollback", map[string]any{"archive": a.Name, "confirm": a.Name}, 202)
270 Eventually(t, 60*time.Second, "rollback klaar", func() bool { return b.Status().Rollback.State == "done" })
271 g.WaitUp(30 * time.Second)
272 call("archive.delete", "DELETE", "/archives/"+a.Name, nil, 200)
273 call("disconnect", "POST", "/disconnect", nil, 200)
274 requireAll(t, "API", actionNames(t, b, true), done)
275}
276
277// Feature: vanuit BlueGit is de backup server te bedienen zoals in zijn eigen webinterface.
278func TestBlueGitControlsBackupServer(t *testing.T) {
279 g := startBlueGit(t)
280 g.Project("Alpha", "README.md", "v1")
281 b := startBackup(t, nil)
282 b.Connect(g, g.NewKey())
283 b.Sync()
284
285 // Instellingen lezen en wijzigen via de BlueGit-API.
286 st := g.BackupStatus()
287 if len(st.Config.Fields) == 0 {
288 t.Fatalf("BlueGit ziet geen instellingen: %+v", st)
289 }
290 if code, raw := g.Action(g.Server, "config.update", map[string]any{"retention_days": "11", "archive_interval": "5h"}); code != 200 {
291 t.Fatalf("config via BlueGit: %d %s", code, raw)
292 }
293 if s := b.Status(); s.RetentionDays != 11 || s.Interval != "5h0m0s" {
294 t.Fatalf("niet toegepast: %+v", s)
295 }
296 // Archief maken, synchroniseren en verwijderen via BlueGit.
297 if code, raw := g.Action(g.Server, "archive", nil); code != 201 {
298 t.Fatalf("archief via BlueGit: %d %s", code, raw)
299 }
300 name := b.Archives()[0]
301 g.Commit("alpha", "x.txt", "x", "create")
302 before := b.Status().Syncs
303 if code, raw := g.Action(g.Server, "sync", nil); code != 202 {
304 t.Fatalf("sync via BlueGit: %d %s", code, raw)
305 }
306 Eventually(t, 15*time.Second, "sync gestart door BlueGit", func() bool { return b.Status().Syncs > before })
307 if code, raw := g.Action(g.Server, "archive.delete", map[string]any{"name": name}); code != 200 {
308 t.Fatalf("verwijderen via BlueGit: %d %s", code, raw)
309 }
310 if len(b.Archives()) != 0 {
311 t.Fatal("archief niet verwijderd")
312 }
313 // Koppelen kan BlueGit niet namens de backup server (alleen lokaal).
314 if code, _ := g.Action(g.Server, "connect", map[string]any{"url": g.URL, "key": "bgbk_x"}); code != 404 {
315 t.Fatalf("connect via BlueGit: %d", code)
316 }
317
318 // Dezelfde bediening in de BlueGit-webinterface.
319 hc := g.Session()
320 hc.CheckRedirect = func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }
321 res, err := hc.Get(g.URL + "/admin/backup/s/" + g.Server)
322 if err != nil {
323 t.Fatal(err)
324 }
325 page, _ := io.ReadAll(res.Body)
326 res.Body.Close()
327 for _, want := range []string{`name="retention_days" value="11"`, "/act/sync", "/act/archive", "/act/prune", "/act/config.update"} {
328 if !strings.Contains(string(page), want) {
329 t.Fatalf("BlueGit-pagina mist %q", want)
330 }
331 }
332 csrf := between(string(page), `name="csrf" value="`, `"`)
333 res, err = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"12"}})
334 if err != nil {
335 t.Fatal(err)
336 }
337 res.Body.Close()
338 if b.Status().RetentionDays != 12 {
339 t.Fatalf("formulier in BlueGit: %d", b.Status().RetentionDays)
340 }
341 res, _ = hc.PostForm(g.URL+"/admin/backup/s/"+g.Server+"/act/archive", url.Values{"csrf": {csrf}})
342 res.Body.Close()
343 if len(b.Archives()) != 1 {
344 t.Fatal("archief via het BlueGit-formulier ontbreekt")
345 }
346}
347
348// Feature: één BlueGit kan meerdere backup servers hebben; elke backup server hoort bij één BlueGit.
349func TestMultipleBackupServers(t *testing.T) {
350 g := startBlueGit(t)
351 g.Project("Alpha", "README.md", "v1")
352 b1, b2 := startBackup(t, nil), startBackup(t, nil)
353 id1, key1 := g.AddServer("nas")
354 id2, key2 := g.AddServer("offsite")
355 b1.Connect(g, key1)
356 b2.Connect(g, key2)
357 for _, id := range []string{id1, id2} {
358 if st := g.ServerStatus(id); !st.Connected || st.RemoteError != "" {
359 t.Fatalf("%s: %+v", id, st)
360 }
361 }
362 if g.ServerStatus(id1).ServerURL != b1.URL || g.ServerStatus(id2).ServerURL != b2.URL {
363 t.Fatal("adressen verwisseld")
364 }
365 // Elke wijziging komt bij beide aan.
366 g.Commit("alpha", "beide.txt", "x", "create")
367 for _, b := range []*Backup{b1, b2} {
368 Eventually(t, 15*time.Second, "melding bij "+b.URL, func() bool {
369 return strings.Contains(gitLog(t, b.Mirror("data/repos/tim/alpha.git")), "zet beide.txt")
370 })
371 }
372 // Een key hoort bij één server: key1 werkt niet voor de tweede server.
373 b3 := startBackup(t, nil)
374 b3.Connect(g, key1) // dezelfde key: BlueGit verplaatst de koppeling van nas naar b3
375 if st := g.ServerStatus(id1); st.ServerURL != b3.URL {
376 t.Fatalf("koppeling niet verplaatst: %+v", st)
377 }
378 // Verwijderen in BlueGit ontkoppelt alleen die server.
379 if code, raw := g.API("DELETE", "/admin/backup/servers/"+id2, nil); code != 204 {
380 t.Fatalf("verwijderen: %d %s", code, raw)
381 }
382 if b2.Status().Connected {
383 t.Fatal("verwijderde backup server is nog gekoppeld")
384 }
385 g.Commit("alpha", "daarna.txt", "x", "create")
386 Eventually(t, 15*time.Second, "overgebleven server krijgt meldingen", func() bool {
387 return strings.Contains(gitLog(t, b3.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt")
388 })
389 time.Sleep(time.Second)
390 if strings.Contains(gitLog(t, b2.Mirror("data/repos/tim/alpha.git")), "zet daarna.txt") {
391 t.Fatal("verwijderde server synchroniseert nog")
392 }
393 // Een backup server hoort bij één BlueGit: koppelen aan een andere vraagt om een keuze.
394 other := startBlueGit(t)
395 code, raw := b3.Admin("POST", "/connect", map[string]any{"url": other.URL, "key": other.NewKey()})
396 if code != 409 || !strings.Contains(string(raw), `"choices":["wipe","restore"]`) {
397 t.Fatalf("tweede BlueGit: %d %s", code, raw)
398 }
399}
internal/backupserver/server/actions.go added +452 −0
@@ -0,0 +1,452 @@
1 package server
2
3 import (
4 "context"
5 "crypto/subtle"
6 "encoding/json"
7 "errors"
8 "fmt"
9 "io"
10 "net/http"
11 "sort"
12 "strconv"
13 "strings"
14
15 "git.timfalken.com/timfa/bluegit-backup/internal/archive"
16 "git.timfalken.com/timfa/bluegit-backup/internal/config"
17 "git.timfalken.com/timfa/bluegit-backup/internal/mirror"
18 "git.timfalken.com/timfa/bluegit-backup/internal/protocol"
19 )
20
21 // Input is de invoer van een actie: JSON-velden, querystring, formulier of
22 // padwaarden, allemaal als tekst.
23 type Input map[string]string
24
25 // Action is één beheerhandeling. De API, de webinterface en BlueGit lopen
26 // allemaal via deze lijst, zodat ze precies hetzelfde kunnen.
27 type Action struct {
28 // Name is de naam in de webinterface (/ui/act/<name>).
29 Name string `json:"name"`
30 Method string `json:"method"`
31 Path string `json:"path"`
32 // Title is de knoptekst of beschrijving.
33 Title string `json:"title"`
34 // Signed: ook de gekoppelde BlueGit mag dit (ondertekend verzoek).
35 Signed bool `json:"bluegit"`
36 // Params zijn de padwaarden, bijvoorbeeld {name}.
37 Params []string `json:"params,omitempty"`
38 // Fields zijn de invoervelden (documentatie en de lijst in /api/v1/admin/actions).
39 Fields []string `json:"fields,omitempty"`
40 Do func(ctx context.Context, in Input) (int, any) `json:"-"`
41 }
42
43 // fileResult laat de API een bestand sturen in plaats van JSON.
44 type fileResult struct{ path, name string }
45
46 func errBody(err error) map[string]string { return map[string]string{"error": err.Error()} }
47
48 // Actions is de volledige lijst met beheerhandelingen.
49 func (s *Server) Actions() []Action {
50 return []Action{
51 {Name: "status", Method: "GET", Path: "/api/v1/admin/status", Title: "Status", Signed: true,
52 Do: func(ctx context.Context, in Input) (int, any) { return 200, s.Status() }},
53 {Name: "actions", Method: "GET", Path: "/api/v1/admin/actions", Title: "Alle acties", Signed: true,
54 Do: func(ctx context.Context, in Input) (int, any) { return 200, map[string]any{"actions": s.Actions()} }},
55 {Name: "config", Method: "GET", Path: "/api/v1/admin/config", Title: "Instellingen", Signed: true,
56 Do: func(ctx context.Context, in Input) (int, any) { return 200, s.ConfigView() }},
57 {Name: "config.update", Method: "PUT", Path: "/api/v1/admin/config", Title: "Instellingen opslaan", Signed: true,
58 Fields: fieldKeys(), Do: s.actConfigUpdate},
59 {Name: "connect", Method: "POST", Path: "/api/v1/admin/connect", Title: "Koppelen",
60 Fields: []string{"url", "key", "on_conflict"}, Do: s.actConnect},
61 {Name: "disconnect", Method: "POST", Path: "/api/v1/admin/disconnect", Title: "Ontkoppelen", Signed: true,
62 Do: s.actDisconnect},
63 {Name: "sync", Method: "POST", Path: "/api/v1/admin/sync", Title: "Nu synchroniseren", Signed: true,
64 Fields: []string{"wait"}, Do: s.actSync},
65 {Name: "archive", Method: "POST", Path: "/api/v1/admin/archive", Title: "Nu archiveren", Signed: true,
66 Do: func(ctx context.Context, in Input) (int, any) {
67 a, err := s.ArchiveNow()
68 if err != nil {
69 return 409, errBody(err)
70 }
71 return 201, a
72 }},
73 {Name: "prune", Method: "POST", Path: "/api/v1/admin/prune", Title: "Nu opruimen", Signed: true,
74 Do: func(ctx context.Context, in Input) (int, any) {
75 removed, err := s.Prune()
76 if err != nil {
77 return 500, errBody(err)
78 }
79 if removed == nil {
80 removed = []string{}
81 }
82 return 200, map[string]any{"removed": removed}
83 }},
84 {Name: "archives", Method: "GET", Path: "/api/v1/admin/archives", Title: "Archieven", Signed: true,
85 Do: func(ctx context.Context, in Input) (int, any) {
86 list, err := s.archives.List()
87 if err != nil {
88 return 500, errBody(err)
89 }
90 return 200, map[string]any{"archives": list}
91 }},
92 {Name: "archive.download", Method: "GET", Path: "/api/v1/admin/archives/{name}/download", Title: "Downloaden",
93 Params: []string{"name"}, Do: func(ctx context.Context, in Input) (int, any) {
94 p, err := s.archives.Path(in["name"])
95 if err != nil {
96 return 404, errBody(err)
97 }
98 return 200, fileResult{path: p, name: in["name"]}
99 }},
100 {Name: "archive.delete", Method: "DELETE", Path: "/api/v1/admin/archives/{name}", Title: "Verwijderen", Signed: true,
101 Params: []string{"name"}, Do: s.actArchiveDelete},
102 {Name: "rollback", Method: "POST", Path: "/api/v1/admin/rollback", Title: "Rollback", Signed: true,
103 Fields: []string{"archive", "confirm"}, Do: s.actRollback},
104 }
105 }
106
107 func fieldKeys() []string {
108 out := make([]string, 0, len(config.Fields))
109 for _, f := range config.Fields {
110 out = append(out, f.Key)
111 }
112 return out
113 }
114
115 func (s *Server) action(name string) (Action, bool) {
116 for _, a := range s.Actions() {
117 if a.Name == name {
118 return a, true
119 }
120 }
121 return Action{}, false
122 }
123
124 // ConfigView is GET /api/v1/admin/config.
125 type ConfigView struct {
126 Fields []ConfigField `json:"fields"`
127 DataDir string `json:"data_dir"`
128 // Restart: er staat een wijziging klaar die pas na een herstart geldt.
129 Restart bool `json:"restart_pending"`
130 }
131
132 // ConfigField is een veld met zijn waarde.
133 type ConfigField struct {
134 config.Field
135 Value string `json:"value"`
136 }
137
138 // ConfigView geeft alle instellingen met hun huidige waarde.
139 func (s *Server) ConfigView() ConfigView {
140 s.mu.Lock()
141 defer s.mu.Unlock()
142 v := ConfigView{DataDir: s.Cfg.DataDir, Restart: s.restartPending}
143 for _, f := range config.Fields {
144 val := s.Cfg.Get(f.Key)
145 if f.Restart {
146 if p, ok := s.settings[f.Key]; ok {
147 val = p
148 }
149 }
150 v.Fields = append(v.Fields, ConfigField{Field: f, Value: val})
151 }
152 return v
153 }
154
155 // UpdateConfig past instellingen toe en bewaart ze in settings.yml. Velden
156 // met Restart gelden pas na een herstart.
157 func (s *Server) UpdateConfig(set map[string]string) (ConfigView, error) {
158 s.mu.Lock()
159 next := s.Cfg
160 if err := next.Apply(set); err != nil {
161 s.mu.Unlock()
162 return ConfigView{}, err
163 }
164 merged := map[string]string{}
165 for k, v := range s.settings {
166 merged[k] = v
167 }
168 for k := range set {
169 merged[k] = next.Get(k)
170 }
171 if err := config.SaveSettings(next.DataDir, merged); err != nil {
172 s.mu.Unlock()
173 return ConfigView{}, err
174 }
175 for _, f := range config.Fields {
176 if f.Restart {
177 if _, ok := set[f.Key]; ok && next.Get(f.Key) != s.Cfg.Get(f.Key) {
178 s.restartPending = true
179 }
180 // De draaiende waarde blijft tot de herstart.
181 _ = next.Set(f.Key, s.Cfg.Get(f.Key))
182 }
183 }
184 s.settings = merged
185 s.Cfg = next
186 s.mu.Unlock()
187 s.limiter.SetRate(next.RateLimitKiB << 10)
188 keys := make([]string, 0, len(set))
189 for k := range set {
190 keys = append(keys, k)
191 }
192 sort.Strings(keys)
193 s.Log.Info("instellingen gewijzigd", "keys", strings.Join(keys, ","))
194 // Kortere intervallen meteen laten gelden.
195 s.Kick()
196 return s.ConfigView(), nil
197 }
198
199 func (s *Server) actConfigUpdate(ctx context.Context, in Input) (int, any) {
200 set := map[string]string{}
201 for k, v := range in {
202 set[k] = v
203 }
204 if len(set) == 0 {
205 return 400, errBody(errors.New("geen instellingen meegegeven"))
206 }
207 v, err := s.UpdateConfig(set)
208 if err != nil {
209 return 400, errBody(err)
210 }
211 return 200, v
212 }
213
214 func (s *Server) actConnect(ctx context.Context, in Input) (int, any) {
215 res, conflict, err := s.Connect(ctx, ConnectRequest{URL: in["url"], Key: in["key"], OnConflict: in["on_conflict"]})
216 if conflict != nil {
217 return http.StatusConflict, conflict
218 }
219 if err != nil {
220 var he *mirror.HTTPError
221 code := 502
222 if errors.As(err, &he) && he.Status == 401 {
223 code = 401
224 }
225 if errors.Is(err, errBadRequest) {
226 code = 400
227 }
228 return code, errBody(err)
229 }
230 return 200, res
231 }
232
233 // Disconnect vergeet de gekoppelde BlueGit. De kopie en de archieven blijven
234 // staan; een volgende koppeling met een andere BlueGit vraagt dan weer om
235 // wissen of herstellen.
236 func (s *Server) Disconnect() error {
237 s.work.Lock()
238 defer s.work.Unlock()
239 st := s.getState()
240 keep := State{InstanceID: st.InstanceID, BlueGitURL: st.BlueGitURL}
241 if err := saveState(s.Cfg.DataDir, keep); err != nil {
242 return err
243 }
244 s.mu.Lock()
245 s.state = keep
246 s.mu.Unlock()
247 s.Log.Warn("ontkoppeld", "bluegit", st.BlueGitURL)
248 return nil
249 }
250
251 func (s *Server) actDisconnect(ctx context.Context, in Input) (int, any) {
252 if !s.getState().Connected() {
253 return 409, errBody(errors.New("er is geen BlueGit gekoppeld"))
254 }
255 if err := s.Disconnect(); err != nil {
256 return 500, errBody(err)
257 }
258 return 200, map[string]any{"connected": false}
259 }
260
261 func (s *Server) actSync(ctx context.Context, in Input) (int, any) {
262 if !s.getState().Connected() {
263 return 409, errBody(errors.New("geen BlueGit gekoppeld"))
264 }
265 if in["wait"] == "false" || in["wait"] == "0" {
266 s.Kick()
267 return 202, map[string]string{"state": "started"}
268 }
269 stats, err := s.SyncNow(ctx)
270 if err != nil {
271 return 502, errBody(err)
272 }
273 return 200, stats
274 }
275
276 func (s *Server) actArchiveDelete(ctx context.Context, in Input) (int, any) {
277 name := in["name"]
278 if !archive.ValidName(name) {
279 return 400, errBody(errors.New("ongeldige archiefnaam"))
280 }
281 s.work.Lock()
282 err := s.archives.Delete(name)
283 s.work.Unlock()
284 if err != nil {
285 return 404, errBody(err)
286 }
287 s.Log.Info("archief verwijderd met de hand", "archive", name)
288 return 200, map[string]string{"deleted": name}
289 }
290
291 func (s *Server) actRollback(ctx context.Context, in Input) (int, any) {
292 name := in["archive"]
293 if !archive.ValidName(name) {
294 return 400, errBody(errors.New("ongeldige archiefnaam"))
295 }
296 if in["confirm"] != name {
297 return 400, errBody(errors.New("bevestig met de archiefnaam in confirm; een rollback kan niet ongedaan worden gemaakt"))
298 }
299 return s.startRollback(name)
300 }
301
302 // startRollback start een rollback op de achtergrond.
303 func (s *Server) startRollback(name string) (int, any) {
304 if _, err := s.archives.Path(name); err != nil {
305 return 404, errBody(err)
306 }
307 if !s.getState().Connected() {
308 return 409, errBody(errors.New("geen BlueGit gekoppeld"))
309 }
310 s.mu.Lock()
311 busy := s.rollback.State == "running"
312 if !busy {
313 s.rollback = RollbackStatus{State: "running", Archive: name, At: s.now().UTC()}
314 }
315 s.mu.Unlock()
316 if busy {
317 return 409, errBody(errors.New("er loopt al een rollback"))
318 }
319 s.Log.Warn("rollback gestart", "archive", name)
320 go func() {
321 if err := s.Rollback(context.Background(), name); err != nil {
322 s.Log.Error("rollback mislukt", "archive", name, "err", err)
323 }
324 }()
325 return http.StatusAccepted, map[string]string{"state": "running", "archive": name}
326 }
327
328 // ---------- HTTP ----------
329
330 // Handler is de webinterface en de HTTP-API.
331 func (s *Server) Handler() http.Handler {
332 mux := http.NewServeMux()
333 mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })
334 // Van BlueGit, ondertekend (vaste protocolroutes).
335 mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))
336 mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))
337 mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))
338 mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))
339 // Beheer: admin.token, een sessie van de webinterface, of BlueGit.
340 for _, a := range s.Actions() {
341 mux.HandleFunc(a.Method+" "+a.Path, s.apiAction(a))
342 }
343 mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)
344 s.mountUI(mux)
345 return securityHeaders(mux)
346 }
347
348 func securityHeaders(h http.Handler) http.Handler {
349 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
350 w.Header().Set("X-Content-Type-Options", "nosniff")
351 w.Header().Set("Referrer-Policy", "same-origin")
352 h.ServeHTTP(w, r)
353 })
354 }
355
356 // apiAction voert een actie uit voor de API.
357 func (s *Server) apiAction(a Action) http.HandlerFunc {
358 return func(w http.ResponseWriter, r *http.Request) {
359 body, err := io.ReadAll(io.LimitReader(r.Body, 1<<20))
360 if err != nil {
361 writeErr(w, 400, "body")
362 return
363 }
364 if code, msg := s.authorize(r, a, body); code != 0 {
365 writeErr(w, code, msg)
366 return
367 }
368 in, err := parseInput(r, body)
369 if err != nil {
370 writeErr(w, 400, err.Error())
371 return
372 }
373 for _, p := range a.Params {
374 in[p] = r.PathValue(p)
375 }
376 code, out := a.Do(r.Context(), in)
377 if f, ok := out.(fileResult); ok {
378 w.Header().Set("Content-Type", "application/gzip")
379 w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%q", f.name))
380 http.ServeFile(w, r, f.path)
381 return
382 }
383 writeJSON(w, code, out)
384 }
385 }
386
387 // authorize: 0 is toegestaan, anders de foutcode.
388 func (s *Server) authorize(r *http.Request, a Action, body []byte) (int, string) {
389 if tok, ok := strings.CutPrefix(r.Header.Get("Authorization"), "Bearer "); ok {
390 if subtle.ConstantTimeCompare([]byte(strings.TrimSpace(tok)), []byte(s.adminToken)) == 1 {
391 return 0, ""
392 }
393 return 401, "ongeldig token"
394 }
395 if r.Header.Get(protocol.HeaderSignature) != "" {
396 if !a.Signed {
397 return 403, "BlueGit mag dit niet"
398 }
399 st := s.getState()
400 if !st.Connected() {
401 return 401, "niet gekoppeld"
402 }
403 if r.Header.Get(protocol.HeaderInstance) != st.InstanceID {
404 return 401, "andere BlueGit-instantie"
405 }
406 if err := protocol.Verify(r, protocol.SigningSecret(st.Key), body, s.now()); err != nil {
407 return 401, err.Error()
408 }
409 return 0, ""
410 }
411 if sess, ok := s.session(r); ok {
412 if r.Method != http.MethodGet && r.Method != http.MethodHead {
413 if subtle.ConstantTimeCompare([]byte(r.Header.Get("X-CSRF-Token")), []byte(sess.csrf)) != 1 {
414 return 403, "X-CSRF-Token ontbreekt of klopt niet"
415 }
416 }
417 return 0, ""
418 }
419 return 401, "admin.token, sessie of BlueGit-handtekening nodig"
420 }
421
422 // parseInput leest de querystring en een JSON-object (waarden als tekst).
423 func parseInput(r *http.Request, body []byte) (Input, error) {
424 in := Input{}
425 for k, v := range r.URL.Query() {
426 if len(v) > 0 {
427 in[k] = v[0]
428 }
429 }
430 if len(strings.TrimSpace(string(body))) == 0 {
431 return in, nil
432 }
433 var raw map[string]any
434 if err := json.Unmarshal(body, &raw); err != nil {
435 return nil, errors.New("ongeldige JSON: verwacht een object")
436 }
437 for k, v := range raw {
438 switch t := v.(type) {
439 case string:
440 in[k] = t
441 case float64:
442 in[k] = strconv.FormatFloat(t, 'f', -1, 64)
443 case bool:
444 in[k] = strconv.FormatBool(t)
445 case nil:
446 in[k] = ""
447 default:
448 return nil, fmt.Errorf("veld %s: verwacht tekst, getal of boolean", k)
449 }
450 }
451 return in, nil
452 }
@@ -0,0 +1,452 @@
1package server
2
3import (
4 "context"
5 "crypto/subtle"
6 "encoding/json"
7 "errors"
8 "fmt"
9 "io"
10 "net/http"
11 "sort"
12 "strconv"
13 "strings"
14
15 "git.timfalken.com/timfa/bluegit-backup/internal/archive"
16 "git.timfalken.com/timfa/bluegit-backup/internal/config"
17 "git.timfalken.com/timfa/bluegit-backup/internal/mirror"
18 "git.timfalken.com/timfa/bluegit-backup/internal/protocol"
19)
20
21// Input is de invoer van een actie: JSON-velden, querystring, formulier of
22// padwaarden, allemaal als tekst.
23type Input map[string]string
24
25// Action is één beheerhandeling. De API, de webinterface en BlueGit lopen
26// allemaal via deze lijst, zodat ze precies hetzelfde kunnen.
27type Action struct {
28 // Name is de naam in de webinterface (/ui/act/<name>).
29 Name string `json:"name"`
30 Method string `json:"method"`
31 Path string `json:"path"`
32 // Title is de knoptekst of beschrijving.
33 Title string `json:"title"`
34 // Signed: ook de gekoppelde BlueGit mag dit (ondertekend verzoek).
35 Signed bool `json:"bluegit"`
36 // Params zijn de padwaarden, bijvoorbeeld {name}.
37 Params []string `json:"params,omitempty"`
38 // Fields zijn de invoervelden (documentatie en de lijst in /api/v1/admin/actions).
39 Fields []string `json:"fields,omitempty"`
40 Do func(ctx context.Context, in Input) (int, any) `json:"-"`
41}
42
43// fileResult laat de API een bestand sturen in plaats van JSON.
44type fileResult struct{ path, name string }
45
46func errBody(err error) map[string]string { return map[string]string{"error": err.Error()} }
47
48// Actions is de volledige lijst met beheerhandelingen.
49func (s *Server) Actions() []Action {
50 return []Action{
51 {Name: "status", Method: "GET", Path: "/api/v1/admin/status", Title: "Status", Signed: true,
52 Do: func(ctx context.Context, in Input) (int, any) { return 200, s.Status() }},
53 {Name: "actions", Method: "GET", Path: "/api/v1/admin/actions", Title: "Alle acties", Signed: true,
54 Do: func(ctx context.Context, in Input) (int, any) { return 200, map[string]any{"actions": s.Actions()} }},
55 {Name: "config", Method: "GET", Path: "/api/v1/admin/config", Title: "Instellingen", Signed: true,
56 Do: func(ctx context.Context, in Input) (int, any) { return 200, s.ConfigView() }},
57 {Name: "config.update", Method: "PUT", Path: "/api/v1/admin/config", Title: "Instellingen opslaan", Signed: true,
58 Fields: fieldKeys(), Do: s.actConfigUpdate},
59 {Name: "connect", Method: "POST", Path: "/api/v1/admin/connect", Title: "Koppelen",
60 Fields: []string{"url", "key", "on_conflict"}, Do: s.actConnect},
61 {Name: "disconnect", Method: "POST", Path: "/api/v1/admin/disconnect", Title: "Ontkoppelen", Signed: true,
62 Do: s.actDisconnect},
63 {Name: "sync", Method: "POST", Path: "/api/v1/admin/sync", Title: "Nu synchroniseren", Signed: true,
64 Fields: []string{"wait"}, Do: s.actSync},
65 {Name: "archive", Method: "POST", Path: "/api/v1/admin/archive", Title: "Nu archiveren", Signed: true,
66 Do: func(ctx context.Context, in Input) (int, any) {
67 a, err := s.ArchiveNow()
68 if err != nil {
69 return 409, errBody(err)
70 }
71 return 201, a
72 }},
73 {Name: "prune", Method: "POST", Path: "/api/v1/admin/prune", Title: "Nu opruimen", Signed: true,
74 Do: func(ctx context.Context, in Input) (int, any) {
75 removed, err := s.Prune()
76 if err != nil {
77 return 500, errBody(err)
78 }
79 if removed == nil {
80 removed = []string{}
81 }
82 return 200, map[string]any{"removed": removed}
83 }},
84 {Name: "archives", Method: "GET", Path: "/api/v1/admin/archives", Title: "Archieven", Signed: true,
85 Do: func(ctx context.Context, in Input) (int, any) {
86 list, err := s.archives.List()
87 if err != nil {
88 return 500, errBody(err)
89 }
90 return 200, map[string]any{"archives": list}
91 }},
92 {Name: "archive.download", Method: "GET", Path: "/api/v1/admin/archives/{name}/download", Title: "Downloaden",
93 Params: []string{"name"}, Do: func(ctx context.Context, in Input) (int, any) {
94 p, err := s.archives.Path(in["name"])
95 if err != nil {
96 return 404, errBody(err)
97 }
98 return 200, fileResult{path: p, name: in["name"]}
99 }},
100 {Name: "archive.delete", Method: "DELETE", Path: "/api/v1/admin/archives/{name}", Title: "Verwijderen", Signed: true,
101 Params: []string{"name"}, Do: s.actArchiveDelete},
102 {Name: "rollback", Method: "POST", Path: "/api/v1/admin/rollback", Title: "Rollback", Signed: true,
103 Fields: []string{"archive", "confirm"}, Do: s.actRollback},
104 }
105}
106
107func fieldKeys() []string {
108 out := make([]string, 0, len(config.Fields))
109 for _, f := range config.Fields {
110 out = append(out, f.Key)
111 }
112 return out
113}
114
115func (s *Server) action(name string) (Action, bool) {
116 for _, a := range s.Actions() {
117 if a.Name == name {
118 return a, true
119 }
120 }
121 return Action{}, false
122}
123
124// ConfigView is GET /api/v1/admin/config.
125type ConfigView struct {
126 Fields []ConfigField `json:"fields"`
127 DataDir string `json:"data_dir"`
128 // Restart: er staat een wijziging klaar die pas na een herstart geldt.
129 Restart bool `json:"restart_pending"`
130}
131
132// ConfigField is een veld met zijn waarde.
133type ConfigField struct {
134 config.Field
135 Value string `json:"value"`
136}
137
138// ConfigView geeft alle instellingen met hun huidige waarde.
139func (s *Server) ConfigView() ConfigView {
140 s.mu.Lock()
141 defer s.mu.Unlock()
142 v := ConfigView{DataDir: s.Cfg.DataDir, Restart: s.restartPending}
143 for _, f := range config.Fields {
144 val := s.Cfg.Get(f.Key)
145 if f.Restart {
146 if p, ok := s.settings[f.Key]; ok {
147 val = p
148 }
149 }
150 v.Fields = append(v.Fields, ConfigField{Field: f, Value: val})
151 }
152 return v
153}
154
155// UpdateConfig past instellingen toe en bewaart ze in settings.yml. Velden
156// met Restart gelden pas na een herstart.
157func (s *Server) UpdateConfig(set map[string]string) (ConfigView, error) {
158 s.mu.Lock()
159 next := s.Cfg
160 if err := next.Apply(set); err != nil {
161 s.mu.Unlock()
162 return ConfigView{}, err
163 }
164 merged := map[string]string{}
165 for k, v := range s.settings {
166 merged[k] = v
167 }
168 for k := range set {
169 merged[k] = next.Get(k)
170 }
171 if err := config.SaveSettings(next.DataDir, merged); err != nil {
172 s.mu.Unlock()
173 return ConfigView{}, err
174 }
175 for _, f := range config.Fields {
176 if f.Restart {
177 if _, ok := set[f.Key]; ok && next.Get(f.Key) != s.Cfg.Get(f.Key) {
178 s.restartPending = true
179 }
180 // De draaiende waarde blijft tot de herstart.
181 _ = next.Set(f.Key, s.Cfg.Get(f.Key))
182 }
183 }
184 s.settings = merged
185 s.Cfg = next
186 s.mu.Unlock()
187 s.limiter.SetRate(next.RateLimitKiB << 10)
188 keys := make([]string, 0, len(set))
189 for k := range set {
190 keys = append(keys, k)
191 }
192 sort.Strings(keys)
193 s.Log.Info("instellingen gewijzigd", "keys", strings.Join(keys, ","))
194 // Kortere intervallen meteen laten gelden.
195 s.Kick()
196 return s.ConfigView(), nil
197}
198
199func (s *Server) actConfigUpdate(ctx context.Context, in Input) (int, any) {
200 set := map[string]string{}
201 for k, v := range in {
202 set[k] = v
203 }
204 if len(set) == 0 {
205 return 400, errBody(errors.New("geen instellingen meegegeven"))
206 }
207 v, err := s.UpdateConfig(set)
208 if err != nil {
209 return 400, errBody(err)
210 }
211 return 200, v
212}
213
214func (s *Server) actConnect(ctx context.Context, in Input) (int, any) {
215 res, conflict, err := s.Connect(ctx, ConnectRequest{URL: in["url"], Key: in["key"], OnConflict: in["on_conflict"]})
216 if conflict != nil {
217 return http.StatusConflict, conflict
218 }
219 if err != nil {
220 var he *mirror.HTTPError
221 code := 502
222 if errors.As(err, &he) && he.Status == 401 {
223 code = 401
224 }
225 if errors.Is(err, errBadRequest) {
226 code = 400
227 }
228 return code, errBody(err)
229 }
230 return 200, res
231}
232
233// Disconnect vergeet de gekoppelde BlueGit. De kopie en de archieven blijven
234// staan; een volgende koppeling met een andere BlueGit vraagt dan weer om
235// wissen of herstellen.
236func (s *Server) Disconnect() error {
237 s.work.Lock()
238 defer s.work.Unlock()
239 st := s.getState()
240 keep := State{InstanceID: st.InstanceID, BlueGitURL: st.BlueGitURL}
241 if err := saveState(s.Cfg.DataDir, keep); err != nil {
242 return err
243 }
244 s.mu.Lock()
245 s.state = keep
246 s.mu.Unlock()
247 s.Log.Warn("ontkoppeld", "bluegit", st.BlueGitURL)
248 return nil
249}
250
251func (s *Server) actDisconnect(ctx context.Context, in Input) (int, any) {
252 if !s.getState().Connected() {
253 return 409, errBody(errors.New("er is geen BlueGit gekoppeld"))
254 }
255 if err := s.Disconnect(); err != nil {
256 return 500, errBody(err)
257 }
258 return 200, map[string]any{"connected": false}
259}
260
261func (s *Server) actSync(ctx context.Context, in Input) (int, any) {
262 if !s.getState().Connected() {
263 return 409, errBody(errors.New("geen BlueGit gekoppeld"))
264 }
265 if in["wait"] == "false" || in["wait"] == "0" {
266 s.Kick()
267 return 202, map[string]string{"state": "started"}
268 }
269 stats, err := s.SyncNow(ctx)
270 if err != nil {
271 return 502, errBody(err)
272 }
273 return 200, stats
274}
275
276func (s *Server) actArchiveDelete(ctx context.Context, in Input) (int, any) {
277 name := in["name"]
278 if !archive.ValidName(name) {
279 return 400, errBody(errors.New("ongeldige archiefnaam"))
280 }
281 s.work.Lock()
282 err := s.archives.Delete(name)
283 s.work.Unlock()
284 if err != nil {
285 return 404, errBody(err)
286 }
287 s.Log.Info("archief verwijderd met de hand", "archive", name)
288 return 200, map[string]string{"deleted": name}
289}
290
291func (s *Server) actRollback(ctx context.Context, in Input) (int, any) {
292 name := in["archive"]
293 if !archive.ValidName(name) {
294 return 400, errBody(errors.New("ongeldige archiefnaam"))
295 }
296 if in["confirm"] != name {
297 return 400, errBody(errors.New("bevestig met de archiefnaam in confirm; een rollback kan niet ongedaan worden gemaakt"))
298 }
299 return s.startRollback(name)
300}
301
302// startRollback start een rollback op de achtergrond.
303func (s *Server) startRollback(name string) (int, any) {
304 if _, err := s.archives.Path(name); err != nil {
305 return 404, errBody(err)
306 }
307 if !s.getState().Connected() {
308 return 409, errBody(errors.New("geen BlueGit gekoppeld"))
309 }
310 s.mu.Lock()
311 busy := s.rollback.State == "running"
312 if !busy {
313 s.rollback = RollbackStatus{State: "running", Archive: name, At: s.now().UTC()}
314 }
315 s.mu.Unlock()
316 if busy {
317 return 409, errBody(errors.New("er loopt al een rollback"))
318 }
319 s.Log.Warn("rollback gestart", "archive", name)
320 go func() {
321 if err := s.Rollback(context.Background(), name); err != nil {
322 s.Log.Error("rollback mislukt", "archive", name, "err", err)
323 }
324 }()
325 return http.StatusAccepted, map[string]string{"state": "running", "archive": name}
326}
327
328// ---------- HTTP ----------
329
330// Handler is de webinterface en de HTTP-API.
331func (s *Server) Handler() http.Handler {
332 mux := http.NewServeMux()
333 mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })
334 // Van BlueGit, ondertekend (vaste protocolroutes).
335 mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))
336 mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))
337 mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))
338 mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))
339 // Beheer: admin.token, een sessie van de webinterface, of BlueGit.
340 for _, a := range s.Actions() {
341 mux.HandleFunc(a.Method+" "+a.Path, s.apiAction(a))
342 }
343 mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)
344 s.mountUI(mux)
345 return securityHeaders(mux)
346}
347
348func securityHeaders(h http.Handler) http.Handler {
349 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
350 w.Header().Set("X-Content-Type-Options", "nosniff")
351 w.Header().Set("Referrer-Policy", "same-origin")
352 h.ServeHTTP(w, r)
353 })
354}
355
356// apiAction voert een actie uit voor de API.
357func (s *Server) apiAction(a Action) http.HandlerFunc {
358 return func(w http.ResponseWriter, r *http.Request) {
359 body, err := io.ReadAll(io.LimitReader(r.Body, 1<<20))
360 if err != nil {
361 writeErr(w, 400, "body")
362 return
363 }
364 if code, msg := s.authorize(r, a, body); code != 0 {
365 writeErr(w, code, msg)
366 return
367 }
368 in, err := parseInput(r, body)
369 if err != nil {
370 writeErr(w, 400, err.Error())
371 return
372 }
373 for _, p := range a.Params {
374 in[p] = r.PathValue(p)
375 }
376 code, out := a.Do(r.Context(), in)
377 if f, ok := out.(fileResult); ok {
378 w.Header().Set("Content-Type", "application/gzip")
379 w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%q", f.name))
380 http.ServeFile(w, r, f.path)
381 return
382 }
383 writeJSON(w, code, out)
384 }
385}
386
387// authorize: 0 is toegestaan, anders de foutcode.
388func (s *Server) authorize(r *http.Request, a Action, body []byte) (int, string) {
389 if tok, ok := strings.CutPrefix(r.Header.Get("Authorization"), "Bearer "); ok {
390 if subtle.ConstantTimeCompare([]byte(strings.TrimSpace(tok)), []byte(s.adminToken)) == 1 {
391 return 0, ""
392 }
393 return 401, "ongeldig token"
394 }
395 if r.Header.Get(protocol.HeaderSignature) != "" {
396 if !a.Signed {
397 return 403, "BlueGit mag dit niet"
398 }
399 st := s.getState()
400 if !st.Connected() {
401 return 401, "niet gekoppeld"
402 }
403 if r.Header.Get(protocol.HeaderInstance) != st.InstanceID {
404 return 401, "andere BlueGit-instantie"
405 }
406 if err := protocol.Verify(r, protocol.SigningSecret(st.Key), body, s.now()); err != nil {
407 return 401, err.Error()
408 }
409 return 0, ""
410 }
411 if sess, ok := s.session(r); ok {
412 if r.Method != http.MethodGet && r.Method != http.MethodHead {
413 if subtle.ConstantTimeCompare([]byte(r.Header.Get("X-CSRF-Token")), []byte(sess.csrf)) != 1 {
414 return 403, "X-CSRF-Token ontbreekt of klopt niet"
415 }
416 }
417 return 0, ""
418 }
419 return 401, "admin.token, sessie of BlueGit-handtekening nodig"
420}
421
422// parseInput leest de querystring en een JSON-object (waarden als tekst).
423func parseInput(r *http.Request, body []byte) (Input, error) {
424 in := Input{}
425 for k, v := range r.URL.Query() {
426 if len(v) > 0 {
427 in[k] = v[0]
428 }
429 }
430 if len(strings.TrimSpace(string(body))) == 0 {
431 return in, nil
432 }
433 var raw map[string]any
434 if err := json.Unmarshal(body, &raw); err != nil {
435 return nil, errors.New("ongeldige JSON: verwacht een object")
436 }
437 for k, v := range raw {
438 switch t := v.(type) {
439 case string:
440 in[k] = t
441 case float64:
442 in[k] = strconv.FormatFloat(t, 'f', -1, 64)
443 case bool:
444 in[k] = strconv.FormatBool(t)
445 case nil:
446 in[k] = ""
447 default:
448 return nil, fmt.Errorf("veld %s: verwacht tekst, getal of boolean", k)
449 }
450 }
451 return in, nil
452}
internal/backupserver/server/server.go +41 −123
@@ -58,6 +58,20 @@ type Server struct {
58 58 rollback RollbackStatus
59 59
60 60 kick chan struct{}
61
62 // settings is wat via webinterface, API of BlueGit is ingesteld.
63 settings map[string]string
64 restartPending bool
65 sessions map[string]session
66 loginFails map[string][]time.Time
67 }
68
69 // cfg is de huidige configuratie (instellingen kunnen tijdens het draaien
70 // veranderen).
71 func (s *Server) cfg() config.Config {
72 s.mu.Lock()
73 defer s.mu.Unlock()
74 return s.Cfg
61 75 }
62 76
63 77 // RollbackStatus is de stand van de laatste rollback of restore.
@@ -76,8 +90,14 @@ func New(cfg config.Config, log *slog.Logger) (*Server, error) {
76 90 if err := os.MkdirAll(cfg.DataDir, 0o750); err != nil {
77 91 return nil, err
78 92 }
79 s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1)}
80 var err error
93 set, err := config.LoadSettings(cfg.DataDir)
94 if err != nil {
95 return nil, err
96 }
97 if err := cfg.Apply(set); err != nil {
98 return nil, fmt.Errorf("%s: %w", config.SettingsFile, err)
99 }
100 s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1), settings: set, sessions: map[string]session{}}
81 101 if s.adminToken, err = secretFile(cfg.DataDir, "admin.token", "bba_"); err != nil {
82 102 return nil, err
83 103 }
@@ -131,15 +151,22 @@ func (s *Server) Kick() {
131 151 }
132 152
133 153 func (s *Server) syncLoop(ctx context.Context) {
134 full := time.NewTicker(s.Cfg.FullSyncInterval.Duration)
135 defer full.Stop()
136 154 s.Kick() // meteen na de start
137 155 for {
156 s.mu.Lock()
157 next := s.Cfg.FullSyncInterval.Duration - s.now().Sub(s.lastSync)
158 s.mu.Unlock()
159 if next < 0 {
160 next = 0
161 }
162 full := time.NewTimer(next)
138 163 select {
139 164 case <-ctx.Done():
165 full.Stop()
140 166 return
141 167 case <-full.C:
142 168 case <-s.kick:
169 full.Stop()
143 170 }
144 171 s.mu.Lock()
145 172 wait := s.Cfg.MinSyncInterval.Duration - s.now().Sub(s.lastSync)
@@ -192,13 +219,11 @@ func (s *Server) SyncNow(ctx context.Context) (mirror.Stats, error) {
192 219 }
193 220
194 221 func (s *Server) archiveLoop(ctx context.Context) {
195 t := time.NewTicker(s.tick())
196 defer t.Stop()
197 222 for {
198 223 select {
199 224 case <-ctx.Done():
200 225 return
201 case <-t.C:
226 case <-time.After(s.tick()):
202 227 }
203 228 s.mu.Lock()
204 229 due := s.now().Sub(s.lastArchive) >= s.Cfg.ArchiveInterval.Duration
@@ -217,7 +242,7 @@ func (s *Server) archiveLoop(ctx context.Context) {
217 242
218 243 // tick is hoe vaak de archieflus kijkt: een minuut, of korter bij een kort interval.
219 244 func (s *Server) tick() time.Duration {
220 d := s.Cfg.ArchiveInterval.Duration / 4
245 d := s.cfg().ArchiveInterval.Duration / 4
221 246 if d > time.Minute {
222 247 d = time.Minute
223 248 }
@@ -251,7 +276,7 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {
251 276 return a, err
252 277 }
253 278 s.Log.Info("archief gemaakt", "archive", a.Name, "bytes", a.Size)
254 if pr, err := s.archives.Prune(now, s.Cfg.RetentionDays, s.minFree()); err == nil {
279 if pr, err := s.archives.Prune(now, s.cfg().RetentionDays, s.minFree()); err == nil {
255 280 for _, r := range pr {
256 281 s.Log.Info("archief verwijderd", "archive", r)
257 282 }
@@ -259,41 +284,19 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {
259 284 return a, nil
260 285 }
261 286
262 func (s *Server) minFree() uint64 { return uint64(s.Cfg.MinFreeMB) << 20 }
287 func (s *Server) minFree() uint64 { return uint64(s.cfg().MinFreeMB) << 20 }
263 288
264 289 // Prune past de bewaarregels toe.
265 290 func (s *Server) Prune() ([]string, error) {
266 291 s.work.Lock()
267 292 defer s.work.Unlock()
268 removed, err := s.archives.Prune(s.now(), s.Cfg.RetentionDays, s.minFree())
293 removed, err := s.archives.Prune(s.now(), s.cfg().RetentionDays, s.minFree())
269 294 for _, r := range removed {
270 295 s.Log.Info("archief verwijderd", "archive", r)
271 296 }
272 297 return removed, err
273 298 }
274 299
275 // ---------- HTTP ----------
276
277 // Handler is de HTTP-API.
278 func (s *Server) Handler() http.Handler {
279 mux := http.NewServeMux()
280 mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })
281 // Van BlueGit, ondertekend.
282 mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))
283 mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))
284 mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))
285 mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))
286 // Lokaal beheer, met admin.token.
287 mux.HandleFunc("GET /api/v1/admin/status", s.admin(s.apiStatus))
288 mux.HandleFunc("GET /api/v1/admin/archives", s.admin(s.apiArchives))
289 mux.HandleFunc("POST /api/v1/admin/connect", s.admin(s.apiConnect))
290 mux.HandleFunc("POST /api/v1/admin/sync", s.admin(s.apiSync))
291 mux.HandleFunc("POST /api/v1/admin/archive", s.admin(s.apiArchiveNow))
292 mux.HandleFunc("POST /api/v1/admin/prune", s.admin(s.apiPrune))
293 mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)
294 return mux
295 }
296
297 300 func writeJSON(w http.ResponseWriter, code int, v any) {
298 301 w.Header().Set("Content-Type", "application/json")
299 302 w.Header().Set("Cache-Control", "no-store")
@@ -343,17 +346,6 @@ func bodyOf(r *http.Request) []byte {
343 346 return b
344 347 }
345 348
346 func (s *Server) admin(h http.HandlerFunc) http.HandlerFunc {
347 return func(w http.ResponseWriter, r *http.Request) {
348 tok := strings.TrimSpace(strings.TrimPrefix(r.Header.Get("Authorization"), "Bearer "))
349 if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {
350 writeErr(w, http.StatusUnauthorized, "admin.token nodig")
351 return
352 }
353 h(w, r)
354 }
355 }
356
357 349 func (s *Server) apiNotify(w http.ResponseWriter, r *http.Request) {
358 350 s.mu.Lock()
359 351 s.notifies++
@@ -409,36 +401,6 @@ func (s *Server) Status() Status {
409 401
410 402 func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }
411 403
412 func (s *Server) apiSync(w http.ResponseWriter, r *http.Request) {
413 stats, err := s.SyncNow(r.Context())
414 if err != nil {
415 writeErr(w, 502, err.Error())
416 return
417 }
418 writeJSON(w, 200, stats)
419 }
420
421 func (s *Server) apiArchiveNow(w http.ResponseWriter, r *http.Request) {
422 a, err := s.ArchiveNow()
423 if err != nil {
424 writeErr(w, 409, err.Error())
425 return
426 }
427 writeJSON(w, 201, a)
428 }
429
430 func (s *Server) apiPrune(w http.ResponseWriter, r *http.Request) {
431 removed, err := s.Prune()
432 if err != nil {
433 writeErr(w, 500, err.Error())
434 return
435 }
436 if removed == nil {
437 removed = []string{}
438 }
439 writeJSON(w, 200, map[string]any{"removed": removed})
440 }
441
442 404 // ---------- koppelen ----------
443 405
444 406 // ConnectRequest is POST /api/v1/admin/connect.
@@ -461,32 +423,6 @@ type ConflictError struct {
461 423 Choices []string `json:"choices"`
462 424 }
463 425
464 func (s *Server) apiConnect(w http.ResponseWriter, r *http.Request) {
465 var in ConnectRequest
466 if err := json.Unmarshal(bodyOf(r), &in); err != nil {
467 writeErr(w, 400, "ongeldige JSON")
468 return
469 }
470 res, conflict, err := s.Connect(r.Context(), in)
471 if conflict != nil {
472 writeJSON(w, http.StatusConflict, conflict)
473 return
474 }
475 if err != nil {
476 var he *mirror.HTTPError
477 code := 502
478 if errors.As(err, &he) && he.Status == 401 {
479 code = 401
480 }
481 if errors.Is(err, errBadRequest) {
482 code = 400
483 }
484 writeErr(w, code, err.Error())
485 return
486 }
487 writeJSON(w, 200, res)
488 }
489
490 426 var errBadRequest = errors.New("ongeldig verzoek")
491 427
492 428 // Connect koppelt deze server aan een BlueGit. Er is er altijd hoogstens één.
@@ -504,7 +440,8 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
504 440 default:
505 441 return nil, nil, fmt.Errorf("%w: on_conflict moet wipe of restore zijn", errBadRequest)
506 442 }
507 if s.Cfg.PublicURL == "" {
443 pub := s.cfg().PublicURL
444 if pub == "" {
508 445 return nil, nil, fmt.Errorf("%w: zet public_url in de configuratie; BlueGit moet deze server kunnen bereiken", errBadRequest)
509 446 }
510 447 s.work.Lock()
@@ -544,7 +481,7 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
544 481 if mode == "restore" && s.mirror.Empty() {
545 482 return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)
546 483 }
547 if err := rem.Connect(ctx, s.Cfg.PublicURL, s.serverID); err != nil {
484 if err := rem.Connect(ctx, pub, s.serverID); err != nil {
548 485 return nil, nil, err
549 486 }
550 487 st := State{BlueGitURL: in.URL, Key: in.Key, InstanceID: info.InstanceID, ConnectedAt: s.now().UTC()}
@@ -601,27 +538,8 @@ func (s *Server) apiRollback(w http.ResponseWriter, r *http.Request) {
601 538 writeErr(w, 400, "ongeldige archiefnaam")
602 539 return
603 540 }
604 if _, err := s.archives.Path(in.Archive); err != nil {
605 writeErr(w, 404, err.Error())
606 return
607 }
608 s.mu.Lock()
609 busy := s.rollback.State == "running"
610 if !busy {
611 s.rollback = RollbackStatus{State: "running", Archive: in.Archive, At: s.now().UTC()}
612 }
613 s.mu.Unlock()
614 if busy {
615 writeErr(w, 409, "er loopt al een rollback")
616 return
617 }
618 s.Log.Warn("rollback gestart", "archive", in.Archive)
619 go func() {
620 if err := s.Rollback(context.Background(), in.Archive); err != nil {
621 s.Log.Error("rollback mislukt", "archive", in.Archive, "err", err)
622 }
623 }()
624 writeJSON(w, http.StatusAccepted, map[string]string{"state": "running", "archive": in.Archive})
541 code, out := s.startRollback(in.Archive)
542 writeJSON(w, code, out)
625 543 }
626 544
627 545 // Rollback pakt een archief uit, vervangt daarmee de draaiende kopie en
@@ -58,6 +58,20 @@ type Server struct {
58 rollback RollbackStatus
58 rollback RollbackStatus
59
59
60 kick chan struct{}
60 kick chan struct{}
61
62 // settings is wat via webinterface, API of BlueGit is ingesteld.
63 settings map[string]string
64 restartPending bool
65 sessions map[string]session
66 loginFails map[string][]time.Time
67}
68
69// cfg is de huidige configuratie (instellingen kunnen tijdens het draaien
70// veranderen).
71func (s *Server) cfg() config.Config {
72 s.mu.Lock()
73 defer s.mu.Unlock()
74 return s.Cfg
61}
75}
62
76
63// RollbackStatus is de stand van de laatste rollback of restore.
77// RollbackStatus is de stand van de laatste rollback of restore.
@@ -76,8 +90,14 @@ func New(cfg config.Config, log *slog.Logger) (*Server, error) {
76 if err := os.MkdirAll(cfg.DataDir, 0o750); err != nil {
90 if err := os.MkdirAll(cfg.DataDir, 0o750); err != nil {
77 return nil, err
91 return nil, err
78 }
92 }
79 s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1)}
93 set, err := config.LoadSettings(cfg.DataDir)
80 var err error
94 if err != nil {
95 return nil, err
96 }
97 if err := cfg.Apply(set); err != nil {
98 return nil, fmt.Errorf("%s: %w", config.SettingsFile, err)
99 }
100 s := &Server{Cfg: cfg, Log: log, Now: time.Now, kick: make(chan struct{}, 1), settings: set, sessions: map[string]session{}}
81 if s.adminToken, err = secretFile(cfg.DataDir, "admin.token", "bba_"); err != nil {
101 if s.adminToken, err = secretFile(cfg.DataDir, "admin.token", "bba_"); err != nil {
82 return nil, err
102 return nil, err
83 }
103 }
@@ -131,15 +151,22 @@ func (s *Server) Kick() {
131}
151}
132
152
133func (s *Server) syncLoop(ctx context.Context) {
153func (s *Server) syncLoop(ctx context.Context) {
134 full := time.NewTicker(s.Cfg.FullSyncInterval.Duration)
135 defer full.Stop()
136 s.Kick() // meteen na de start
154 s.Kick() // meteen na de start
137 for {
155 for {
156 s.mu.Lock()
157 next := s.Cfg.FullSyncInterval.Duration - s.now().Sub(s.lastSync)
158 s.mu.Unlock()
159 if next < 0 {
160 next = 0
161 }
162 full := time.NewTimer(next)
138 select {
163 select {
139 case <-ctx.Done():
164 case <-ctx.Done():
165 full.Stop()
140 return
166 return
141 case <-full.C:
167 case <-full.C:
142 case <-s.kick:
168 case <-s.kick:
169 full.Stop()
143 }
170 }
144 s.mu.Lock()
171 s.mu.Lock()
145 wait := s.Cfg.MinSyncInterval.Duration - s.now().Sub(s.lastSync)
172 wait := s.Cfg.MinSyncInterval.Duration - s.now().Sub(s.lastSync)
@@ -192,13 +219,11 @@ func (s *Server) SyncNow(ctx context.Context) (mirror.Stats, error) {
192}
219}
193
220
194func (s *Server) archiveLoop(ctx context.Context) {
221func (s *Server) archiveLoop(ctx context.Context) {
195 t := time.NewTicker(s.tick())
196 defer t.Stop()
197 for {
222 for {
198 select {
223 select {
199 case <-ctx.Done():
224 case <-ctx.Done():
200 return
225 return
201 case <-t.C:
226 case <-time.After(s.tick()):
202 }
227 }
203 s.mu.Lock()
228 s.mu.Lock()
204 due := s.now().Sub(s.lastArchive) >= s.Cfg.ArchiveInterval.Duration
229 due := s.now().Sub(s.lastArchive) >= s.Cfg.ArchiveInterval.Duration
@@ -217,7 +242,7 @@ func (s *Server) archiveLoop(ctx context.Context) {
217
242
218// tick is hoe vaak de archieflus kijkt: een minuut, of korter bij een kort interval.
243// tick is hoe vaak de archieflus kijkt: een minuut, of korter bij een kort interval.
219func (s *Server) tick() time.Duration {
244func (s *Server) tick() time.Duration {
220 d := s.Cfg.ArchiveInterval.Duration / 4
245 d := s.cfg().ArchiveInterval.Duration / 4
221 if d > time.Minute {
246 if d > time.Minute {
222 d = time.Minute
247 d = time.Minute
223 }
248 }
@@ -251,7 +276,7 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {
251 return a, err
276 return a, err
252 }
277 }
253 s.Log.Info("archief gemaakt", "archive", a.Name, "bytes", a.Size)
278 s.Log.Info("archief gemaakt", "archive", a.Name, "bytes", a.Size)
254 if pr, err := s.archives.Prune(now, s.Cfg.RetentionDays, s.minFree()); err == nil {
279 if pr, err := s.archives.Prune(now, s.cfg().RetentionDays, s.minFree()); err == nil {
255 for _, r := range pr {
280 for _, r := range pr {
256 s.Log.Info("archief verwijderd", "archive", r)
281 s.Log.Info("archief verwijderd", "archive", r)
257 }
282 }
@@ -259,41 +284,19 @@ func (s *Server) ArchiveNow() (archive.Archive, error) {
259 return a, nil
284 return a, nil
260}
285}
261
286
262func (s *Server) minFree() uint64 { return uint64(s.Cfg.MinFreeMB) << 20 }
287func (s *Server) minFree() uint64 { return uint64(s.cfg().MinFreeMB) << 20 }
263
288
264// Prune past de bewaarregels toe.
289// Prune past de bewaarregels toe.
265func (s *Server) Prune() ([]string, error) {
290func (s *Server) Prune() ([]string, error) {
266 s.work.Lock()
291 s.work.Lock()
267 defer s.work.Unlock()
292 defer s.work.Unlock()
268 removed, err := s.archives.Prune(s.now(), s.Cfg.RetentionDays, s.minFree())
293 removed, err := s.archives.Prune(s.now(), s.cfg().RetentionDays, s.minFree())
269 for _, r := range removed {
294 for _, r := range removed {
270 s.Log.Info("archief verwijderd", "archive", r)
295 s.Log.Info("archief verwijderd", "archive", r)
271 }
296 }
272 return removed, err
297 return removed, err
273}
298}
274
299
275// ---------- HTTP ----------
276
277// Handler is de HTTP-API.
278func (s *Server) Handler() http.Handler {
279 mux := http.NewServeMux()
280 mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { _, _ = w.Write([]byte("ok\n")) })
281 // Van BlueGit, ondertekend.
282 mux.HandleFunc("POST /api/v1/notify", s.signed(s.apiNotify))
283 mux.HandleFunc("GET /api/v1/archives", s.signed(s.apiArchives))
284 mux.HandleFunc("GET /api/v1/status", s.signed(s.apiStatus))
285 mux.HandleFunc("POST /api/v1/rollback", s.signed(s.apiRollback))
286 // Lokaal beheer, met admin.token.
287 mux.HandleFunc("GET /api/v1/admin/status", s.admin(s.apiStatus))
288 mux.HandleFunc("GET /api/v1/admin/archives", s.admin(s.apiArchives))
289 mux.HandleFunc("POST /api/v1/admin/connect", s.admin(s.apiConnect))
290 mux.HandleFunc("POST /api/v1/admin/sync", s.admin(s.apiSync))
291 mux.HandleFunc("POST /api/v1/admin/archive", s.admin(s.apiArchiveNow))
292 mux.HandleFunc("POST /api/v1/admin/prune", s.admin(s.apiPrune))
293 mux.HandleFunc("POST /api/v1/admin/self-update", s.selfUpdate)
294 return mux
295}
296
297func writeJSON(w http.ResponseWriter, code int, v any) {
300func writeJSON(w http.ResponseWriter, code int, v any) {
298 w.Header().Set("Content-Type", "application/json")
301 w.Header().Set("Content-Type", "application/json")
299 w.Header().Set("Cache-Control", "no-store")
302 w.Header().Set("Cache-Control", "no-store")
@@ -343,17 +346,6 @@ func bodyOf(r *http.Request) []byte {
343 return b
346 return b
344}
347}
345
348
346func (s *Server) admin(h http.HandlerFunc) http.HandlerFunc {
347 return func(w http.ResponseWriter, r *http.Request) {
348 tok := strings.TrimSpace(strings.TrimPrefix(r.Header.Get("Authorization"), "Bearer "))
349 if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {
350 writeErr(w, http.StatusUnauthorized, "admin.token nodig")
351 return
352 }
353 h(w, r)
354 }
355}
356
357func (s *Server) apiNotify(w http.ResponseWriter, r *http.Request) {
349func (s *Server) apiNotify(w http.ResponseWriter, r *http.Request) {
358 s.mu.Lock()
350 s.mu.Lock()
359 s.notifies++
351 s.notifies++
@@ -409,36 +401,6 @@ func (s *Server) Status() Status {
409
401
410func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }
402func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }
411
403
412func (s *Server) apiSync(w http.ResponseWriter, r *http.Request) {
413 stats, err := s.SyncNow(r.Context())
414 if err != nil {
415 writeErr(w, 502, err.Error())
416 return
417 }
418 writeJSON(w, 200, stats)
419}
420
421func (s *Server) apiArchiveNow(w http.ResponseWriter, r *http.Request) {
422 a, err := s.ArchiveNow()
423 if err != nil {
424 writeErr(w, 409, err.Error())
425 return
426 }
427 writeJSON(w, 201, a)
428}
429
430func (s *Server) apiPrune(w http.ResponseWriter, r *http.Request) {
431 removed, err := s.Prune()
432 if err != nil {
433 writeErr(w, 500, err.Error())
434 return
435 }
436 if removed == nil {
437 removed = []string{}
438 }
439 writeJSON(w, 200, map[string]any{"removed": removed})
440}
441
442// ---------- koppelen ----------
404// ---------- koppelen ----------
443
405
444// ConnectRequest is POST /api/v1/admin/connect.
406// ConnectRequest is POST /api/v1/admin/connect.
@@ -461,32 +423,6 @@ type ConflictError struct {
461 Choices []string `json:"choices"`
423 Choices []string `json:"choices"`
462}
424}
463
425
464func (s *Server) apiConnect(w http.ResponseWriter, r *http.Request) {
465 var in ConnectRequest
466 if err := json.Unmarshal(bodyOf(r), &in); err != nil {
467 writeErr(w, 400, "ongeldige JSON")
468 return
469 }
470 res, conflict, err := s.Connect(r.Context(), in)
471 if conflict != nil {
472 writeJSON(w, http.StatusConflict, conflict)
473 return
474 }
475 if err != nil {
476 var he *mirror.HTTPError
477 code := 502
478 if errors.As(err, &he) && he.Status == 401 {
479 code = 401
480 }
481 if errors.Is(err, errBadRequest) {
482 code = 400
483 }
484 writeErr(w, code, err.Error())
485 return
486 }
487 writeJSON(w, 200, res)
488}
489
490var errBadRequest = errors.New("ongeldig verzoek")
426var errBadRequest = errors.New("ongeldig verzoek")
491
427
492// Connect koppelt deze server aan een BlueGit. Er is er altijd hoogstens één.
428// Connect koppelt deze server aan een BlueGit. Er is er altijd hoogstens één.
@@ -504,7 +440,8 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
504 default:
440 default:
505 return nil, nil, fmt.Errorf("%w: on_conflict moet wipe of restore zijn", errBadRequest)
441 return nil, nil, fmt.Errorf("%w: on_conflict moet wipe of restore zijn", errBadRequest)
506 }
442 }
507 if s.Cfg.PublicURL == "" {
443 pub := s.cfg().PublicURL
444 if pub == "" {
508 return nil, nil, fmt.Errorf("%w: zet public_url in de configuratie; BlueGit moet deze server kunnen bereiken", errBadRequest)
445 return nil, nil, fmt.Errorf("%w: zet public_url in de configuratie; BlueGit moet deze server kunnen bereiken", errBadRequest)
509 }
446 }
510 s.work.Lock()
447 s.work.Lock()
@@ -544,7 +481,7 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
544 if mode == "restore" && s.mirror.Empty() {
481 if mode == "restore" && s.mirror.Empty() {
545 return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)
482 return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)
546 }
483 }
547 if err := rem.Connect(ctx, s.Cfg.PublicURL, s.serverID); err != nil {
484 if err := rem.Connect(ctx, pub, s.serverID); err != nil {
548 return nil, nil, err
485 return nil, nil, err
549 }
486 }
550 st := State{BlueGitURL: in.URL, Key: in.Key, InstanceID: info.InstanceID, ConnectedAt: s.now().UTC()}
487 st := State{BlueGitURL: in.URL, Key: in.Key, InstanceID: info.InstanceID, ConnectedAt: s.now().UTC()}
@@ -601,27 +538,8 @@ func (s *Server) apiRollback(w http.ResponseWriter, r *http.Request) {
601 writeErr(w, 400, "ongeldige archiefnaam")
538 writeErr(w, 400, "ongeldige archiefnaam")
602 return
539 return
603 }
540 }
604 if _, err := s.archives.Path(in.Archive); err != nil {
541 code, out := s.startRollback(in.Archive)
605 writeErr(w, 404, err.Error())
542 writeJSON(w, code, out)
606 return
607 }
608 s.mu.Lock()
609 busy := s.rollback.State == "running"
610 if !busy {
611 s.rollback = RollbackStatus{State: "running", Archive: in.Archive, At: s.now().UTC()}
612 }
613 s.mu.Unlock()
614 if busy {
615 writeErr(w, 409, "er loopt al een rollback")
616 return
617 }
618 s.Log.Warn("rollback gestart", "archive", in.Archive)
619 go func() {
620 if err := s.Rollback(context.Background(), in.Archive); err != nil {
621 s.Log.Error("rollback mislukt", "archive", in.Archive, "err", err)
622 }
623 }()
624 writeJSON(w, http.StatusAccepted, map[string]string{"state": "running", "archive": in.Archive})
625}
543}
626
544
627// Rollback pakt een archief uit, vervangt daarmee de draaiende kopie en
545// Rollback pakt een archief uit, vervangt daarmee de draaiende kopie en
internal/backupserver/server/ui.go added +303 −0
@@ -0,0 +1,303 @@
1 package server
2
3 import (
4 "crypto/rand"
5 "crypto/subtle"
6 "embed"
7 "encoding/hex"
8 "encoding/json"
9 "fmt"
10 "html/template"
11 "net"
12 "net/http"
13 "net/url"
14 "strings"
15 "time"
16
17 "git.timfalken.com/timfa/bluegit-backup/internal/archive"
18 )
19
20 //go:embed web/*
21 var webFS embed.FS
22
23 var uiTmpl = template.Must(template.New("").Funcs(template.FuncMap{
24 "bytes": humanBytes,
25 "when": func(t time.Time) string {
26 if t.IsZero() {
27 return "nog niet"
28 }
29 return t.Local().Format("2006-01-02 15:04:05")
30 },
31 "json": func(v any) string { b, _ := json.MarshalIndent(v, "", " "); return string(b) },
32 }).ParseFS(webFS, "web/*.html"))
33
34 const (
35 sessionCookie = "bbsession"
36 sessionTTL = 12 * time.Hour
37 )
38
39 type session struct {
40 csrf string
41 expires time.Time
42 flash string
43 isErr bool
44 }
45
46 func randHex(n int) string {
47 b := make([]byte, n)
48 _, _ = rand.Read(b)
49 return hex.EncodeToString(b)
50 }
51
52 func humanBytes(n int64) string {
53 const unit = 1024
54 if n < unit {
55 return fmt.Sprintf("%d B", n)
56 }
57 div, exp := int64(unit), 0
58 for m := n / unit; m >= unit; m /= unit {
59 div *= unit
60 exp++
61 }
62 return fmt.Sprintf("%.1f %ciB", float64(n)/float64(div), "KMGTPE"[exp])
63 }
64
65 func (s *Server) session(r *http.Request) (session, bool) {
66 c, err := r.Cookie(sessionCookie)
67 if err != nil || c.Value == "" {
68 return session{}, false
69 }
70 s.mu.Lock()
71 defer s.mu.Unlock()
72 sess, ok := s.sessions[c.Value]
73 if !ok || s.now().After(sess.expires) {
74 delete(s.sessions, c.Value)
75 return session{}, false
76 }
77 return sess, true
78 }
79
80 func (s *Server) setFlash(r *http.Request, msg string, isErr bool) {
81 c, err := r.Cookie(sessionCookie)
82 if err != nil {
83 return
84 }
85 s.mu.Lock()
86 defer s.mu.Unlock()
87 if sess, ok := s.sessions[c.Value]; ok {
88 sess.flash, sess.isErr = msg, isErr
89 s.sessions[c.Value] = sess
90 }
91 }
92
93 func (s *Server) takeFlash(r *http.Request) (string, bool) {
94 c, err := r.Cookie(sessionCookie)
95 if err != nil {
96 return "", false
97 }
98 s.mu.Lock()
99 defer s.mu.Unlock()
100 sess, ok := s.sessions[c.Value]
101 if !ok {
102 return "", false
103 }
104 msg, isErr := sess.flash, sess.isErr
105 sess.flash, sess.isErr = "", false
106 s.sessions[c.Value] = sess
107 return msg, isErr
108 }
109
110 func clientIP(r *http.Request) string {
111 h, _, err := net.SplitHostPort(r.RemoteAddr)
112 if err != nil {
113 return r.RemoteAddr
114 }
115 return h
116 }
117
118 // loginAllowed: hoogstens 5 foute pogingen per minuut per IP-adres.
119 func (s *Server) loginAllowed(ip string, failed bool) bool {
120 s.mu.Lock()
121 defer s.mu.Unlock()
122 if s.loginFails == nil {
123 s.loginFails = map[string][]time.Time{}
124 }
125 cut := s.now().Add(-time.Minute)
126 keep := s.loginFails[ip][:0]
127 for _, t := range s.loginFails[ip] {
128 if t.After(cut) {
129 keep = append(keep, t)
130 }
131 }
132 if failed {
133 keep = append(keep, s.now())
134 }
135 s.loginFails[ip] = keep
136 return len(keep) < 5
137 }
138
139 func (s *Server) mountUI(mux *http.ServeMux) {
140 mux.HandleFunc("GET /{$}", s.uiIndex)
141 mux.HandleFunc("GET /login", s.uiLoginPage)
142 mux.HandleFunc("POST /login", s.uiLogin)
143 mux.HandleFunc("POST /logout", s.uiLogout)
144 mux.HandleFunc("POST /ui/act/{name}", s.uiAct)
145 }
146
147 func (s *Server) render(w http.ResponseWriter, name string, data any) {
148 w.Header().Set("Content-Type", "text/html; charset=utf-8")
149 w.Header().Set("Cache-Control", "no-store")
150 w.Header().Set("Content-Security-Policy", "default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'none'; frame-ancestors 'none'; form-action 'self'")
151 w.Header().Set("X-Frame-Options", "DENY")
152 if err := uiTmpl.ExecuteTemplate(w, name, data); err != nil {
153 s.Log.Error("template", "name", name, "err", err)
154 }
155 }
156
157 func (s *Server) uiLoginPage(w http.ResponseWriter, r *http.Request) {
158 if _, ok := s.session(r); ok {
159 http.Redirect(w, r, "/", http.StatusSeeOther)
160 return
161 }
162 s.render(w, "login.html", map[string]any{"Error": r.URL.Query().Get("fout") != "", "Version": Version})
163 }
164
165 func (s *Server) uiLogin(w http.ResponseWriter, r *http.Request) {
166 ip := clientIP(r)
167 if !s.loginAllowed(ip, false) {
168 http.Error(w, "te veel pogingen, wacht een minuut", http.StatusTooManyRequests)
169 return
170 }
171 tok := strings.TrimSpace(r.PostFormValue("token"))
172 if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {
173 s.loginAllowed(ip, true)
174 http.Redirect(w, r, "/login?fout=1", http.StatusSeeOther)
175 return
176 }
177 id := randHex(32)
178 s.mu.Lock()
179 for k, v := range s.sessions {
180 if s.now().After(v.expires) {
181 delete(s.sessions, k)
182 }
183 }
184 s.sessions[id] = session{csrf: randHex(16), expires: s.now().Add(sessionTTL)}
185 s.mu.Unlock()
186 http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: id, Path: "/", HttpOnly: true,
187 SameSite: http.SameSiteStrictMode, Secure: r.TLS != nil || r.Header.Get("X-Forwarded-Proto") == "https",
188 MaxAge: int(sessionTTL / time.Second)})
189 http.Redirect(w, r, "/", http.StatusSeeOther)
190 }
191
192 func (s *Server) uiLogout(w http.ResponseWriter, r *http.Request) {
193 if sess, ok := s.session(r); ok && r.PostFormValue("csrf") == sess.csrf {
194 c, _ := r.Cookie(sessionCookie)
195 s.mu.Lock()
196 delete(s.sessions, c.Value)
197 s.mu.Unlock()
198 }
199 http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: "", Path: "/", MaxAge: -1, HttpOnly: true})
200 http.Redirect(w, r, "/login", http.StatusSeeOther)
201 }
202
203 // pageData is wat de webinterface toont: precies de uitkomst van de
204 // GET-acties uit Actions.
205 type pageData struct {
206 CSRF string
207 Flash string
208 FlashErr bool
209 Status Status
210 Config ConfigView
211 Archives []archive.Archive
212 Actions []Action
213 Version string
214 }
215
216 func (s *Server) uiIndex(w http.ResponseWriter, r *http.Request) {
217 sess, ok := s.session(r)
218 if !ok {
219 http.Redirect(w, r, "/login", http.StatusSeeOther)
220 return
221 }
222 d := pageData{CSRF: sess.csrf, Status: s.Status(), Config: s.ConfigView(), Actions: s.Actions(), Version: Version}
223 d.Archives, _ = s.archives.List()
224 d.Flash, d.FlashErr = s.takeFlash(r)
225 s.render(w, "index.html", d)
226 }
227
228 // uiAct voert een actie uit vanuit een formulier, via dezelfde code als de API.
229 func (s *Server) uiAct(w http.ResponseWriter, r *http.Request) {
230 sess, ok := s.session(r)
231 if !ok {
232 http.Redirect(w, r, "/login", http.StatusSeeOther)
233 return
234 }
235 if err := r.ParseForm(); err != nil {
236 http.Error(w, "formulier", 400)
237 return
238 }
239 if subtle.ConstantTimeCompare([]byte(r.PostFormValue("csrf")), []byte(sess.csrf)) != 1 {
240 http.Error(w, "CSRF-token klopt niet; laad de pagina opnieuw", http.StatusForbidden)
241 return
242 }
243 a, ok := s.action(r.PathValue("name"))
244 if !ok || a.Method == http.MethodGet {
245 http.NotFound(w, r)
246 return
247 }
248 in := Input{}
249 for k, v := range r.PostForm {
250 if k == "csrf" || k == "understood" || len(v) == 0 {
251 continue
252 }
253 in[k] = v[0]
254 }
255 anchor := "#" + strings.SplitN(a.Name, ".", 2)[0]
256 if a.Name == "rollback" && r.PostFormValue("understood") == "" {
257 s.setFlash(r, "Vink aan dat je begrijpt dat een rollback niet ongedaan kan worden gemaakt.", true)
258 http.Redirect(w, r, "/#archives", http.StatusSeeOther)
259 return
260 }
261 if a.Name == "sync" {
262 in["wait"] = "false"
263 }
264 code, out := a.Do(r.Context(), in)
265 msg, isErr := describe(a, code, out)
266 s.setFlash(r, msg, isErr)
267 http.Redirect(w, r, "/"+anchor, http.StatusSeeOther)
268 }
269
270 func describe(a Action, code int, out any) (string, bool) {
271 if code >= 400 {
272 switch v := out.(type) {
273 case *ConflictError:
274 return fmt.Sprintf("%s (vorige: %s, %d archieven). Kies hieronder ‘oude backups wissen’ of ‘nieuwe BlueGit herstellen’ en koppel opnieuw.", v.Error, v.PreviousURL, v.Archives), true
275 case map[string]string:
276 return a.Title + " mislukt: " + v["error"], true
277 }
278 return fmt.Sprintf("%s mislukt (HTTP %d)", a.Title, code), true
279 }
280 switch a.Name {
281 case "sync":
282 return "Synchronisatie gestart.", false
283 case "archive":
284 if v, ok := out.(archive.Archive); ok {
285 return "Archief gemaakt: " + v.Name, false
286 }
287 case "prune":
288 if v, ok := out.(map[string]any); ok {
289 return fmt.Sprintf("Opgeruimd: %d archieven.", len(v["removed"].([]string))), false
290 }
291 case "rollback":
292 return "Rollback gestart. BlueGit herstart zodra de data er staat.", false
293 case "config.update":
294 if v, ok := out.(ConfigView); ok && v.Restart {
295 return "Instellingen opgeslagen. Een deel geldt pas na een herstart.", false
296 }
297 return "Instellingen opgeslagen.", false
298 }
299 return a.Title + ": gelukt.", false
300 }
301
302 // UIPath is het formulieradres van een actie in de webinterface.
303 func UIPath(a Action) string { return "/ui/act/" + url.PathEscape(a.Name) }
@@ -0,0 +1,303 @@
1package server
2
3import (
4 "crypto/rand"
5 "crypto/subtle"
6 "embed"
7 "encoding/hex"
8 "encoding/json"
9 "fmt"
10 "html/template"
11 "net"
12 "net/http"
13 "net/url"
14 "strings"
15 "time"
16
17 "git.timfalken.com/timfa/bluegit-backup/internal/archive"
18)
19
20//go:embed web/*
21var webFS embed.FS
22
23var uiTmpl = template.Must(template.New("").Funcs(template.FuncMap{
24 "bytes": humanBytes,
25 "when": func(t time.Time) string {
26 if t.IsZero() {
27 return "nog niet"
28 }
29 return t.Local().Format("2006-01-02 15:04:05")
30 },
31 "json": func(v any) string { b, _ := json.MarshalIndent(v, "", " "); return string(b) },
32}).ParseFS(webFS, "web/*.html"))
33
34const (
35 sessionCookie = "bbsession"
36 sessionTTL = 12 * time.Hour
37)
38
39type session struct {
40 csrf string
41 expires time.Time
42 flash string
43 isErr bool
44}
45
46func randHex(n int) string {
47 b := make([]byte, n)
48 _, _ = rand.Read(b)
49 return hex.EncodeToString(b)
50}
51
52func humanBytes(n int64) string {
53 const unit = 1024
54 if n < unit {
55 return fmt.Sprintf("%d B", n)
56 }
57 div, exp := int64(unit), 0
58 for m := n / unit; m >= unit; m /= unit {
59 div *= unit
60 exp++
61 }
62 return fmt.Sprintf("%.1f %ciB", float64(n)/float64(div), "KMGTPE"[exp])
63}
64
65func (s *Server) session(r *http.Request) (session, bool) {
66 c, err := r.Cookie(sessionCookie)
67 if err != nil || c.Value == "" {
68 return session{}, false
69 }
70 s.mu.Lock()
71 defer s.mu.Unlock()
72 sess, ok := s.sessions[c.Value]
73 if !ok || s.now().After(sess.expires) {
74 delete(s.sessions, c.Value)
75 return session{}, false
76 }
77 return sess, true
78}
79
80func (s *Server) setFlash(r *http.Request, msg string, isErr bool) {
81 c, err := r.Cookie(sessionCookie)
82 if err != nil {
83 return
84 }
85 s.mu.Lock()
86 defer s.mu.Unlock()
87 if sess, ok := s.sessions[c.Value]; ok {
88 sess.flash, sess.isErr = msg, isErr
89 s.sessions[c.Value] = sess
90 }
91}
92
93func (s *Server) takeFlash(r *http.Request) (string, bool) {
94 c, err := r.Cookie(sessionCookie)
95 if err != nil {
96 return "", false
97 }
98 s.mu.Lock()
99 defer s.mu.Unlock()
100 sess, ok := s.sessions[c.Value]
101 if !ok {
102 return "", false
103 }
104 msg, isErr := sess.flash, sess.isErr
105 sess.flash, sess.isErr = "", false
106 s.sessions[c.Value] = sess
107 return msg, isErr
108}
109
110func clientIP(r *http.Request) string {
111 h, _, err := net.SplitHostPort(r.RemoteAddr)
112 if err != nil {
113 return r.RemoteAddr
114 }
115 return h
116}
117
118// loginAllowed: hoogstens 5 foute pogingen per minuut per IP-adres.
119func (s *Server) loginAllowed(ip string, failed bool) bool {
120 s.mu.Lock()
121 defer s.mu.Unlock()
122 if s.loginFails == nil {
123 s.loginFails = map[string][]time.Time{}
124 }
125 cut := s.now().Add(-time.Minute)
126 keep := s.loginFails[ip][:0]
127 for _, t := range s.loginFails[ip] {
128 if t.After(cut) {
129 keep = append(keep, t)
130 }
131 }
132 if failed {
133 keep = append(keep, s.now())
134 }
135 s.loginFails[ip] = keep
136 return len(keep) < 5
137}
138
139func (s *Server) mountUI(mux *http.ServeMux) {
140 mux.HandleFunc("GET /{$}", s.uiIndex)
141 mux.HandleFunc("GET /login", s.uiLoginPage)
142 mux.HandleFunc("POST /login", s.uiLogin)
143 mux.HandleFunc("POST /logout", s.uiLogout)
144 mux.HandleFunc("POST /ui/act/{name}", s.uiAct)
145}
146
147func (s *Server) render(w http.ResponseWriter, name string, data any) {
148 w.Header().Set("Content-Type", "text/html; charset=utf-8")
149 w.Header().Set("Cache-Control", "no-store")
150 w.Header().Set("Content-Security-Policy", "default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'none'; frame-ancestors 'none'; form-action 'self'")
151 w.Header().Set("X-Frame-Options", "DENY")
152 if err := uiTmpl.ExecuteTemplate(w, name, data); err != nil {
153 s.Log.Error("template", "name", name, "err", err)
154 }
155}
156
157func (s *Server) uiLoginPage(w http.ResponseWriter, r *http.Request) {
158 if _, ok := s.session(r); ok {
159 http.Redirect(w, r, "/", http.StatusSeeOther)
160 return
161 }
162 s.render(w, "login.html", map[string]any{"Error": r.URL.Query().Get("fout") != "", "Version": Version})
163}
164
165func (s *Server) uiLogin(w http.ResponseWriter, r *http.Request) {
166 ip := clientIP(r)
167 if !s.loginAllowed(ip, false) {
168 http.Error(w, "te veel pogingen, wacht een minuut", http.StatusTooManyRequests)
169 return
170 }
171 tok := strings.TrimSpace(r.PostFormValue("token"))
172 if subtle.ConstantTimeCompare([]byte(tok), []byte(s.adminToken)) != 1 {
173 s.loginAllowed(ip, true)
174 http.Redirect(w, r, "/login?fout=1", http.StatusSeeOther)
175 return
176 }
177 id := randHex(32)
178 s.mu.Lock()
179 for k, v := range s.sessions {
180 if s.now().After(v.expires) {
181 delete(s.sessions, k)
182 }
183 }
184 s.sessions[id] = session{csrf: randHex(16), expires: s.now().Add(sessionTTL)}
185 s.mu.Unlock()
186 http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: id, Path: "/", HttpOnly: true,
187 SameSite: http.SameSiteStrictMode, Secure: r.TLS != nil || r.Header.Get("X-Forwarded-Proto") == "https",
188 MaxAge: int(sessionTTL / time.Second)})
189 http.Redirect(w, r, "/", http.StatusSeeOther)
190}
191
192func (s *Server) uiLogout(w http.ResponseWriter, r *http.Request) {
193 if sess, ok := s.session(r); ok && r.PostFormValue("csrf") == sess.csrf {
194 c, _ := r.Cookie(sessionCookie)
195 s.mu.Lock()
196 delete(s.sessions, c.Value)
197 s.mu.Unlock()
198 }
199 http.SetCookie(w, &http.Cookie{Name: sessionCookie, Value: "", Path: "/", MaxAge: -1, HttpOnly: true})
200 http.Redirect(w, r, "/login", http.StatusSeeOther)
201}
202
203// pageData is wat de webinterface toont: precies de uitkomst van de
204// GET-acties uit Actions.
205type pageData struct {
206 CSRF string
207 Flash string
208 FlashErr bool
209 Status Status
210 Config ConfigView
211 Archives []archive.Archive
212 Actions []Action
213 Version string
214}
215
216func (s *Server) uiIndex(w http.ResponseWriter, r *http.Request) {
217 sess, ok := s.session(r)
218 if !ok {
219 http.Redirect(w, r, "/login", http.StatusSeeOther)
220 return
221 }
222 d := pageData{CSRF: sess.csrf, Status: s.Status(), Config: s.ConfigView(), Actions: s.Actions(), Version: Version}
223 d.Archives, _ = s.archives.List()
224 d.Flash, d.FlashErr = s.takeFlash(r)
225 s.render(w, "index.html", d)
226}
227
228// uiAct voert een actie uit vanuit een formulier, via dezelfde code als de API.
229func (s *Server) uiAct(w http.ResponseWriter, r *http.Request) {
230 sess, ok := s.session(r)
231 if !ok {
232 http.Redirect(w, r, "/login", http.StatusSeeOther)
233 return
234 }
235 if err := r.ParseForm(); err != nil {
236 http.Error(w, "formulier", 400)
237 return
238 }
239 if subtle.ConstantTimeCompare([]byte(r.PostFormValue("csrf")), []byte(sess.csrf)) != 1 {
240 http.Error(w, "CSRF-token klopt niet; laad de pagina opnieuw", http.StatusForbidden)
241 return
242 }
243 a, ok := s.action(r.PathValue("name"))
244 if !ok || a.Method == http.MethodGet {
245 http.NotFound(w, r)
246 return
247 }
248 in := Input{}
249 for k, v := range r.PostForm {
250 if k == "csrf" || k == "understood" || len(v) == 0 {
251 continue
252 }
253 in[k] = v[0]
254 }
255 anchor := "#" + strings.SplitN(a.Name, ".", 2)[0]
256 if a.Name == "rollback" && r.PostFormValue("understood") == "" {
257 s.setFlash(r, "Vink aan dat je begrijpt dat een rollback niet ongedaan kan worden gemaakt.", true)
258 http.Redirect(w, r, "/#archives", http.StatusSeeOther)
259 return
260 }
261 if a.Name == "sync" {
262 in["wait"] = "false"
263 }
264 code, out := a.Do(r.Context(), in)
265 msg, isErr := describe(a, code, out)
266 s.setFlash(r, msg, isErr)
267 http.Redirect(w, r, "/"+anchor, http.StatusSeeOther)
268}
269
270func describe(a Action, code int, out any) (string, bool) {
271 if code >= 400 {
272 switch v := out.(type) {
273 case *ConflictError:
274 return fmt.Sprintf("%s (vorige: %s, %d archieven). Kies hieronder ‘oude backups wissen’ of ‘nieuwe BlueGit herstellen’ en koppel opnieuw.", v.Error, v.PreviousURL, v.Archives), true
275 case map[string]string:
276 return a.Title + " mislukt: " + v["error"], true
277 }
278 return fmt.Sprintf("%s mislukt (HTTP %d)", a.Title, code), true
279 }
280 switch a.Name {
281 case "sync":
282 return "Synchronisatie gestart.", false
283 case "archive":
284 if v, ok := out.(archive.Archive); ok {
285 return "Archief gemaakt: " + v.Name, false
286 }
287 case "prune":
288 if v, ok := out.(map[string]any); ok {
289 return fmt.Sprintf("Opgeruimd: %d archieven.", len(v["removed"].([]string))), false
290 }
291 case "rollback":
292 return "Rollback gestart. BlueGit herstart zodra de data er staat.", false
293 case "config.update":
294 if v, ok := out.(ConfigView); ok && v.Restart {
295 return "Instellingen opgeslagen. Een deel geldt pas na een herstart.", false
296 }
297 return "Instellingen opgeslagen.", false
298 }
299 return a.Title + ": gelukt.", false
300}
301
302// UIPath is het formulieradres van een actie in de webinterface.
303func UIPath(a Action) string { return "/ui/act/" + url.PathEscape(a.Name) }
internal/backupserver/server/ui_test.go added +285 −0
@@ -0,0 +1,285 @@
1 package server
2
3 import (
4 "bytes"
5 "encoding/json"
6 "net/http"
7 "net/http/httptest"
8 "net/url"
9 "os"
10 "path/filepath"
11 "regexp"
12 "strings"
13 "testing"
14 "time"
15
16 "git.timfalken.com/timfa/bluegit-backup/internal/config"
17 "git.timfalken.com/timfa/bluegit-backup/internal/protocol"
18 )
19
20 // uiClient is een browser met een cookie.
21 type uiClient struct {
22 t *testing.T
23 h http.Handler
24 cookie *http.Cookie
25 }
26
27 func (c *uiClient) do(method, p string, form url.Values) *httptest.ResponseRecorder {
28 var body *strings.Reader
29 if form != nil {
30 body = strings.NewReader(form.Encode())
31 } else {
32 body = strings.NewReader("")
33 }
34 r := httptest.NewRequest(method, p, body)
35 if form != nil {
36 r.Header.Set("Content-Type", "application/x-www-form-urlencoded")
37 }
38 if c.cookie != nil {
39 r.AddCookie(c.cookie)
40 }
41 w := httptest.NewRecorder()
42 c.h.ServeHTTP(w, r)
43 for _, ck := range w.Result().Cookies() {
44 if ck.Name == sessionCookie {
45 c.cookie = ck
46 }
47 }
48 return w
49 }
50
51 var csrfRE = regexp.MustCompile(`name="csrf" value="([0-9a-f]+)"`)
52
53 func login(t *testing.T, s *Server) (*uiClient, string) {
54 c := &uiClient{t: t, h: s.Handler()}
55 if w := c.do("GET", "/", nil); w.Code != 303 || w.Header().Get("Location") != "/login" {
56 t.Fatalf("zonder sessie: %d %s", w.Code, w.Header().Get("Location"))
57 }
58 if w := c.do("POST", "/login", url.Values{"token": {"fout"}}); w.Header().Get("Location") != "/login?fout=1" {
59 t.Fatalf("fout token: %s", w.Header().Get("Location"))
60 }
61 if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 303 || c.cookie == nil {
62 t.Fatalf("login %d", w.Code)
63 }
64 if !c.cookie.HttpOnly || c.cookie.SameSite != http.SameSiteStrictMode {
65 t.Fatalf("cookie %+v", c.cookie)
66 }
67 w := c.do("GET", "/", nil)
68 if w.Code != 200 {
69 t.Fatalf("index %d", w.Code)
70 }
71 m := csrfRE.FindStringSubmatch(w.Body.String())
72 if m == nil {
73 t.Fatal("geen csrf")
74 }
75 return c, m[1]
76 }
77
78 // Elke wijzigende actie heeft een formulier in de webinterface, elke
79 // beheerroute zit in Actions, en elk formulier hoort bij een actie.
80 func TestUIAndAPIParity(t *testing.T) {
81 f := newFake(t)
82 s := newTestServer(t)
83 if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {
84 t.Fatal(w.Body)
85 }
86 if _, err := s.SyncNow(t.Context()); err != nil {
87 t.Fatal(err)
88 }
89 if _, err := s.ArchiveNow(); err != nil {
90 t.Fatal(err)
91 }
92 c, _ := login(t, s)
93 page := c.do("GET", "/", nil).Body.String()
94 // Het koppelformulier staat in een uitklapper zodra er gekoppeld is; het
95 // moet er nog steeds zijn.
96 forms := map[string]bool{}
97 for _, m := range regexp.MustCompile(`action="/ui/act/([a-z.]+)"`).FindAllStringSubmatch(page, -1) {
98 forms[m[1]] = true
99 }
100 for _, a := range s.Actions() {
101 switch a.Method {
102 case "GET":
103 // Getoond op de pagina; download als link.
104 if a.Name == "archive.download" && !strings.Contains(page, "/download\">Downloaden") {
105 t.Errorf("geen downloadlink")
106 }
107 default:
108 if !forms[a.Name] {
109 t.Errorf("actie %s (%s %s) heeft geen formulier in de webinterface", a.Name, a.Method, a.Path)
110 }
111 delete(forms, a.Name)
112 }
113 }
114 for f := range forms {
115 t.Errorf("formulier %s hoort bij geen API-actie", f)
116 }
117 // Alle GET-acties geven hun gegevens ook op de pagina.
118 for _, want := range []string{"Overzicht", "cfg-archive_interval", "cfg-listen", "bluegit-", "/api/v1/admin/config"} {
119 if !strings.Contains(page, want) {
120 t.Errorf("pagina mist %q", want)
121 }
122 }
123 // De API geeft dezelfde actielijst.
124 w := adminReq(s, "GET", "/api/v1/admin/actions", "")
125 var al struct {
126 Actions []Action `json:"actions"`
127 }
128 _ = json.Unmarshal(w.Body.Bytes(), &al)
129 if len(al.Actions) != len(s.Actions()) {
130 t.Fatalf("actions %d", len(al.Actions))
131 }
132 }
133
134 func TestUISettingsAndCSRF(t *testing.T) {
135 s := newTestServer(t)
136 c, csrf := login(t, s)
137 form := url.Values{"csrf": {csrf}, "retention_days": {"9"}, "archive_interval": {"12h"}, "rate_limit_kib": {"300"}, "listen": {"127.0.0.1:9999"}}
138 if w := c.do("POST", "/ui/act/config.update", form); w.Code != 303 {
139 t.Fatalf("opslaan %d %s", w.Code, w.Body)
140 }
141 page := c.do("GET", "/", nil).Body.String()
142 if !strings.Contains(page, "Instellingen opgeslagen") || !strings.Contains(page, "herstart") {
143 t.Fatalf("melding ontbreekt")
144 }
145 cv := s.ConfigView()
146 get := func(k string) string {
147 for _, f := range cv.Fields {
148 if f.Key == k {
149 return f.Value
150 }
151 }
152 return ""
153 }
154 if get("retention_days") != "9" || get("archive_interval") != "12h" || get("listen") != "127.0.0.1:9999" || !cv.Restart {
155 t.Fatalf("%+v", cv)
156 }
157 if s.limiter.Rate() != 300<<10 {
158 t.Fatalf("rate %d", s.limiter.Rate())
159 }
160 if s.cfg().Listen == "127.0.0.1:9999" {
161 t.Fatal("listen hoort pas na herstart te gelden")
162 }
163 // Bewaard: een nieuwe server leest het.
164 s2, err := New(s.Cfg, nil)
165 if err != nil {
166 t.Fatal(err)
167 }
168 if s2.cfg().RetentionDays != 9 || s2.cfg().Listen != "127.0.0.1:9999" {
169 t.Fatalf("na herstart %+v", s2.cfg())
170 }
171 // Zonder of met fout CSRF-token: geweigerd.
172 if w := c.do("POST", "/ui/act/config.update", url.Values{"retention_days": {"1"}}); w.Code != 403 {
173 t.Fatalf("zonder csrf %d", w.Code)
174 }
175 // Ongeldige waarde: foutmelding, niets veranderd.
176 c.do("POST", "/ui/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"-1"}})
177 if !strings.Contains(c.do("GET", "/", nil).Body.String(), "mislukt") || s.cfg().RetentionDays != 9 {
178 t.Fatal("ongeldige waarde")
179 }
180 // API met sessiecookie vraagt X-CSRF-Token.
181 r := httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))
182 r.AddCookie(c.cookie)
183 w := httptest.NewRecorder()
184 s.Handler().ServeHTTP(w, r)
185 if w.Code != 403 {
186 t.Fatalf("cookie zonder csrf-header %d", w.Code)
187 }
188 r = httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))
189 r.AddCookie(c.cookie)
190 r.Header.Set("X-CSRF-Token", csrf)
191 w = httptest.NewRecorder()
192 s.Handler().ServeHTTP(w, r)
193 if w.Code != 200 || s.cfg().RetentionDays != 3 {
194 t.Fatalf("cookie met csrf-header %d %s", w.Code, w.Body)
195 }
196 // Uitloggen.
197 c.do("POST", "/logout", url.Values{"csrf": {csrf}})
198 if w := c.do("GET", "/", nil); w.Code != 303 {
199 t.Fatalf("na uitloggen %d", w.Code)
200 }
201 // Webinterface mag niet in een iframe van een ander.
202 if h := c.do("GET", "/login", nil).Header(); h.Get("X-Frame-Options") != "DENY" {
203 t.Fatal("frame")
204 }
205 }
206
207 func TestLoginRateLimit(t *testing.T) {
208 s := newTestServer(t)
209 c := &uiClient{t: t, h: s.Handler()}
210 for i := 0; i < 5; i++ {
211 c.do("POST", "/login", url.Values{"token": {"fout"}})
212 }
213 if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 429 {
214 t.Fatalf("na 5 fouten %d", w.Code)
215 }
216 }
217
218 func TestAPIConfig(t *testing.T) {
219 s := newTestServer(t)
220 w := adminReq(s, "PUT", "/api/v1/admin/config", `{"min_free_mb":2048,"full_sync_interval":"30m"}`)
221 if w.Code != 200 {
222 t.Fatalf("%d %s", w.Code, w.Body)
223 }
224 if s.cfg().MinFreeMB != 2048 || s.cfg().FullSyncInterval.Duration != 30*time.Minute {
225 t.Fatalf("%+v", s.cfg())
226 }
227 if _, err := os.Stat(filepath.Join(s.Cfg.DataDir, config.SettingsFile)); err != nil {
228 t.Fatal(err)
229 }
230 for _, body := range []string{`{"data_dir":"/tmp"}`, `{"onbekend":1}`, `{"archive_interval":"0s"}`, `{}`, `[1]`} {
231 if w := adminReq(s, "PUT", "/api/v1/admin/config", body); w.Code != 400 {
232 t.Errorf("%s: %d", body, w.Code)
233 }
234 }
235 w = adminReq(s, "GET", "/api/v1/admin/config", "")
236 var cv ConfigView
237 _ = json.Unmarshal(w.Body.Bytes(), &cv)
238 if len(cv.Fields) != len(config.Fields) {
239 t.Fatalf("%s", w.Body)
240 }
241 }
242
243 func TestSignedAdminActions(t *testing.T) {
244 f := newFake(t)
245 s := newTestServer(t)
246 if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {
247 t.Fatal(w.Body)
248 }
249 good := protocol.SigningSecret("bgbk_test")
250 call := func(method, p, body string) *httptest.ResponseRecorder {
251 r := httptest.NewRequest(method, p, bytes.NewReader([]byte(body)))
252 protocol.Sign(r, good, "inst-1", []byte(body), time.Now())
253 w := httptest.NewRecorder()
254 s.Handler().ServeHTTP(w, r)
255 return w
256 }
257 if w := call("PUT", "/api/v1/admin/config", `{"retention_days":"4"}`); w.Code != 200 || s.cfg().RetentionDays != 4 {
258 t.Fatalf("config via BlueGit %d %s", w.Code, w.Body)
259 }
260 if w := call("GET", "/api/v1/admin/config", ""); w.Code != 200 {
261 t.Fatalf("config lezen %d", w.Code)
262 }
263 if w := call("POST", "/api/v1/admin/connect", `{}`); w.Code != 403 {
264 t.Fatalf("connect via BlueGit %d", w.Code)
265 }
266 if w := call("POST", "/api/v1/admin/rollback", `{"archive":"bluegit-20261115-120000.tar.gz"}`); w.Code != 400 {
267 t.Fatalf("rollback zonder confirm %d", w.Code)
268 }
269 // Handtekening over een ander pad: geweigerd.
270 r := httptest.NewRequest("POST", "/api/v1/admin/sync", nil)
271 protocol.Sign(r, good, "inst-1", nil, time.Now())
272 r.URL.Path = "/api/v1/admin/disconnect"
273 w := httptest.NewRecorder()
274 s.Handler().ServeHTTP(w, r)
275 if w.Code != 401 {
276 t.Fatalf("ander pad %d", w.Code)
277 }
278 if w := call("POST", "/api/v1/admin/disconnect", ``); w.Code != 200 || s.getState().Connected() {
279 t.Fatalf("disconnect %d", w.Code)
280 }
281 // Ontkoppeld: BlueGit kan niets meer.
282 if w := call("GET", "/api/v1/admin/status", ""); w.Code != 401 {
283 t.Fatalf("na ontkoppelen %d", w.Code)
284 }
285 }
@@ -0,0 +1,285 @@
1package server
2
3import (
4 "bytes"
5 "encoding/json"
6 "net/http"
7 "net/http/httptest"
8 "net/url"
9 "os"
10 "path/filepath"
11 "regexp"
12 "strings"
13 "testing"
14 "time"
15
16 "git.timfalken.com/timfa/bluegit-backup/internal/config"
17 "git.timfalken.com/timfa/bluegit-backup/internal/protocol"
18)
19
20// uiClient is een browser met een cookie.
21type uiClient struct {
22 t *testing.T
23 h http.Handler
24 cookie *http.Cookie
25}
26
27func (c *uiClient) do(method, p string, form url.Values) *httptest.ResponseRecorder {
28 var body *strings.Reader
29 if form != nil {
30 body = strings.NewReader(form.Encode())
31 } else {
32 body = strings.NewReader("")
33 }
34 r := httptest.NewRequest(method, p, body)
35 if form != nil {
36 r.Header.Set("Content-Type", "application/x-www-form-urlencoded")
37 }
38 if c.cookie != nil {
39 r.AddCookie(c.cookie)
40 }
41 w := httptest.NewRecorder()
42 c.h.ServeHTTP(w, r)
43 for _, ck := range w.Result().Cookies() {
44 if ck.Name == sessionCookie {
45 c.cookie = ck
46 }
47 }
48 return w
49}
50
51var csrfRE = regexp.MustCompile(`name="csrf" value="([0-9a-f]+)"`)
52
53func login(t *testing.T, s *Server) (*uiClient, string) {
54 c := &uiClient{t: t, h: s.Handler()}
55 if w := c.do("GET", "/", nil); w.Code != 303 || w.Header().Get("Location") != "/login" {
56 t.Fatalf("zonder sessie: %d %s", w.Code, w.Header().Get("Location"))
57 }
58 if w := c.do("POST", "/login", url.Values{"token": {"fout"}}); w.Header().Get("Location") != "/login?fout=1" {
59 t.Fatalf("fout token: %s", w.Header().Get("Location"))
60 }
61 if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 303 || c.cookie == nil {
62 t.Fatalf("login %d", w.Code)
63 }
64 if !c.cookie.HttpOnly || c.cookie.SameSite != http.SameSiteStrictMode {
65 t.Fatalf("cookie %+v", c.cookie)
66 }
67 w := c.do("GET", "/", nil)
68 if w.Code != 200 {
69 t.Fatalf("index %d", w.Code)
70 }
71 m := csrfRE.FindStringSubmatch(w.Body.String())
72 if m == nil {
73 t.Fatal("geen csrf")
74 }
75 return c, m[1]
76}
77
78// Elke wijzigende actie heeft een formulier in de webinterface, elke
79// beheerroute zit in Actions, en elk formulier hoort bij een actie.
80func TestUIAndAPIParity(t *testing.T) {
81 f := newFake(t)
82 s := newTestServer(t)
83 if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {
84 t.Fatal(w.Body)
85 }
86 if _, err := s.SyncNow(t.Context()); err != nil {
87 t.Fatal(err)
88 }
89 if _, err := s.ArchiveNow(); err != nil {
90 t.Fatal(err)
91 }
92 c, _ := login(t, s)
93 page := c.do("GET", "/", nil).Body.String()
94 // Het koppelformulier staat in een uitklapper zodra er gekoppeld is; het
95 // moet er nog steeds zijn.
96 forms := map[string]bool{}
97 for _, m := range regexp.MustCompile(`action="/ui/act/([a-z.]+)"`).FindAllStringSubmatch(page, -1) {
98 forms[m[1]] = true
99 }
100 for _, a := range s.Actions() {
101 switch a.Method {
102 case "GET":
103 // Getoond op de pagina; download als link.
104 if a.Name == "archive.download" && !strings.Contains(page, "/download\">Downloaden") {
105 t.Errorf("geen downloadlink")
106 }
107 default:
108 if !forms[a.Name] {
109 t.Errorf("actie %s (%s %s) heeft geen formulier in de webinterface", a.Name, a.Method, a.Path)
110 }
111 delete(forms, a.Name)
112 }
113 }
114 for f := range forms {
115 t.Errorf("formulier %s hoort bij geen API-actie", f)
116 }
117 // Alle GET-acties geven hun gegevens ook op de pagina.
118 for _, want := range []string{"Overzicht", "cfg-archive_interval", "cfg-listen", "bluegit-", "/api/v1/admin/config"} {
119 if !strings.Contains(page, want) {
120 t.Errorf("pagina mist %q", want)
121 }
122 }
123 // De API geeft dezelfde actielijst.
124 w := adminReq(s, "GET", "/api/v1/admin/actions", "")
125 var al struct {
126 Actions []Action `json:"actions"`
127 }
128 _ = json.Unmarshal(w.Body.Bytes(), &al)
129 if len(al.Actions) != len(s.Actions()) {
130 t.Fatalf("actions %d", len(al.Actions))
131 }
132}
133
134func TestUISettingsAndCSRF(t *testing.T) {
135 s := newTestServer(t)
136 c, csrf := login(t, s)
137 form := url.Values{"csrf": {csrf}, "retention_days": {"9"}, "archive_interval": {"12h"}, "rate_limit_kib": {"300"}, "listen": {"127.0.0.1:9999"}}
138 if w := c.do("POST", "/ui/act/config.update", form); w.Code != 303 {
139 t.Fatalf("opslaan %d %s", w.Code, w.Body)
140 }
141 page := c.do("GET", "/", nil).Body.String()
142 if !strings.Contains(page, "Instellingen opgeslagen") || !strings.Contains(page, "herstart") {
143 t.Fatalf("melding ontbreekt")
144 }
145 cv := s.ConfigView()
146 get := func(k string) string {
147 for _, f := range cv.Fields {
148 if f.Key == k {
149 return f.Value
150 }
151 }
152 return ""
153 }
154 if get("retention_days") != "9" || get("archive_interval") != "12h" || get("listen") != "127.0.0.1:9999" || !cv.Restart {
155 t.Fatalf("%+v", cv)
156 }
157 if s.limiter.Rate() != 300<<10 {
158 t.Fatalf("rate %d", s.limiter.Rate())
159 }
160 if s.cfg().Listen == "127.0.0.1:9999" {
161 t.Fatal("listen hoort pas na herstart te gelden")
162 }
163 // Bewaard: een nieuwe server leest het.
164 s2, err := New(s.Cfg, nil)
165 if err != nil {
166 t.Fatal(err)
167 }
168 if s2.cfg().RetentionDays != 9 || s2.cfg().Listen != "127.0.0.1:9999" {
169 t.Fatalf("na herstart %+v", s2.cfg())
170 }
171 // Zonder of met fout CSRF-token: geweigerd.
172 if w := c.do("POST", "/ui/act/config.update", url.Values{"retention_days": {"1"}}); w.Code != 403 {
173 t.Fatalf("zonder csrf %d", w.Code)
174 }
175 // Ongeldige waarde: foutmelding, niets veranderd.
176 c.do("POST", "/ui/act/config.update", url.Values{"csrf": {csrf}, "retention_days": {"-1"}})
177 if !strings.Contains(c.do("GET", "/", nil).Body.String(), "mislukt") || s.cfg().RetentionDays != 9 {
178 t.Fatal("ongeldige waarde")
179 }
180 // API met sessiecookie vraagt X-CSRF-Token.
181 r := httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))
182 r.AddCookie(c.cookie)
183 w := httptest.NewRecorder()
184 s.Handler().ServeHTTP(w, r)
185 if w.Code != 403 {
186 t.Fatalf("cookie zonder csrf-header %d", w.Code)
187 }
188 r = httptest.NewRequest("PUT", "/api/v1/admin/config", strings.NewReader(`{"retention_days":3}`))
189 r.AddCookie(c.cookie)
190 r.Header.Set("X-CSRF-Token", csrf)
191 w = httptest.NewRecorder()
192 s.Handler().ServeHTTP(w, r)
193 if w.Code != 200 || s.cfg().RetentionDays != 3 {
194 t.Fatalf("cookie met csrf-header %d %s", w.Code, w.Body)
195 }
196 // Uitloggen.
197 c.do("POST", "/logout", url.Values{"csrf": {csrf}})
198 if w := c.do("GET", "/", nil); w.Code != 303 {
199 t.Fatalf("na uitloggen %d", w.Code)
200 }
201 // Webinterface mag niet in een iframe van een ander.
202 if h := c.do("GET", "/login", nil).Header(); h.Get("X-Frame-Options") != "DENY" {
203 t.Fatal("frame")
204 }
205}
206
207func TestLoginRateLimit(t *testing.T) {
208 s := newTestServer(t)
209 c := &uiClient{t: t, h: s.Handler()}
210 for i := 0; i < 5; i++ {
211 c.do("POST", "/login", url.Values{"token": {"fout"}})
212 }
213 if w := c.do("POST", "/login", url.Values{"token": {s.AdminToken()}}); w.Code != 429 {
214 t.Fatalf("na 5 fouten %d", w.Code)
215 }
216}
217
218func TestAPIConfig(t *testing.T) {
219 s := newTestServer(t)
220 w := adminReq(s, "PUT", "/api/v1/admin/config", `{"min_free_mb":2048,"full_sync_interval":"30m"}`)
221 if w.Code != 200 {
222 t.Fatalf("%d %s", w.Code, w.Body)
223 }
224 if s.cfg().MinFreeMB != 2048 || s.cfg().FullSyncInterval.Duration != 30*time.Minute {
225 t.Fatalf("%+v", s.cfg())
226 }
227 if _, err := os.Stat(filepath.Join(s.Cfg.DataDir, config.SettingsFile)); err != nil {
228 t.Fatal(err)
229 }
230 for _, body := range []string{`{"data_dir":"/tmp"}`, `{"onbekend":1}`, `{"archive_interval":"0s"}`, `{}`, `[1]`} {
231 if w := adminReq(s, "PUT", "/api/v1/admin/config", body); w.Code != 400 {
232 t.Errorf("%s: %d", body, w.Code)
233 }
234 }
235 w = adminReq(s, "GET", "/api/v1/admin/config", "")
236 var cv ConfigView
237 _ = json.Unmarshal(w.Body.Bytes(), &cv)
238 if len(cv.Fields) != len(config.Fields) {
239 t.Fatalf("%s", w.Body)
240 }
241}
242
243func TestSignedAdminActions(t *testing.T) {
244 f := newFake(t)
245 s := newTestServer(t)
246 if w := adminReq(s, "POST", "/api/v1/admin/connect", `{"url":"`+f.ts.URL+`","key":"bgbk_test"}`); w.Code != 200 {
247 t.Fatal(w.Body)
248 }
249 good := protocol.SigningSecret("bgbk_test")
250 call := func(method, p, body string) *httptest.ResponseRecorder {
251 r := httptest.NewRequest(method, p, bytes.NewReader([]byte(body)))
252 protocol.Sign(r, good, "inst-1", []byte(body), time.Now())
253 w := httptest.NewRecorder()
254 s.Handler().ServeHTTP(w, r)
255 return w
256 }
257 if w := call("PUT", "/api/v1/admin/config", `{"retention_days":"4"}`); w.Code != 200 || s.cfg().RetentionDays != 4 {
258 t.Fatalf("config via BlueGit %d %s", w.Code, w.Body)
259 }
260 if w := call("GET", "/api/v1/admin/config", ""); w.Code != 200 {
261 t.Fatalf("config lezen %d", w.Code)
262 }
263 if w := call("POST", "/api/v1/admin/connect", `{}`); w.Code != 403 {
264 t.Fatalf("connect via BlueGit %d", w.Code)
265 }
266 if w := call("POST", "/api/v1/admin/rollback", `{"archive":"bluegit-20261115-120000.tar.gz"}`); w.Code != 400 {
267 t.Fatalf("rollback zonder confirm %d", w.Code)
268 }
269 // Handtekening over een ander pad: geweigerd.
270 r := httptest.NewRequest("POST", "/api/v1/admin/sync", nil)
271 protocol.Sign(r, good, "inst-1", nil, time.Now())
272 r.URL.Path = "/api/v1/admin/disconnect"
273 w := httptest.NewRecorder()
274 s.Handler().ServeHTTP(w, r)
275 if w.Code != 401 {
276 t.Fatalf("ander pad %d", w.Code)
277 }
278 if w := call("POST", "/api/v1/admin/disconnect", ``); w.Code != 200 || s.getState().Connected() {
279 t.Fatalf("disconnect %d", w.Code)
280 }
281 // Ontkoppeld: BlueGit kan niets meer.
282 if w := call("GET", "/api/v1/admin/status", ""); w.Code != 401 {
283 t.Fatalf("na ontkoppelen %d", w.Code)
284 }
285}
internal/backupserver/server/web/index.html added +102 −0
@@ -0,0 +1,102 @@
1 <!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
2 <title>bluegit-backup</title>{{template "style"}}</head><body>
3 <header><h1>bluegit-backup</h1>
4 <span class="badge{{if not .Status.Connected}} off{{end}}">{{if .Status.Connected}}gekoppeld{{else}}niet gekoppeld{{end}}</span>
5 <form method="post" action="/logout"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Uitloggen</button></form>
6 </header>
7 <main>
8 {{if .Flash}}<div class="flash{{if .FlashErr}} err{{end}}" role="status">{{.Flash}}</div>{{end}}
9
10 <section id="status">
11 <h2>Overzicht</h2>
12 <dl>
13 <dt>BlueGit</dt><dd>{{if .Status.BlueGitURL}}{{.Status.BlueGitURL}}{{else}}—{{end}}{{if .Status.InstanceID}} <small>instantie {{.Status.InstanceID}}</small>{{end}}</dd>
14 <dt>Laatste sync</dt><dd>{{when .Status.LastSync}}{{if .Status.SyncError}} <span class="badge off">{{.Status.SyncError}}</span>{{end}}</dd>
15 <dt>Laatste sync-resultaat</dt><dd>{{.Status.LastStats.Files}} bestanden, {{.Status.LastStats.Downloaded}} opgehaald ({{bytes .Status.LastStats.Bytes}}), {{.Status.LastStats.Deleted}} verwijderd</dd>
16 <dt>Syncs / meldingen</dt><dd>{{.Status.Syncs}} / {{.Status.Notifies}}</dd>
17 <dt>Kopie</dt><dd>{{bytes .Status.MirrorBytes}}</dd>
18 <dt>Archieven</dt><dd>{{.Status.Archives}}, laatste {{when .Status.LastArchive}}{{if .Status.ArchiveError}} <span class="badge off">{{.Status.ArchiveError}}</span>{{end}}</dd>
19 <dt>Rollback</dt><dd>{{.Status.Rollback.State}}{{if .Status.Rollback.Archive}} ({{.Status.Rollback.Archive}}){{end}}{{if .Status.Rollback.Error}} <span class="badge off">{{.Status.Rollback.Error}}</span>{{end}}</dd>
20 <dt>Versie</dt><dd>{{.Status.Version}} <small>server-id {{.Status.ServerID}}</small></dd>
21 </dl>
22 <div class="row" style="margin-top:.8rem">
23 <form method="post" action="/ui/act/sync"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu synchroniseren</button></form>
24 <form method="post" action="/ui/act/archive"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu archiveren</button></form>
25 <form method="post" action="/ui/act/prune"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Nu opruimen</button></form>
26 </div>
27 </section>
28
29 <section id="connect">
30 <h2>Koppeling</h2>
31 {{if .Status.Connected}}
32 <p>Gekoppeld met <strong>{{.Status.BlueGitURL}}</strong>. Een backup server hoort bij één BlueGit.</p>
33 <form method="post" action="/ui/act/disconnect"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Ontkoppelen</button> <small>De kopie en de archieven blijven staan.</small></form>
34 <details><summary>Opnieuw koppelen (nieuwe key of andere BlueGit)</summary>{{template "connectform" .}}</details>
35 {{else}}
36 <p>Maak in BlueGit onder <em>Beheer → Backup</em> een Backupserver-Key en vul die hier in.</p>
37 {{template "connectform" .}}
38 {{end}}
39 </section>
40
41 <section id="config">
42 <h2>Instellingen</h2>
43 {{if .Config.Restart}}<div class="flash">Er staat een wijziging klaar die pas na een herstart geldt.</div>{{end}}
44 <form method="post" action="/ui/act/config.update">
45 <input type="hidden" name="csrf" value="{{.CSRF}}">
46 {{range .Config.Fields}}
47 <label for="cfg-{{.Key}}">{{.Label}} <small>{{.Help}}{{if .Restart}} (na herstart){{end}}</small></label>
48 <input id="cfg-{{.Key}}" type="text" name="{{.Key}}" value="{{.Value}}">
49 {{end}}
50 <p><small>Gegevensmap: <code>{{.Config.DataDir}}</code> (alleen in config.yml)</small></p>
51 <p><button type="submit">Opslaan</button></p>
52 </form>
53 </section>
54
55 <section id="archives">
56 <h2>Archieven</h2>
57 {{if .Archives}}
58 <table><thead><tr><th>Archief</th><th>Gemaakt</th><th>Grootte</th><th></th></tr></thead><tbody>
59 {{range .Archives}}<tr>
60 <td><code>{{.Name}}</code></td><td>{{when .CreatedAt}}</td><td>{{bytes .Size}}</td>
61 <td class="row"><a href="/api/v1/admin/archives/{{.Name}}/download">Downloaden</a>
62 <form method="post" action="/ui/act/archive.delete"><input type="hidden" name="csrf" value="{{$.CSRF}}"><input type="hidden" name="name" value="{{.Name}}"><button class="secondary" type="submit">Verwijderen</button></form></td>
63 </tr>{{end}}
64 </tbody></table>
65 <details>
66 <summary>Rollback naar een archief</summary>
67 <div class="backup-danger"><strong>Dit kan niet ongedaan worden gemaakt.</strong>
68 Alle gegevens van BlueGit worden vervangen door de inhoud van het archief. Alles wat daarna is veranderd, is weg. BlueGit herstart.</div>
69 <form method="post" action="/ui/act/rollback">
70 <input type="hidden" name="csrf" value="{{.CSRF}}">
71 <label for="rb-archive">Archief</label>
72 <select id="rb-archive" name="archive">{{range .Archives}}<option value="{{.Name}}">{{.Name}}</option>{{end}}</select>
73 <label for="rb-confirm">Typ de archiefnaam over</label>
74 <input id="rb-confirm" type="text" name="confirm" autocomplete="off" required>
75 <label><input type="checkbox" name="understood" value="1" required> Ik begrijp dat dit niet ongedaan kan worden gemaakt</label>
76 <p><button class="danger" type="submit">Rollback starten</button></p>
77 </form>
78 </details>
79 {{else}}<p>Nog geen archieven.</p>{{end}}
80 </section>
81
82 <section id="api">
83 <h2>API</h2>
84 <p><small>Alles hierboven kan ook via de API, met <code>Authorization: Bearer &lt;admin.token&gt;</code>. Acties met ✓ kan ook de gekoppelde BlueGit uitvoeren.</small></p>
85 <table><thead><tr><th>Methode</th><th>Pad</th><th>Actie</th><th>BlueGit</th></tr></thead><tbody>
86 {{range .Actions}}<tr><td><code>{{.Method}}</code></td><td><code>{{.Path}}</code></td><td>{{.Title}}</td><td>{{if .Signed}}✓{{end}}</td></tr>{{end}}
87 </tbody></table>
88 </section>
89 <p><small>bluegit-backup {{.Version}}</small></p>
90 </main></body></html>
91 {{define "connectform"}}
92 <form method="post" action="/ui/act/connect">
93 <input type="hidden" name="csrf" value="{{.CSRF}}">
94 <label for="c-url">BlueGit-adres</label><input id="c-url" type="url" name="url" placeholder="https://git.example.com" value="{{.Status.BlueGitURL}}" required>
95 <label for="c-key">Backupserver-Key</label><input id="c-key" type="password" name="key" placeholder="bgbk_…" autocomplete="off" required>
96 <label>Hoorde deze server eerder bij een andere BlueGit?</label>
97 <label><input type="radio" name="on_conflict" value="" checked> Nee, of vraag het eerst</label>
98 <label><input type="radio" name="on_conflict" value="wipe"> Oude backups wissen en opnieuw beginnen</label>
99 <label><input type="radio" name="on_conflict" value="restore"> De nieuwe BlueGit herstellen met de backupdata</label>
100 <p><button type="submit">Koppelen</button></p>
101 </form>
102 {{end}}
@@ -0,0 +1,102 @@
1<!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
2<title>bluegit-backup</title>{{template "style"}}</head><body>
3<header><h1>bluegit-backup</h1>
4<span class="badge{{if not .Status.Connected}} off{{end}}">{{if .Status.Connected}}gekoppeld{{else}}niet gekoppeld{{end}}</span>
5<form method="post" action="/logout"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Uitloggen</button></form>
6</header>
7<main>
8{{if .Flash}}<div class="flash{{if .FlashErr}} err{{end}}" role="status">{{.Flash}}</div>{{end}}
9
10<section id="status">
11<h2>Overzicht</h2>
12<dl>
13<dt>BlueGit</dt><dd>{{if .Status.BlueGitURL}}{{.Status.BlueGitURL}}{{else}}—{{end}}{{if .Status.InstanceID}} <small>instantie {{.Status.InstanceID}}</small>{{end}}</dd>
14<dt>Laatste sync</dt><dd>{{when .Status.LastSync}}{{if .Status.SyncError}} <span class="badge off">{{.Status.SyncError}}</span>{{end}}</dd>
15<dt>Laatste sync-resultaat</dt><dd>{{.Status.LastStats.Files}} bestanden, {{.Status.LastStats.Downloaded}} opgehaald ({{bytes .Status.LastStats.Bytes}}), {{.Status.LastStats.Deleted}} verwijderd</dd>
16<dt>Syncs / meldingen</dt><dd>{{.Status.Syncs}} / {{.Status.Notifies}}</dd>
17<dt>Kopie</dt><dd>{{bytes .Status.MirrorBytes}}</dd>
18<dt>Archieven</dt><dd>{{.Status.Archives}}, laatste {{when .Status.LastArchive}}{{if .Status.ArchiveError}} <span class="badge off">{{.Status.ArchiveError}}</span>{{end}}</dd>
19<dt>Rollback</dt><dd>{{.Status.Rollback.State}}{{if .Status.Rollback.Archive}} ({{.Status.Rollback.Archive}}){{end}}{{if .Status.Rollback.Error}} <span class="badge off">{{.Status.Rollback.Error}}</span>{{end}}</dd>
20<dt>Versie</dt><dd>{{.Status.Version}} <small>server-id {{.Status.ServerID}}</small></dd>
21</dl>
22<div class="row" style="margin-top:.8rem">
23<form method="post" action="/ui/act/sync"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu synchroniseren</button></form>
24<form method="post" action="/ui/act/archive"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu archiveren</button></form>
25<form method="post" action="/ui/act/prune"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Nu opruimen</button></form>
26</div>
27</section>
28
29<section id="connect">
30<h2>Koppeling</h2>
31{{if .Status.Connected}}
32<p>Gekoppeld met <strong>{{.Status.BlueGitURL}}</strong>. Een backup server hoort bij één BlueGit.</p>
33<form method="post" action="/ui/act/disconnect"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Ontkoppelen</button> <small>De kopie en de archieven blijven staan.</small></form>
34<details><summary>Opnieuw koppelen (nieuwe key of andere BlueGit)</summary>{{template "connectform" .}}</details>
35{{else}}
36<p>Maak in BlueGit onder <em>Beheer → Backup</em> een Backupserver-Key en vul die hier in.</p>
37{{template "connectform" .}}
38{{end}}
39</section>
40
41<section id="config">
42<h2>Instellingen</h2>
43{{if .Config.Restart}}<div class="flash">Er staat een wijziging klaar die pas na een herstart geldt.</div>{{end}}
44<form method="post" action="/ui/act/config.update">
45<input type="hidden" name="csrf" value="{{.CSRF}}">
46{{range .Config.Fields}}
47<label for="cfg-{{.Key}}">{{.Label}} <small>{{.Help}}{{if .Restart}} (na herstart){{end}}</small></label>
48<input id="cfg-{{.Key}}" type="text" name="{{.Key}}" value="{{.Value}}">
49{{end}}
50<p><small>Gegevensmap: <code>{{.Config.DataDir}}</code> (alleen in config.yml)</small></p>
51<p><button type="submit">Opslaan</button></p>
52</form>
53</section>
54
55<section id="archives">
56<h2>Archieven</h2>
57{{if .Archives}}
58<table><thead><tr><th>Archief</th><th>Gemaakt</th><th>Grootte</th><th></th></tr></thead><tbody>
59{{range .Archives}}<tr>
60<td><code>{{.Name}}</code></td><td>{{when .CreatedAt}}</td><td>{{bytes .Size}}</td>
61<td class="row"><a href="/api/v1/admin/archives/{{.Name}}/download">Downloaden</a>
62<form method="post" action="/ui/act/archive.delete"><input type="hidden" name="csrf" value="{{$.CSRF}}"><input type="hidden" name="name" value="{{.Name}}"><button class="secondary" type="submit">Verwijderen</button></form></td>
63</tr>{{end}}
64</tbody></table>
65<details>
66<summary>Rollback naar een archief</summary>
67<div class="backup-danger"><strong>Dit kan niet ongedaan worden gemaakt.</strong>
68Alle gegevens van BlueGit worden vervangen door de inhoud van het archief. Alles wat daarna is veranderd, is weg. BlueGit herstart.</div>
69<form method="post" action="/ui/act/rollback">
70<input type="hidden" name="csrf" value="{{.CSRF}}">
71<label for="rb-archive">Archief</label>
72<select id="rb-archive" name="archive">{{range .Archives}}<option value="{{.Name}}">{{.Name}}</option>{{end}}</select>
73<label for="rb-confirm">Typ de archiefnaam over</label>
74<input id="rb-confirm" type="text" name="confirm" autocomplete="off" required>
75<label><input type="checkbox" name="understood" value="1" required> Ik begrijp dat dit niet ongedaan kan worden gemaakt</label>
76<p><button class="danger" type="submit">Rollback starten</button></p>
77</form>
78</details>
79{{else}}<p>Nog geen archieven.</p>{{end}}
80</section>
81
82<section id="api">
83<h2>API</h2>
84<p><small>Alles hierboven kan ook via de API, met <code>Authorization: Bearer &lt;admin.token&gt;</code>. Acties met ✓ kan ook de gekoppelde BlueGit uitvoeren.</small></p>
85<table><thead><tr><th>Methode</th><th>Pad</th><th>Actie</th><th>BlueGit</th></tr></thead><tbody>
86{{range .Actions}}<tr><td><code>{{.Method}}</code></td><td><code>{{.Path}}</code></td><td>{{.Title}}</td><td>{{if .Signed}}✓{{end}}</td></tr>{{end}}
87</tbody></table>
88</section>
89<p><small>bluegit-backup {{.Version}}</small></p>
90</main></body></html>
91{{define "connectform"}}
92<form method="post" action="/ui/act/connect">
93<input type="hidden" name="csrf" value="{{.CSRF}}">
94<label for="c-url">BlueGit-adres</label><input id="c-url" type="url" name="url" placeholder="https://git.example.com" value="{{.Status.BlueGitURL}}" required>
95<label for="c-key">Backupserver-Key</label><input id="c-key" type="password" name="key" placeholder="bgbk_…" autocomplete="off" required>
96<label>Hoorde deze server eerder bij een andere BlueGit?</label>
97<label><input type="radio" name="on_conflict" value="" checked> Nee, of vraag het eerst</label>
98<label><input type="radio" name="on_conflict" value="wipe"> Oude backups wissen en opnieuw beginnen</label>
99<label><input type="radio" name="on_conflict" value="restore"> De nieuwe BlueGit herstellen met de backupdata</label>
100<p><button type="submit">Koppelen</button></p>
101</form>
102{{end}}
internal/backupserver/server/web/login.html added +12 −0
@@ -0,0 +1,12 @@
1 <!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
2 <title>Inloggen · bluegit-backup</title>{{template "style"}}</head><body>
3 <header><h1>bluegit-backup</h1></header>
4 <main class="login"><section>
5 <h2>Inloggen</h2>
6 {{if .Error}}<div class="flash err">Dat token klopt niet.</div>{{end}}
7 <form method="post" action="/login">
8 <label for="token">Beheertoken <small>Staat in <code>data_dir/admin.token</code>. Toon het met <code>sudo -u bluegit-backup bluegit-backup token</code>.</small></label>
9 <input id="token" name="token" type="password" autocomplete="current-password" required autofocus>
10 <p><button type="submit">Inloggen</button></p>
11 </form>
12 </section><p><small>versie {{.Version}}</small></p></main></body></html>
@@ -0,0 +1,12 @@
1<!doctype html><html lang="nl"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
2<title>Inloggen · bluegit-backup</title>{{template "style"}}</head><body>
3<header><h1>bluegit-backup</h1></header>
4<main class="login"><section>
5<h2>Inloggen</h2>
6{{if .Error}}<div class="flash err">Dat token klopt niet.</div>{{end}}
7<form method="post" action="/login">
8<label for="token">Beheertoken <small>Staat in <code>data_dir/admin.token</code>. Toon het met <code>sudo -u bluegit-backup bluegit-backup token</code>.</small></label>
9<input id="token" name="token" type="password" autocomplete="current-password" required autofocus>
10<p><button type="submit">Inloggen</button></p>
11</form>
12</section><p><small>versie {{.Version}}</small></p></main></body></html>
internal/backupserver/server/web/style.html added +24 −0
@@ -0,0 +1,24 @@
1 {{define "style"}}<style>
2 :root{--blue:#1f6feb;--bg:#f6f8fa;--fg:#1f2328;--muted:#656d76;--border:#d0d7de;--danger:#cf222e;--ok:#1a7f37}
3 *{box-sizing:border-box}body{margin:0;font:15px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif;background:var(--bg);color:var(--fg)}
4 header{background:#0d1b3e;color:#fff;padding:.8rem 1.5rem;display:flex;align-items:center;gap:1rem}
5 header h1{font-size:1.15rem;margin:0;flex:1}header form{margin:0}
6 main{max-width:1000px;margin:1.5rem auto;padding:0 1rem}
7 section{background:#fff;border:1px solid var(--border);border-radius:8px;padding:1rem 1.25rem;margin-bottom:1.25rem}
8 section h2{margin:.1rem 0 .8rem;font-size:1.1rem}
9 dl{display:grid;grid-template-columns:max-content 1fr;gap:.25rem 1rem;margin:0}dt{color:var(--muted)}dd{margin:0}
10 label{display:block;font-weight:600;margin:.6rem 0 .2rem}small{color:var(--muted);font-weight:400;display:block}
11 input[type=text],input[type=password],input[type=url]{width:100%;padding:.45rem .6rem;border:1px solid var(--border);border-radius:6px;font:inherit}
12 button{background:var(--blue);color:#fff;border:0;border-radius:6px;padding:.45rem .9rem;font:inherit;cursor:pointer}
13 button.secondary{background:#fff;color:var(--fg);border:1px solid var(--border)}button.danger{background:var(--danger)}
14 .row{display:flex;gap:.5rem;flex-wrap:wrap;align-items:center}.row form{margin:0}
15 table{width:100%;border-collapse:collapse}th,td{text-align:left;padding:.4rem .5rem;border-bottom:1px solid var(--border)}
16 .flash{padding:.7rem 1rem;border-radius:6px;margin-bottom:1rem;background:#dafbe1;border:1px solid var(--ok)}
17 .flash.err{background:#ffebe9;border-color:var(--danger)}
18 .badge{display:inline-block;padding:0 .5rem;border-radius:1rem;font-size:.85rem;background:#ddf4ff}
19 .badge.off{background:#ffebe9}
20 .backup-danger{border:2px solid var(--danger);background:#ffebe9;border-radius:8px;padding:.8rem 1rem;margin:.8rem 0}
21 .backup-danger strong{color:var(--danger);font-size:1.1rem;display:block}
22 details{margin-top:.5rem}code{background:var(--bg);padding:0 .3rem;border-radius:4px}
23 .login{max-width:420px;margin:4rem auto}
24 </style>{{end}}
@@ -0,0 +1,24 @@
1{{define "style"}}<style>
2:root{--blue:#1f6feb;--bg:#f6f8fa;--fg:#1f2328;--muted:#656d76;--border:#d0d7de;--danger:#cf222e;--ok:#1a7f37}
3*{box-sizing:border-box}body{margin:0;font:15px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif;background:var(--bg);color:var(--fg)}
4header{background:#0d1b3e;color:#fff;padding:.8rem 1.5rem;display:flex;align-items:center;gap:1rem}
5header h1{font-size:1.15rem;margin:0;flex:1}header form{margin:0}
6main{max-width:1000px;margin:1.5rem auto;padding:0 1rem}
7section{background:#fff;border:1px solid var(--border);border-radius:8px;padding:1rem 1.25rem;margin-bottom:1.25rem}
8section h2{margin:.1rem 0 .8rem;font-size:1.1rem}
9dl{display:grid;grid-template-columns:max-content 1fr;gap:.25rem 1rem;margin:0}dt{color:var(--muted)}dd{margin:0}
10label{display:block;font-weight:600;margin:.6rem 0 .2rem}small{color:var(--muted);font-weight:400;display:block}
11input[type=text],input[type=password],input[type=url]{width:100%;padding:.45rem .6rem;border:1px solid var(--border);border-radius:6px;font:inherit}
12button{background:var(--blue);color:#fff;border:0;border-radius:6px;padding:.45rem .9rem;font:inherit;cursor:pointer}
13button.secondary{background:#fff;color:var(--fg);border:1px solid var(--border)}button.danger{background:var(--danger)}
14.row{display:flex;gap:.5rem;flex-wrap:wrap;align-items:center}.row form{margin:0}
15table{width:100%;border-collapse:collapse}th,td{text-align:left;padding:.4rem .5rem;border-bottom:1px solid var(--border)}
16.flash{padding:.7rem 1rem;border-radius:6px;margin-bottom:1rem;background:#dafbe1;border:1px solid var(--ok)}
17.flash.err{background:#ffebe9;border-color:var(--danger)}
18.badge{display:inline-block;padding:0 .5rem;border-radius:1rem;font-size:.85rem;background:#ddf4ff}
19.badge.off{background:#ffebe9}
20.backup-danger{border:2px solid var(--danger);background:#ffebe9;border-radius:8px;padding:.8rem 1rem;margin:.8rem 0}
21.backup-danger strong{color:var(--danger);font-size:1.1rem;display:block}
22details{margin-top:.5rem}code{background:var(--bg);padding:0 .3rem;border-radius:4px}
23.login{max-width:420px;margin:4rem auto}
24</style>{{end}}
internal/backupserver/throttle/throttle.go +29 −3
@@ -49,15 +49,21 @@ func (l *Limiter) Rate() int64 {
49 49 if l == nil {
50 50 return 0
51 51 }
52 l.mu.Lock()
53 defer l.mu.Unlock()
52 54 return int64(l.rate)
53 55 }
54 56
55 57 // Wait blokkeert tot n bytes gelezen mogen worden.
56 58 func (l *Limiter) Wait(ctx context.Context, n int) error {
57 if l == nil || l.rate <= 0 || n <= 0 {
59 if l == nil || n <= 0 {
58 60 return nil
59 61 }
60 62 l.mu.Lock()
63 if l.rate <= 0 {
64 l.mu.Unlock()
65 return nil
66 }
61 67 now := l.now()
62 68 l.tokens += now.Sub(l.last).Seconds() * l.rate
63 69 if l.tokens > l.burst {
@@ -78,7 +84,7 @@ func (l *Limiter) Wait(ctx context.Context, n int) error {
78 84
79 85 // Reader begrenst r met l.
80 86 func (l *Limiter) Reader(ctx context.Context, r io.Reader) io.Reader {
81 if l == nil || l.rate <= 0 {
87 if l == nil {
82 88 return r
83 89 }
84 90 return &reader{ctx: ctx, r: r, l: l}
@@ -91,7 +97,10 @@ type reader struct {
91 97 }
92 98
93 99 func (t *reader) Read(p []byte) (int, error) {
94 if max := int(t.l.burst); len(p) > max {
100 t.l.mu.Lock()
101 max := int(t.l.burst)
102 t.l.mu.Unlock()
103 if len(p) > max {
95 104 p = p[:max]
96 105 }
97 106 n, err := t.r.Read(p)
@@ -102,3 +111,20 @@ func (t *reader) Read(p []byte) (int, error) {
102 111 }
103 112 return n, err
104 113 }
114
115 // SetRate past de snelheid aan zonder lopende downloads te onderbreken.
116 func (l *Limiter) SetRate(bytesPerSec int64) {
117 if l == nil {
118 return
119 }
120 l.mu.Lock()
121 defer l.mu.Unlock()
122 l.rate = float64(bytesPerSec)
123 l.burst = l.rate / 4
124 if l.burst < 16<<10 {
125 l.burst = 16 << 10
126 }
127 if l.tokens > l.burst {
128 l.tokens = l.burst
129 }
130 }
@@ -49,15 +49,21 @@ func (l *Limiter) Rate() int64 {
49 if l == nil {
49 if l == nil {
50 return 0
50 return 0
51 }
51 }
52 l.mu.Lock()
53 defer l.mu.Unlock()
52 return int64(l.rate)
54 return int64(l.rate)
53}
55}
54
56
55// Wait blokkeert tot n bytes gelezen mogen worden.
57// Wait blokkeert tot n bytes gelezen mogen worden.
56func (l *Limiter) Wait(ctx context.Context, n int) error {
58func (l *Limiter) Wait(ctx context.Context, n int) error {
57 if l == nil || l.rate <= 0 || n <= 0 {
59 if l == nil || n <= 0 {
58 return nil
60 return nil
59 }
61 }
60 l.mu.Lock()
62 l.mu.Lock()
63 if l.rate <= 0 {
64 l.mu.Unlock()
65 return nil
66 }
61 now := l.now()
67 now := l.now()
62 l.tokens += now.Sub(l.last).Seconds() * l.rate
68 l.tokens += now.Sub(l.last).Seconds() * l.rate
63 if l.tokens > l.burst {
69 if l.tokens > l.burst {
@@ -78,7 +84,7 @@ func (l *Limiter) Wait(ctx context.Context, n int) error {
78
84
79// Reader begrenst r met l.
85// Reader begrenst r met l.
80func (l *Limiter) Reader(ctx context.Context, r io.Reader) io.Reader {
86func (l *Limiter) Reader(ctx context.Context, r io.Reader) io.Reader {
81 if l == nil || l.rate <= 0 {
87 if l == nil {
82 return r
88 return r
83 }
89 }
84 return &reader{ctx: ctx, r: r, l: l}
90 return &reader{ctx: ctx, r: r, l: l}
@@ -91,7 +97,10 @@ type reader struct {
91}
97}
92
98
93func (t *reader) Read(p []byte) (int, error) {
99func (t *reader) Read(p []byte) (int, error) {
94 if max := int(t.l.burst); len(p) > max {
100 t.l.mu.Lock()
101 max := int(t.l.burst)
102 t.l.mu.Unlock()
103 if len(p) > max {
95 p = p[:max]
104 p = p[:max]
96 }
105 }
97 n, err := t.r.Read(p)
106 n, err := t.r.Read(p)
@@ -102,3 +111,20 @@ func (t *reader) Read(p []byte) (int, error) {
102 }
111 }
103 return n, err
112 return n, err
104}
113}
114
115// SetRate past de snelheid aan zonder lopende downloads te onderbreken.
116func (l *Limiter) SetRate(bytesPerSec int64) {
117 if l == nil {
118 return
119 }
120 l.mu.Lock()
121 defer l.mu.Unlock()
122 l.rate = float64(bytesPerSec)
123 l.burst = l.rate / 4
124 if l.burst < 16<<10 {
125 l.burst = 16 << 10
126 }
127 if l.tokens > l.burst {
128 l.tokens = l.burst
129 }
130}
internal/backupserver/throttle/throttle_test.go +20 −2
@@ -33,8 +33,8 @@ func TestLimiterAverage(t *testing.T) {
33 33 func TestUnlimited(t *testing.T) {
34 34 l := New(0)
35 35 r := bytes.NewReader([]byte("abc"))
36 if l.Reader(context.Background(), r) != r {
37 t.Fatal("onbegrensd hoort de reader niet te wikkelen")
36 if b, _ := io.ReadAll(l.Reader(context.Background(), r)); string(b) != "abc" {
37 t.Fatal(string(b))
38 38 }
39 39 if err := l.Wait(context.Background(), 1<<30); err != nil {
40 40 t.Fatal(err)
@@ -50,3 +50,21 @@ func TestCancel(t *testing.T) {
50 50 t.Fatal("geen fout na annuleren")
51 51 }
52 52 }
53
54 func TestSetRate(t *testing.T) {
55 l := New(0)
56 l.SetRate(2048)
57 if l.Rate() != 2048 {
58 t.Fatal(l.Rate())
59 }
60 var slept time.Duration
61 l.sleep = func(_ context.Context, d time.Duration) error { slept += d; return nil }
62 now := time.Unix(0, 0)
63 l.now = func() time.Time { return now }
64 l.last = now
65 l.tokens = 0
66 _ = l.Wait(context.Background(), 4096)
67 if slept != 2*time.Second {
68 t.Fatal(slept)
69 }
70 }
@@ -33,8 +33,8 @@ func TestLimiterAverage(t *testing.T) {
33func TestUnlimited(t *testing.T) {
33func TestUnlimited(t *testing.T) {
34 l := New(0)
34 l := New(0)
35 r := bytes.NewReader([]byte("abc"))
35 r := bytes.NewReader([]byte("abc"))
36 if l.Reader(context.Background(), r) != r {
36 if b, _ := io.ReadAll(l.Reader(context.Background(), r)); string(b) != "abc" {
37 t.Fatal("onbegrensd hoort de reader niet te wikkelen")
37 t.Fatal(string(b))
38 }
38 }
39 if err := l.Wait(context.Background(), 1<<30); err != nil {
39 if err := l.Wait(context.Background(), 1<<30); err != nil {
40 t.Fatal(err)
40 t.Fatal(err)
@@ -50,3 +50,21 @@ func TestCancel(t *testing.T) {
50 t.Fatal("geen fout na annuleren")
50 t.Fatal("geen fout na annuleren")
51 }
51 }
52}
52}
53
54func TestSetRate(t *testing.T) {
55 l := New(0)
56 l.SetRate(2048)
57 if l.Rate() != 2048 {
58 t.Fatal(l.Rate())
59 }
60 var slept time.Duration
61 l.sleep = func(_ context.Context, d time.Duration) error { slept += d; return nil }
62 now := time.Unix(0, 0)
63 l.now = func() time.Time { return now }
64 l.last = now
65 l.tokens = 0
66 _ = l.Wait(context.Background(), 4096)
67 if slept != 2*time.Second {
68 t.Fatal(slept)
69 }
70}
packaging/backup/config.yml +2 −2
@@ -1,7 +1,7 @@
1 1 # bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
2 listen: 0.0.0.0:8790
2 listen: 0.0.0.0:8080
3 3 # Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
4 public_url: http://backup.lan:8790
4 public_url: http://backup.lan:8080
5 5 data_dir: /var/lib/bluegit-backup
6 6 # Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
7 7 archive_interval: 24h
@@ -1,7 +1,7 @@
1# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
1# bluegit-backup. Kopieer naar /etc/bluegit-backup/config.yml.
2listen: 0.0.0.0:8790
2listen: 0.0.0.0:8080
3# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
3# Waar BlueGit deze server bereikt (meldingen, archieflijst, rollback).
4public_url: http://backup.lan:8790
4public_url: http://backup.lan:8080
5data_dir: /var/lib/bluegit-backup
5data_dir: /var/lib/bluegit-backup
6# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
6# Zo vaak wordt de hele kopie gecomprimeerd opgeslagen. Standaard dagelijks.
7archive_interval: 24h
7archive_interval: 24h