BlueGit

timfa bluegit

Compatibiliteit met BlueGit: protocolversie melden, weigeren en waarschuwen

- Protocol en minimum in koppen (X-Backup-*) en uit BlueGit-info/koppen
- Sync, rollback en restore geweigerd als het niet past (409), met uitleg
- Banner en protocolregel in de webinterface, velden in de status-API
- Integratietests 'BlueGit te oud' en 'backup te oud' (test-build met
  protocol 99), niet-beheerder ziet geen banner
- .bluegit-ref tijdelijk op feature/backup-compat

timfa Grok Bot · pushed by timfa

Authored 2026-11-15 · 1 day ago

Hash
cce9f73a7f7b163c8a14e2cca254f3e7da51d5f0
Parent
18035dca
13 files changed +567 −8
docs/ASSUMPTIONS.md +15 −1
@@ -111,6 +111,20 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
111 111 - `connect` vraagt de keuze in de terminal. Zonder keuze (lege invoer) gebeurt er niets. Zonder terminal gebruik je `--on-conflict wipe|restore`.
112 112 - De nieuwe BlueGit moet al draaien met een eigen `config.yml` en data-schijf. Het herstel vult alleen de inhoud.
113 113
114 ## Compatibiliteit (t1209u)
115
116 - Elke kant heeft een **protocolversie** (een geheel getal, wat hij spreekt) en een **minimumversie** (de oudste versie van de andere kant die hij nog ondersteunt). Geen min/max: een nieuwere kant geeft zelf aan tot hoe ver terug hij de ander nog ondersteunt; dat dekt beide richtingen.
117 - Ze passen als de backup server minstens het minimum van BlueGit spreekt en BlueGit minstens het minimum van de backup server. Anders: `backup_too_old` (BlueGit vraagt meer) of `bluegit_too_old` (de backup server vraagt meer). Vraagt allebei meer, dan meldt BlueGit `backup_too_old`.
118 - Nu: BlueGit protocol 1 (minimum 1), bluegit-backup protocol 1 (minimum 1). Wat tot nu toe bestond (BlueGit tot en met de backup-merge, bluegit-backup v0.1.0) stuurt geen protocol en geldt als protocol 1; die blijven dus samenwerken met deze versie.
119 - Het protocol gaat de **volgende keer omhoog** als een wijziging oude tegenpartijen breekt. Het minimum gaat pas omhoog als die oude versie echt niet meer werkt.
120 - **Uitwisseling**: koppen op elk verzoek en antwoord tussen de twee (`X-BlueGit-Protocol`/`-Min-Protocol`/`-Version` van BlueGit, `X-Backup-Protocol`/`-Min-Protocol`/`-Version` van de backup server), en `protocol`/`min_protocol`/`version` in `GET /api/v1/backup/info`. Zo hoort de backup server het bij info, sync en elke melding, en BlueGit bij elk verzoek met de key en elk antwoord op een melding of beheeractie.
121 - BlueGit bewaart het laatst gemelde protocol per backup server in `backup.json`. De banner leest alleen dat bestand (geen netwerkverkeer bij elke pagina). Een nieuwe key wist het, tot de server zich opnieuw meldt.
122 - **Banner**: alleen voor instance-beheerders, bovenaan elke HTML-pagina (onder de kopbalk), per niet-passende backup server één regel: de naam, of BlueGit of de backup server geüpdatet moet worden, beide protocolnummers, en een link naar Beheer → Backup. In het Engels, Nederlands, Duits en Frans (en spijkerschrift via het Engels).
123 - **Weigeren**: BlueGit geeft `426 Upgrade Required` op `manifest`, `file` en `restore`. `info` en `connect` blijven werken, zodat een niet-passende server toch kan koppelen en de beheerder de banner ziet. De backup server vraagt vóór elke sync, rollback en restore `info` op en weigert zelf (`409`); een rollback vanuit BlueGit weigert hij als het laatst gemelde protocol niet past. Archieven bekijken, downloaden, verwijderen en instellingen blijven werken.
124 - De backup server toont het in zijn webinterface (banner bovenaan, regel *Protocol* in het overzicht) en in `GET /api/v1/admin/status` (`protocol`, `min_protocol`, `bluegit_protocol`, `bluegit_min_protocol`, `bluegit_version`, `compat`, `compat_message`).
125 - **Versie**: de backup server meldt `Version` (bij het bouwen gezet). BlueGit heeft geen versienummer en meldt de commit uit de build-info (12 tekens), of `dev`.
126 - **Tests**: "backup te oud" bootsen we na met een test-build van BlueGit met `-ldflags -X …/internal/backup.protocolVersion=99 -X ….minBackupProtocol=99` (`scripts/build-bluegit.sh` bouwt die naast de gewone). "BlueGit te oud" bootsen we na door in de test het protocol van de backup server (die in het testproces draait) op 2 met minimum 2 te zetten. Een gebruiker die geen beheerder is, maken we door dezelfde BlueGit te herstarten met een andere dev-gebruiker.
127
114 128 ## Releases en tests
115 129
116 130 - "Dezelfde release-opties als BlueGit" betekent:
@@ -119,6 +133,6 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
119 133 - Geen self-update (Tim, 2026-11-15, t1209u): gebruikers updaten de backup server zelf (AUR-helper of een nieuwe binary). Er is geen update-endpoint, geen update-unit en geen pipeline-job die een server bijwerkt.
120 134 - 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.
121 135 - 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`; de BlueGit-kant is op 2026-11-15 gemerged).
136 - De integratietests bouwen BlueGit van de ref in `.bluegit-ref` (`master`; tijdens de compatibiliteitswijziging tijdelijk `feature/backup-compat`, tot die in BlueGit gemerged is).
123 137 - 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.
124 138 - 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`.
@@ -111,6 +111,20 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
111- `connect` vraagt de keuze in de terminal. Zonder keuze (lege invoer) gebeurt er niets. Zonder terminal gebruik je `--on-conflict wipe|restore`.
111- `connect` vraagt de keuze in de terminal. Zonder keuze (lege invoer) gebeurt er niets. Zonder terminal gebruik je `--on-conflict wipe|restore`.
112- De nieuwe BlueGit moet al draaien met een eigen `config.yml` en data-schijf. Het herstel vult alleen de inhoud.
112- De nieuwe BlueGit moet al draaien met een eigen `config.yml` en data-schijf. Het herstel vult alleen de inhoud.
113
113
114## Compatibiliteit (t1209u)
115
116- Elke kant heeft een **protocolversie** (een geheel getal, wat hij spreekt) en een **minimumversie** (de oudste versie van de andere kant die hij nog ondersteunt). Geen min/max: een nieuwere kant geeft zelf aan tot hoe ver terug hij de ander nog ondersteunt; dat dekt beide richtingen.
117- Ze passen als de backup server minstens het minimum van BlueGit spreekt en BlueGit minstens het minimum van de backup server. Anders: `backup_too_old` (BlueGit vraagt meer) of `bluegit_too_old` (de backup server vraagt meer). Vraagt allebei meer, dan meldt BlueGit `backup_too_old`.
118- Nu: BlueGit protocol 1 (minimum 1), bluegit-backup protocol 1 (minimum 1). Wat tot nu toe bestond (BlueGit tot en met de backup-merge, bluegit-backup v0.1.0) stuurt geen protocol en geldt als protocol 1; die blijven dus samenwerken met deze versie.
119- Het protocol gaat de **volgende keer omhoog** als een wijziging oude tegenpartijen breekt. Het minimum gaat pas omhoog als die oude versie echt niet meer werkt.
120- **Uitwisseling**: koppen op elk verzoek en antwoord tussen de twee (`X-BlueGit-Protocol`/`-Min-Protocol`/`-Version` van BlueGit, `X-Backup-Protocol`/`-Min-Protocol`/`-Version` van de backup server), en `protocol`/`min_protocol`/`version` in `GET /api/v1/backup/info`. Zo hoort de backup server het bij info, sync en elke melding, en BlueGit bij elk verzoek met de key en elk antwoord op een melding of beheeractie.
121- BlueGit bewaart het laatst gemelde protocol per backup server in `backup.json`. De banner leest alleen dat bestand (geen netwerkverkeer bij elke pagina). Een nieuwe key wist het, tot de server zich opnieuw meldt.
122- **Banner**: alleen voor instance-beheerders, bovenaan elke HTML-pagina (onder de kopbalk), per niet-passende backup server één regel: de naam, of BlueGit of de backup server geüpdatet moet worden, beide protocolnummers, en een link naar Beheer → Backup. In het Engels, Nederlands, Duits en Frans (en spijkerschrift via het Engels).
123- **Weigeren**: BlueGit geeft `426 Upgrade Required` op `manifest`, `file` en `restore`. `info` en `connect` blijven werken, zodat een niet-passende server toch kan koppelen en de beheerder de banner ziet. De backup server vraagt vóór elke sync, rollback en restore `info` op en weigert zelf (`409`); een rollback vanuit BlueGit weigert hij als het laatst gemelde protocol niet past. Archieven bekijken, downloaden, verwijderen en instellingen blijven werken.
124- De backup server toont het in zijn webinterface (banner bovenaan, regel *Protocol* in het overzicht) en in `GET /api/v1/admin/status` (`protocol`, `min_protocol`, `bluegit_protocol`, `bluegit_min_protocol`, `bluegit_version`, `compat`, `compat_message`).
125- **Versie**: de backup server meldt `Version` (bij het bouwen gezet). BlueGit heeft geen versienummer en meldt de commit uit de build-info (12 tekens), of `dev`.
126- **Tests**: "backup te oud" bootsen we na met een test-build van BlueGit met `-ldflags -X …/internal/backup.protocolVersion=99 -X ….minBackupProtocol=99` (`scripts/build-bluegit.sh` bouwt die naast de gewone). "BlueGit te oud" bootsen we na door in de test het protocol van de backup server (die in het testproces draait) op 2 met minimum 2 te zetten. Een gebruiker die geen beheerder is, maken we door dezelfde BlueGit te herstarten met een andere dev-gebruiker.
127
114## Releases en tests
128## Releases en tests
115
129
116- "Dezelfde release-opties als BlueGit" betekent:
130- "Dezelfde release-opties als BlueGit" betekent:
@@ -119,6 +133,6 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
119- Geen self-update (Tim, 2026-11-15, t1209u): gebruikers updaten de backup server zelf (AUR-helper of een nieuwe binary). Er is geen update-endpoint, geen update-unit en geen pipeline-job die een server bijwerkt.
133- Geen self-update (Tim, 2026-11-15, t1209u): gebruikers updaten de backup server zelf (AUR-helper of een nieuwe binary). Er is geen update-endpoint, geen update-unit en geen pipeline-job die een server bijwerkt.
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.
134- 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.
121- Releases vanaf master staan aan zodra `.release-enabled` in de repository staat. Zonder dat bestand doen de release-scripts niets.
135- 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`; de BlueGit-kant is op 2026-11-15 gemerged).
136- De integratietests bouwen BlueGit van de ref in `.bluegit-ref` (`master`; tijdens de compatibiliteitswijziging tijdelijk `feature/backup-compat`, tot die in BlueGit gemerged is).
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.
137- 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.
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`.
138- 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 +18 −0
@@ -63,6 +63,24 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha256
63 63
64 64 **Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
65 65
66 ### Compatibiliteit (protocolversie)
67
68 Elke kant heeft een **protocolversie** (wat hij spreekt) en een **minimumversie** (de oudste versie van de andere kant die hij nog ondersteunt). Nu is dat aan beide kanten protocol 1, minimum 1.
69
70 - BlueGit stuurt `X-BlueGit-Protocol`, `X-BlueGit-Min-Protocol` en `X-BlueGit-Version` mee op elk verzoek aan de backup server (meldingen, status, beheeracties, rollback) en op elk antwoord van de backup-API; `GET /api/v1/backup/info` geeft ook `protocol`, `min_protocol`, `version` en `compat`.
71 - De backup server stuurt `X-Backup-Protocol`, `X-Backup-Min-Protocol` en `X-Backup-Version` mee op elk verzoek aan BlueGit en op elk antwoord.
72 - Ontbreken de koppen, dan is het protocol 1 (BlueGit vóór deze versie en bluegit-backup v0.1.0).
73 - Ze passen als de backup server minstens het minimum van BlueGit spreekt en BlueGit minstens het minimum van de backup server. Anders is het `backup_too_old` (update de backup server) of `bluegit_too_old` (update BlueGit).
74
75 Wat er gebeurt als ze niet passen:
76
77 - BlueGit onthoudt per backup server het laatst gemelde protocol in `backup.json` en toont **beheerders bovenaan elke pagina een banner** met de naam van de backup server, wie er geüpdatet moet worden en een link naar Beheer → Backup. Andere gebruikers zien niets. De lijst en de pagina van de server tonen het ook, en de API (`GET /api/v1/admin/backup`) geeft per server `compat` en `protocol`.
78 - BlueGit weigert `manifest`, `file` en `restore` met `426 Upgrade Required` (`{"error", "compat", "protocol", "min_protocol"}`); `info` en `connect` blijven werken, zodat beide kanten het kunnen melden.
79 - De backup server vraagt vóór elke sync, rollback of restore `info` op en weigert zelf als het niet past; zijn webinterface toont een banner en `GET /api/v1/admin/status` geeft `compat` en `compat_message`.
80 - Na een update van de verouderde kant herstelt alles vanzelf bij het volgende contact.
81
82 Een test-build met een ander protocol: `go build -ldflags "-X gitlab.com/Timfa/bluegit/internal/backup.protocolVersion=99 -X gitlab.com/Timfa/bluegit/internal/backup.minBackupProtocol=99" ./cmd/bluegit` (de integratietests van bluegit-backup doen dat).
83
66 84 ## Wat er in een backup zit
67 85
68 86 ```text
@@ -63,6 +63,24 @@ X-BlueGit-Signature: hex(HMAC-SHA256(geheim, METHOD "\n" PAD "\n" TS "\n" sha256
63
63
64**Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
64**Meldingen.** Elke gekoppelde backup server krijgt ze, ondertekend met zijn eigen key. Na elk schrijvend HTTP-verzoek (behalve de backup-API zelf en `git-upload-pack`), na elke push (ook SSH) en bij elke CI-gebeurtenis meldt BlueGit een wijziging. Meldingen worden 2 seconden gebundeld en bij een fout tot vier keer opnieuw geprobeerd. De backup server haalt daarnaast periodiek alles op, dus een gemiste melding kost alleen vertraging. Het adres van de backup server mag een privéadres zijn (de beheerder koppelt hem met een eigen key); de SSRF-regels van webhooks gelden hier niet.
65
65
66### Compatibiliteit (protocolversie)
67
68Elke kant heeft een **protocolversie** (wat hij spreekt) en een **minimumversie** (de oudste versie van de andere kant die hij nog ondersteunt). Nu is dat aan beide kanten protocol 1, minimum 1.
69
70- BlueGit stuurt `X-BlueGit-Protocol`, `X-BlueGit-Min-Protocol` en `X-BlueGit-Version` mee op elk verzoek aan de backup server (meldingen, status, beheeracties, rollback) en op elk antwoord van de backup-API; `GET /api/v1/backup/info` geeft ook `protocol`, `min_protocol`, `version` en `compat`.
71- De backup server stuurt `X-Backup-Protocol`, `X-Backup-Min-Protocol` en `X-Backup-Version` mee op elk verzoek aan BlueGit en op elk antwoord.
72- Ontbreken de koppen, dan is het protocol 1 (BlueGit vóór deze versie en bluegit-backup v0.1.0).
73- Ze passen als de backup server minstens het minimum van BlueGit spreekt en BlueGit minstens het minimum van de backup server. Anders is het `backup_too_old` (update de backup server) of `bluegit_too_old` (update BlueGit).
74
75Wat er gebeurt als ze niet passen:
76
77- BlueGit onthoudt per backup server het laatst gemelde protocol in `backup.json` en toont **beheerders bovenaan elke pagina een banner** met de naam van de backup server, wie er geüpdatet moet worden en een link naar Beheer → Backup. Andere gebruikers zien niets. De lijst en de pagina van de server tonen het ook, en de API (`GET /api/v1/admin/backup`) geeft per server `compat` en `protocol`.
78- BlueGit weigert `manifest`, `file` en `restore` met `426 Upgrade Required` (`{"error", "compat", "protocol", "min_protocol"}`); `info` en `connect` blijven werken, zodat beide kanten het kunnen melden.
79- De backup server vraagt vóór elke sync, rollback of restore `info` op en weigert zelf als het niet past; zijn webinterface toont een banner en `GET /api/v1/admin/status` geeft `compat` en `compat_message`.
80- Na een update van de verouderde kant herstelt alles vanzelf bij het volgende contact.
81
82Een test-build met een ander protocol: `go build -ldflags "-X gitlab.com/Timfa/bluegit/internal/backup.protocolVersion=99 -X gitlab.com/Timfa/bluegit/internal/backup.minBackupProtocol=99" ./cmd/bluegit` (de integratietests van bluegit-backup doen dat).
83
66## Wat er in een backup zit
84## Wat er in een backup zit
67
85
68```text
86```text
docs/BACKUP-SERVER.md +17 −1
@@ -72,6 +72,8 @@ Daar staan:
72 72 - **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
73 73 - **API**: de lijst met alle acties.
74 74
75 Passen BlueGit en deze backup server niet bij elkaar (een van de twee is verouderd), dan staat er bovenaan een waarschuwing die zegt wie er geüpdatet moet worden. De server synchroniseert en zet dan niets terug tot dat gebeurd is. Zie [Compatibiliteit](#compatibiliteit).
76
75 77 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 78
77 79 ## API
@@ -96,6 +98,18 @@ Elke actie uit de webinterface is ook een API-aanroep, met `Authorization: Beare
96 98
97 99 ✓ 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 100
101 ## Compatibiliteit
102
103 BlueGit en de backup server melden elkaar hun protocolversie en de oudste versie van de andere kant die ze nog ondersteunen (koppen `X-Backup-Protocol`/`X-Backup-Min-Protocol` en `X-BlueGit-Protocol`/`X-BlueGit-Min-Protocol`, plus `info`). Deze versie spreekt protocol 1 en ondersteunt BlueGit vanaf protocol 1. Een BlueGit die geen protocol meldt, spreekt protocol 1.
104
105 Past het niet:
106
107 - weigert de backup server te synchroniseren en terug te zetten (`409`), en geven `GET /api/v1/admin/status` en de webinterface `compat` (`bluegit_too_old` of `backup_too_old`) en een uitleg;
108 - zien beheerders in BlueGit bovenaan elke pagina een banner met de naam van de backup server en wie er geüpdatet moet worden, met een link naar Beheer → Backup;
109 - weigert BlueGit de gegevens (`426`).
110
111 Updaten doe je zelf (zie [Releases](#releases)); bij het volgende contact is alles weer normaal. Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md).
112
99 113 ## CLI
100 114
101 115 ```sh
@@ -170,8 +184,10 @@ De integratietests starten per test een echte BlueGit in een tijdelijke map (dev
170 184 | `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |
171 185 | `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |
172 186 | `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |
187 | `TestCompatBlueGitTooOld` | Backup server vraagt een nieuwer protocol: hij weigert sync en rollback, waarschuwt in UI en API; BlueGit toont beheerders de banner op elke pagina; na de update is alles weer normaal |
188 | `TestCompatBackupTooOld` | Test-build van BlueGit met protocol 99 (`-ldflags -X`): koppelen lukt, BlueGit geeft `426`, de backup server weigert, beheerders zien de banner en een gewone gebruiker niet |
173 189
174 De pipeline bouwt BlueGit van de ref in `.bluegit-ref` (`master`).
190 De pipeline bouwt BlueGit van de ref in `.bluegit-ref`, plus een test-build met protocol 99 (`.bluegit-bin/bluegit-future`) voor `TestCompatBackupTooOld`.
175 191
176 192 ## Licentie
177 193
@@ -72,6 +72,8 @@ Daar staan:
72- **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
72- **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
73- **API**: de lijst met alle acties.
73- **API**: de lijst met alle acties.
74
74
75Passen BlueGit en deze backup server niet bij elkaar (een van de twee is verouderd), dan staat er bovenaan een waarschuwing die zegt wie er geüpdatet moet worden. De server synchroniseert en zet dan niets terug tot dat gebeurd is. Zie [Compatibiliteit](#compatibiliteit).
76
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.
77De 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
78
77## API
79## API
@@ -96,6 +98,18 @@ Elke actie uit de webinterface is ook een API-aanroep, met `Authorization: Beare
96
98
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`.
99✓ 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
100
101## Compatibiliteit
102
103BlueGit en de backup server melden elkaar hun protocolversie en de oudste versie van de andere kant die ze nog ondersteunen (koppen `X-Backup-Protocol`/`X-Backup-Min-Protocol` en `X-BlueGit-Protocol`/`X-BlueGit-Min-Protocol`, plus `info`). Deze versie spreekt protocol 1 en ondersteunt BlueGit vanaf protocol 1. Een BlueGit die geen protocol meldt, spreekt protocol 1.
104
105Past het niet:
106
107- weigert de backup server te synchroniseren en terug te zetten (`409`), en geven `GET /api/v1/admin/status` en de webinterface `compat` (`bluegit_too_old` of `backup_too_old`) en een uitleg;
108- zien beheerders in BlueGit bovenaan elke pagina een banner met de naam van de backup server en wie er geüpdatet moet worden, met een link naar Beheer → Backup;
109- weigert BlueGit de gegevens (`426`).
110
111Updaten doe je zelf (zie [Releases](#releases)); bij het volgende contact is alles weer normaal. Het protocol staat in [docs/PROTOCOL.md](docs/PROTOCOL.md).
112
99## CLI
113## CLI
100
114
101```sh
115```sh
@@ -170,8 +184,10 @@ De integratietests starten per test een echte BlueGit in een tijdelijke map (dev
170| `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |
184| `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |
171| `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |
185| `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |
172| `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |
186| `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |
187| `TestCompatBlueGitTooOld` | Backup server vraagt een nieuwer protocol: hij weigert sync en rollback, waarschuwt in UI en API; BlueGit toont beheerders de banner op elke pagina; na de update is alles weer normaal |
188| `TestCompatBackupTooOld` | Test-build van BlueGit met protocol 99 (`-ldflags -X`): koppelen lukt, BlueGit geeft `426`, de backup server weigert, beheerders zien de banner en een gewone gebruiker niet |
173
189
174De pipeline bouwt BlueGit van de ref in `.bluegit-ref` (`master`).
190De pipeline bouwt BlueGit van de ref in `.bluegit-ref`, plus een test-build met protocol 99 (`.bluegit-bin/bluegit-future`) voor `TestCompatBackupTooOld`.
175
191
176## Licentie
192## Licentie
177
193
internal/backupserver/integration/compat_test.go added +147 −0
@@ -0,0 +1,147 @@
1 //go:build integration
2
3 package integration
4
5 import (
6 "net/http"
7 "strings"
8 "testing"
9 "time"
10
11 "git.timfalken.com/timfa/bluegit-backup/internal/protocol"
12 "git.timfalken.com/timfa/bluegit-backup/internal/server"
13 )
14
15 // setBackupProtocol bootst een andere versie van de backup server na (die
16 // draait in dit testproces). Terugzetten gebeurt aan het eind van de test.
17 func setBackupProtocol(t *testing.T, proto, min string) (restore func()) {
18 oldP, oldM := protocol.ProtocolVersion, protocol.MinBlueGitProtocol
19 protocol.ProtocolVersion, protocol.MinBlueGitProtocol = proto, min
20 restore = func() { protocol.ProtocolVersion, protocol.MinBlueGitProtocol = oldP, oldM }
21 t.Cleanup(restore)
22 return restore
23 }
24
25 // bannerPages zijn pagina's van verschillende soorten; de banner hoort op elk.
26 var bannerPages = []string{"/", "/users/tim", "/tim/alpha", "/admin", "/admin/backup", "/-/info", "/help"}
27
28 func requireBanner(t *testing.T, g *BlueGit, hc *http.Client, name string, want ...string) {
29 t.Helper()
30 for _, p := range bannerPages {
31 html := g.Page(hc, p)
32 if !strings.Contains(html, `class="compat-banner"`) || !strings.Contains(html, name) || !strings.Contains(html, `href="/admin/backup"`) {
33 t.Fatalf("%s: geen banner voor %q:\n%s", p, name, tail(html, 30))
34 }
35 for _, w := range want {
36 if !strings.Contains(html, w) {
37 t.Fatalf("%s: banner mist %q", p, w)
38 }
39 }
40 }
41 }
42
43 // Feature: een backup server die een nieuwer protocol vraagt dan BlueGit
44 // spreekt ("BlueGit te oud"). De backup server weigert te synchroniseren en
45 // terug te zetten en meldt het in zijn UI en API; BlueGit toont beheerders op
46 // elke pagina een banner. Na de update (hier: terug naar protocol 1) is
47 // alles weer normaal.
48 func TestCompatBlueGitTooOld(t *testing.T) {
49 g := startBlueGit(t)
50 g.Project("Alpha", "README.md", "v1")
51 b := startBackup(t, nil)
52 id, key := g.AddServer("nas")
53 b.Connect(g, key)
54 b.Sync()
55 arch := b.Archive()
56 if st := g.ServerStatus(id); st.Compat != "ok" || st.Protocol.Backup != 1 || st.Protocol.BlueGit != 1 {
57 t.Fatalf("begin: %+v", st)
58 }
59
60 // De backup server wordt "geüpdatet" naar protocol 2 en vraagt BlueGit ≥ 2.
61 restore := setBackupProtocol(t, "2", "2")
62 code, raw := b.Admin("POST", "/sync", nil)
63 if code != http.StatusConflict || !strings.Contains(string(raw), "BlueGit is verouderd") {
64 t.Fatalf("sync bij te oude BlueGit: %d %s", code, raw)
65 }
66 st := b.Status()
67 if st.Compat != "bluegit_too_old" || st.BlueGitProtocol != 1 || !strings.Contains(st.CompatMessage, "Update BlueGit") {
68 t.Fatalf("status: %+v", st)
69 }
70 if html := openUI(t, b).Page(); !strings.Contains(html, `class="compat-banner"`) || !strings.Contains(html, "Update BlueGit") {
71 t.Fatalf("backup-UI zonder waarschuwing:\n%s", tail(html, 40))
72 }
73 // BlueGit hoort het protocol in het antwoord van de backup server.
74 if st := g.ServerStatus(id); st.Compat != "bluegit_too_old" || st.Protocol.Backup != 2 || st.Protocol.BackupMin != 2 {
75 t.Fatalf("BlueGit: %+v", st)
76 }
77 // Terugzetten weigert de backup server; BlueGit blijft ongemoeid.
78 g.Commit("alpha", "na.txt", "x", "create")
79 if code, raw := g.Action(id, "rollback", map[string]any{"archive": arch, "confirm": arch}); code < 400 || !strings.Contains(string(raw), "verouderd") {
80 t.Fatalf("rollback bij te oude BlueGit: %d %s", code, raw)
81 }
82 if code, _ := g.File("alpha", "na.txt"); code != 200 {
83 t.Fatal("BlueGit is toch teruggezet")
84 }
85 requireBanner(t, g, g.Session(), "nas", "BlueGit is out of date", "Update BlueGit")
86
87 // "BlueGit geüpdatet" (hier: de backup server weer op protocol 1).
88 restore()
89 b.Sync()
90 if st := b.Status(); st.Compat != "ok" || st.CompatMessage != "" {
91 t.Fatalf("na update: %+v", st)
92 }
93 Eventually(t, 10*time.Second, "BlueGit ziet weer protocol 1", func() bool { return g.ServerStatus(id).Compat == "ok" })
94 if strings.Contains(g.Page(g.Session(), "/"), "compat-banner") {
95 t.Fatal("banner blijft na de update")
96 }
97 }
98
99 // Feature: BlueGit vraagt een nieuwer protocol dan de backup server spreekt
100 // ("backup te oud"). Nagebootst met een test-build van BlueGit met protocol
101 // 99 (-ldflags -X, scripts/build-bluegit.sh). Koppelen lukt, zodat het
102 // zichtbaar wordt; BlueGit weigert gegevens (426), de backup server weigert
103 // te synchroniseren, beheerders zien de banner en andere gebruikers niet.
104 func TestCompatBackupTooOld(t *testing.T) {
105 g := startBlueGitBin(t, bluegitFutureBin(t))
106 g.Project("Alpha", "README.md", "v1")
107 b := startBackup(t, nil)
108 id, key := g.AddServer("offsite")
109 code, raw := b.Admin("POST", "/connect", server.ConnectRequest{URL: g.URL, Key: key})
110 if code != 200 || !strings.Contains(string(raw), "backup_too_old") || !strings.Contains(string(raw), "Update de backup server") {
111 t.Fatalf("koppelen: %d %s", code, raw)
112 }
113 code, raw = b.Admin("POST", "/sync", nil)
114 if code != http.StatusConflict || !strings.Contains(string(raw), "deze backup server is verouderd") {
115 t.Fatalf("sync: %d %s", code, raw)
116 }
117 if st := b.Status(); st.Compat != "backup_too_old" || st.BlueGitProtocol != FutureProtocol || st.BlueGitMinProtocol != FutureProtocol {
118 t.Fatalf("status: %+v", st)
119 }
120 // Een oude backup server zonder protocolkoppen krijgt van BlueGit 426.
121 req, _ := http.NewRequest("GET", g.URL+"/api/v1/backup/manifest", nil)
122 req.Header.Set("Authorization", "Bearer "+key)
123 res, err := http.DefaultClient.Do(req)
124 if err != nil {
125 t.Fatal(err)
126 }
127 res.Body.Close()
128 if res.StatusCode != http.StatusUpgradeRequired {
129 t.Fatalf("manifest zonder koppen: %d", res.StatusCode)
130 }
131 if st := g.ServerStatus(id); st.Compat != "backup_too_old" || st.Protocol.BlueGit != FutureProtocol {
132 t.Fatalf("BlueGit: %+v", st)
133 }
134 requireBanner(t, g, g.Session(), "offsite", "The backup server is out of date", "Update the backup server")
135
136 // Een gebruiker die geen beheerder is, ziet de banner niet.
137 g.RestartAs("bob", 2)
138 bob := g.Session()
139 for _, p := range []string{"/", "/users/bob", "/-/info", "/help"} {
140 if html := g.Page(bob, p); strings.Contains(html, "compat-banner") || strings.Contains(html, "offsite") {
141 t.Fatalf("%s: niet-beheerder ziet de banner", p)
142 }
143 }
144 if html := g.Page(bob, "/"); !strings.Contains(html, "bob") {
145 t.Fatalf("niet als bob aangemeld:\n%s", tail(html, 20))
146 }
147 }
@@ -0,0 +1,147 @@
1//go:build integration
2
3package integration
4
5import (
6 "net/http"
7 "strings"
8 "testing"
9 "time"
10
11 "git.timfalken.com/timfa/bluegit-backup/internal/protocol"
12 "git.timfalken.com/timfa/bluegit-backup/internal/server"
13)
14
15// setBackupProtocol bootst een andere versie van de backup server na (die
16// draait in dit testproces). Terugzetten gebeurt aan het eind van de test.
17func setBackupProtocol(t *testing.T, proto, min string) (restore func()) {
18 oldP, oldM := protocol.ProtocolVersion, protocol.MinBlueGitProtocol
19 protocol.ProtocolVersion, protocol.MinBlueGitProtocol = proto, min
20 restore = func() { protocol.ProtocolVersion, protocol.MinBlueGitProtocol = oldP, oldM }
21 t.Cleanup(restore)
22 return restore
23}
24
25// bannerPages zijn pagina's van verschillende soorten; de banner hoort op elk.
26var bannerPages = []string{"/", "/users/tim", "/tim/alpha", "/admin", "/admin/backup", "/-/info", "/help"}
27
28func requireBanner(t *testing.T, g *BlueGit, hc *http.Client, name string, want ...string) {
29 t.Helper()
30 for _, p := range bannerPages {
31 html := g.Page(hc, p)
32 if !strings.Contains(html, `class="compat-banner"`) || !strings.Contains(html, name) || !strings.Contains(html, `href="/admin/backup"`) {
33 t.Fatalf("%s: geen banner voor %q:\n%s", p, name, tail(html, 30))
34 }
35 for _, w := range want {
36 if !strings.Contains(html, w) {
37 t.Fatalf("%s: banner mist %q", p, w)
38 }
39 }
40 }
41}
42
43// Feature: een backup server die een nieuwer protocol vraagt dan BlueGit
44// spreekt ("BlueGit te oud"). De backup server weigert te synchroniseren en
45// terug te zetten en meldt het in zijn UI en API; BlueGit toont beheerders op
46// elke pagina een banner. Na de update (hier: terug naar protocol 1) is
47// alles weer normaal.
48func TestCompatBlueGitTooOld(t *testing.T) {
49 g := startBlueGit(t)
50 g.Project("Alpha", "README.md", "v1")
51 b := startBackup(t, nil)
52 id, key := g.AddServer("nas")
53 b.Connect(g, key)
54 b.Sync()
55 arch := b.Archive()
56 if st := g.ServerStatus(id); st.Compat != "ok" || st.Protocol.Backup != 1 || st.Protocol.BlueGit != 1 {
57 t.Fatalf("begin: %+v", st)
58 }
59
60 // De backup server wordt "geüpdatet" naar protocol 2 en vraagt BlueGit ≥ 2.
61 restore := setBackupProtocol(t, "2", "2")
62 code, raw := b.Admin("POST", "/sync", nil)
63 if code != http.StatusConflict || !strings.Contains(string(raw), "BlueGit is verouderd") {
64 t.Fatalf("sync bij te oude BlueGit: %d %s", code, raw)
65 }
66 st := b.Status()
67 if st.Compat != "bluegit_too_old" || st.BlueGitProtocol != 1 || !strings.Contains(st.CompatMessage, "Update BlueGit") {
68 t.Fatalf("status: %+v", st)
69 }
70 if html := openUI(t, b).Page(); !strings.Contains(html, `class="compat-banner"`) || !strings.Contains(html, "Update BlueGit") {
71 t.Fatalf("backup-UI zonder waarschuwing:\n%s", tail(html, 40))
72 }
73 // BlueGit hoort het protocol in het antwoord van de backup server.
74 if st := g.ServerStatus(id); st.Compat != "bluegit_too_old" || st.Protocol.Backup != 2 || st.Protocol.BackupMin != 2 {
75 t.Fatalf("BlueGit: %+v", st)
76 }
77 // Terugzetten weigert de backup server; BlueGit blijft ongemoeid.
78 g.Commit("alpha", "na.txt", "x", "create")
79 if code, raw := g.Action(id, "rollback", map[string]any{"archive": arch, "confirm": arch}); code < 400 || !strings.Contains(string(raw), "verouderd") {
80 t.Fatalf("rollback bij te oude BlueGit: %d %s", code, raw)
81 }
82 if code, _ := g.File("alpha", "na.txt"); code != 200 {
83 t.Fatal("BlueGit is toch teruggezet")
84 }
85 requireBanner(t, g, g.Session(), "nas", "BlueGit is out of date", "Update BlueGit")
86
87 // "BlueGit geüpdatet" (hier: de backup server weer op protocol 1).
88 restore()
89 b.Sync()
90 if st := b.Status(); st.Compat != "ok" || st.CompatMessage != "" {
91 t.Fatalf("na update: %+v", st)
92 }
93 Eventually(t, 10*time.Second, "BlueGit ziet weer protocol 1", func() bool { return g.ServerStatus(id).Compat == "ok" })
94 if strings.Contains(g.Page(g.Session(), "/"), "compat-banner") {
95 t.Fatal("banner blijft na de update")
96 }
97}
98
99// Feature: BlueGit vraagt een nieuwer protocol dan de backup server spreekt
100// ("backup te oud"). Nagebootst met een test-build van BlueGit met protocol
101// 99 (-ldflags -X, scripts/build-bluegit.sh). Koppelen lukt, zodat het
102// zichtbaar wordt; BlueGit weigert gegevens (426), de backup server weigert
103// te synchroniseren, beheerders zien de banner en andere gebruikers niet.
104func TestCompatBackupTooOld(t *testing.T) {
105 g := startBlueGitBin(t, bluegitFutureBin(t))
106 g.Project("Alpha", "README.md", "v1")
107 b := startBackup(t, nil)
108 id, key := g.AddServer("offsite")
109 code, raw := b.Admin("POST", "/connect", server.ConnectRequest{URL: g.URL, Key: key})
110 if code != 200 || !strings.Contains(string(raw), "backup_too_old") || !strings.Contains(string(raw), "Update de backup server") {
111 t.Fatalf("koppelen: %d %s", code, raw)
112 }
113 code, raw = b.Admin("POST", "/sync", nil)
114 if code != http.StatusConflict || !strings.Contains(string(raw), "deze backup server is verouderd") {
115 t.Fatalf("sync: %d %s", code, raw)
116 }
117 if st := b.Status(); st.Compat != "backup_too_old" || st.BlueGitProtocol != FutureProtocol || st.BlueGitMinProtocol != FutureProtocol {
118 t.Fatalf("status: %+v", st)
119 }
120 // Een oude backup server zonder protocolkoppen krijgt van BlueGit 426.
121 req, _ := http.NewRequest("GET", g.URL+"/api/v1/backup/manifest", nil)
122 req.Header.Set("Authorization", "Bearer "+key)
123 res, err := http.DefaultClient.Do(req)
124 if err != nil {
125 t.Fatal(err)
126 }
127 res.Body.Close()
128 if res.StatusCode != http.StatusUpgradeRequired {
129 t.Fatalf("manifest zonder koppen: %d", res.StatusCode)
130 }
131 if st := g.ServerStatus(id); st.Compat != "backup_too_old" || st.Protocol.BlueGit != FutureProtocol {
132 t.Fatalf("BlueGit: %+v", st)
133 }
134 requireBanner(t, g, g.Session(), "offsite", "The backup server is out of date", "Update the backup server")
135
136 // Een gebruiker die geen beheerder is, ziet de banner niet.
137 g.RestartAs("bob", 2)
138 bob := g.Session()
139 for _, p := range []string{"/", "/users/bob", "/-/info", "/help"} {
140 if html := g.Page(bob, p); strings.Contains(html, "compat-banner") || strings.Contains(html, "offsite") {
141 t.Fatalf("%s: niet-beheerder ziet de banner", p)
142 }
143 }
144 if html := g.Page(bob, "/"); !strings.Contains(html, "bob") {
145 t.Fatalf("niet als bob aangemeld:\n%s", tail(html, 20))
146 }
147}
internal/backupserver/integration/harness_test.go +76 −1
@@ -88,7 +88,30 @@ func (s *syncBuf) String() string {
88 88
89 89 func startBlueGit(t *testing.T) *BlueGit {
90 90 t.Helper()
91 bin := bluegitBin(t)
91 return startBlueGitBin(t, bluegitBin(t))
92 }
93
94 // bluegitFutureBin is een test-build van dezelfde BlueGit met een hoger
95 // protocol (scripts/build-bluegit.sh bouwt hem naast BLUEGIT_BIN met
96 // -ldflags -X): protocol FutureProtocol, en hij ondersteunt alleen backup
97 // servers vanaf FutureProtocol.
98 func bluegitFutureBin(t *testing.T) string {
99 t.Helper()
100 bin := os.Getenv("BLUEGIT_FUTURE_BIN")
101 if bin == "" {
102 bin = filepath.Join(filepath.Dir(bluegitBin(t)), "bluegit-future")
103 }
104 if _, err := os.Stat(bin); err != nil {
105 t.Fatalf("test-build met hoger protocol ontbreekt (scripts/build-bluegit.sh): %v", err)
106 }
107 return bin
108 }
109
110 // FutureProtocol staat ook in scripts/build-bluegit.sh.
111 const FutureProtocol = 99
112
113 func startBlueGitBin(t *testing.T, bin string) *BlueGit {
114 t.Helper()
92 115 dir := t.TempDir()
93 116 port := freePort(t)
94 117 g := &BlueGit{t: t, Bin: bin, URL: fmt.Sprintf("http://127.0.0.1:%d", port),
@@ -151,6 +174,50 @@ func tail(s string, n int) string {
151 174 return strings.Join(lines, "\n")
152 175 }
153 176
177 // RestartAs herstart dezelfde BlueGit (zelfde gegevens) met een andere
178 // dev-gebruiker. Zo is er een tweede gebruiker die geen beheerder is.
179 func (g *BlueGit) RestartAs(user string, authID int) {
180 g.t.Helper()
181 _ = g.cmd.Process.Kill()
182 _, _ = g.cmd.Process.Wait()
183 b, err := os.ReadFile(g.Config)
184 if err != nil {
185 g.t.Fatal(err)
186 }
187 var out []string
188 for _, l := range strings.Split(string(b), "\n") {
189 switch {
190 case strings.HasPrefix(l, " dev_user:"):
191 l = " dev_user: " + user
192 case strings.HasPrefix(l, " dev_auth_id:"):
193 l = fmt.Sprintf(" dev_auth_id: %d", authID)
194 }
195 out = append(out, l)
196 }
197 if err := os.WriteFile(g.Config, []byte(strings.Join(out, "\n")), 0o600); err != nil {
198 g.t.Fatal(err)
199 }
200 g.cmd = exec.Command(g.Bin, "serve", "--config", g.Config)
201 g.cmd.Stdout, g.cmd.Stderr = g.log, g.log
202 if err := g.cmd.Start(); err != nil {
203 g.t.Fatal(err)
204 }
205 g.WaitUp(20 * time.Second)
206 }
207
208 // Page haalt een HTML-pagina op met een sessie (dev-login van de huidige
209 // dev-gebruiker).
210 func (g *BlueGit) Page(hc *http.Client, p string) string {
211 g.t.Helper()
212 res, err := hc.Get(g.URL + p)
213 if err != nil {
214 g.t.Fatal(err)
215 }
216 defer res.Body.Close()
217 b, _ := io.ReadAll(res.Body)
218 return string(b)
219 }
220
154 221 // WaitUp wacht op /healthz.
155 222 func (g *BlueGit) WaitUp(d time.Duration) {
156 223 g.t.Helper()
@@ -318,6 +385,14 @@ type BackupStatus struct {
318 385 } `json:"fields"`
319 386 } `json:"config"`
320 387 RemoteError string `json:"remote_error"`
388 // Compat: "" (onbekend), ok, bluegit_too_old of backup_too_old.
389 Compat string `json:"compat"`
390 Protocol struct {
391 BlueGit int `json:"bluegit"`
392 BlueGitMin int `json:"bluegit_min"`
393 Backup int `json:"backup"`
394 BackupMin int `json:"backup_min"`
395 } `json:"protocol"`
321 396 }
322 397
323 398 // BackupStatus geeft de stand van de laatst toegevoegde backup server.
@@ -88,7 +88,30 @@ func (s *syncBuf) String() string {
88
88
89func startBlueGit(t *testing.T) *BlueGit {
89func startBlueGit(t *testing.T) *BlueGit {
90 t.Helper()
90 t.Helper()
91 bin := bluegitBin(t)
91 return startBlueGitBin(t, bluegitBin(t))
92}
93
94// bluegitFutureBin is een test-build van dezelfde BlueGit met een hoger
95// protocol (scripts/build-bluegit.sh bouwt hem naast BLUEGIT_BIN met
96// -ldflags -X): protocol FutureProtocol, en hij ondersteunt alleen backup
97// servers vanaf FutureProtocol.
98func bluegitFutureBin(t *testing.T) string {
99 t.Helper()
100 bin := os.Getenv("BLUEGIT_FUTURE_BIN")
101 if bin == "" {
102 bin = filepath.Join(filepath.Dir(bluegitBin(t)), "bluegit-future")
103 }
104 if _, err := os.Stat(bin); err != nil {
105 t.Fatalf("test-build met hoger protocol ontbreekt (scripts/build-bluegit.sh): %v", err)
106 }
107 return bin
108}
109
110// FutureProtocol staat ook in scripts/build-bluegit.sh.
111const FutureProtocol = 99
112
113func startBlueGitBin(t *testing.T, bin string) *BlueGit {
114 t.Helper()
92 dir := t.TempDir()
115 dir := t.TempDir()
93 port := freePort(t)
116 port := freePort(t)
94 g := &BlueGit{t: t, Bin: bin, URL: fmt.Sprintf("http://127.0.0.1:%d", port),
117 g := &BlueGit{t: t, Bin: bin, URL: fmt.Sprintf("http://127.0.0.1:%d", port),
@@ -151,6 +174,50 @@ func tail(s string, n int) string {
151 return strings.Join(lines, "\n")
174 return strings.Join(lines, "\n")
152}
175}
153
176
177// RestartAs herstart dezelfde BlueGit (zelfde gegevens) met een andere
178// dev-gebruiker. Zo is er een tweede gebruiker die geen beheerder is.
179func (g *BlueGit) RestartAs(user string, authID int) {
180 g.t.Helper()
181 _ = g.cmd.Process.Kill()
182 _, _ = g.cmd.Process.Wait()
183 b, err := os.ReadFile(g.Config)
184 if err != nil {
185 g.t.Fatal(err)
186 }
187 var out []string
188 for _, l := range strings.Split(string(b), "\n") {
189 switch {
190 case strings.HasPrefix(l, " dev_user:"):
191 l = " dev_user: " + user
192 case strings.HasPrefix(l, " dev_auth_id:"):
193 l = fmt.Sprintf(" dev_auth_id: %d", authID)
194 }
195 out = append(out, l)
196 }
197 if err := os.WriteFile(g.Config, []byte(strings.Join(out, "\n")), 0o600); err != nil {
198 g.t.Fatal(err)
199 }
200 g.cmd = exec.Command(g.Bin, "serve", "--config", g.Config)
201 g.cmd.Stdout, g.cmd.Stderr = g.log, g.log
202 if err := g.cmd.Start(); err != nil {
203 g.t.Fatal(err)
204 }
205 g.WaitUp(20 * time.Second)
206}
207
208// Page haalt een HTML-pagina op met een sessie (dev-login van de huidige
209// dev-gebruiker).
210func (g *BlueGit) Page(hc *http.Client, p string) string {
211 g.t.Helper()
212 res, err := hc.Get(g.URL + p)
213 if err != nil {
214 g.t.Fatal(err)
215 }
216 defer res.Body.Close()
217 b, _ := io.ReadAll(res.Body)
218 return string(b)
219}
220
154// WaitUp wacht op /healthz.
221// WaitUp wacht op /healthz.
155func (g *BlueGit) WaitUp(d time.Duration) {
222func (g *BlueGit) WaitUp(d time.Duration) {
156 g.t.Helper()
223 g.t.Helper()
@@ -318,6 +385,14 @@ type BackupStatus struct {
318 } `json:"fields"`
385 } `json:"fields"`
319 } `json:"config"`
386 } `json:"config"`
320 RemoteError string `json:"remote_error"`
387 RemoteError string `json:"remote_error"`
388 // Compat: "" (onbekend), ok, bluegit_too_old of backup_too_old.
389 Compat string `json:"compat"`
390 Protocol struct {
391 BlueGit int `json:"bluegit"`
392 BlueGitMin int `json:"bluegit_min"`
393 Backup int `json:"backup"`
394 BackupMin int `json:"backup_min"`
395 } `json:"protocol"`
321}
396}
322
397
323// BackupStatus geeft de stand van de laatst toegevoegde backup server.
398// BackupStatus geeft de stand van de laatst toegevoegde backup server.
internal/backupserver/mirror/remote.go +8 −0
@@ -26,6 +26,10 @@ type Remote struct {
26 26 Key string
27 27 HTTP *http.Client
28 28 Limiter *throttle.Limiter
29 // Version gaat mee in de X-Backup-koppen.
30 Version string
31 // OnPeer krijgt het protocol van BlueGit uit elk antwoord dat het meldt.
32 OnPeer func(protocol.Peer)
29 33 }
30 34
31 35 func (r *Remote) client() *http.Client {
@@ -42,10 +46,14 @@ func (r *Remote) req(ctx context.Context, method, p string, body io.Reader) (*ht
42 46 }
43 47 req.Header.Set("Authorization", "Bearer "+r.Key)
44 48 req.Header.Set("User-Agent", "bluegit-backup")
49 protocol.SetOwnHeaders(req.Header, r.Version)
45 50 resp, err := r.client().Do(req)
46 51 if err != nil {
47 52 return nil, err
48 53 }
54 if p, ok := protocol.BlueGitFromHeader(resp.Header); ok && r.OnPeer != nil {
55 r.OnPeer(p)
56 }
49 57 if resp.StatusCode >= 300 {
50 58 defer resp.Body.Close()
51 59 raw, _ := io.ReadAll(io.LimitReader(resp.Body, 1<<16))
@@ -26,6 +26,10 @@ type Remote struct {
26 Key string
26 Key string
27 HTTP *http.Client
27 HTTP *http.Client
28 Limiter *throttle.Limiter
28 Limiter *throttle.Limiter
29 // Version gaat mee in de X-Backup-koppen.
30 Version string
31 // OnPeer krijgt het protocol van BlueGit uit elk antwoord dat het meldt.
32 OnPeer func(protocol.Peer)
29}
33}
30
34
31func (r *Remote) client() *http.Client {
35func (r *Remote) client() *http.Client {
@@ -42,10 +46,14 @@ func (r *Remote) req(ctx context.Context, method, p string, body io.Reader) (*ht
42 }
46 }
43 req.Header.Set("Authorization", "Bearer "+r.Key)
47 req.Header.Set("Authorization", "Bearer "+r.Key)
44 req.Header.Set("User-Agent", "bluegit-backup")
48 req.Header.Set("User-Agent", "bluegit-backup")
49 protocol.SetOwnHeaders(req.Header, r.Version)
45 resp, err := r.client().Do(req)
50 resp, err := r.client().Do(req)
46 if err != nil {
51 if err != nil {
47 return nil, err
52 return nil, err
48 }
53 }
54 if p, ok := protocol.BlueGitFromHeader(resp.Header); ok && r.OnPeer != nil {
55 r.OnPeer(p)
56 }
49 if resp.StatusCode >= 300 {
57 if resp.StatusCode >= 300 {
50 defer resp.Body.Close()
58 defer resp.Body.Close()
51 raw, _ := io.ReadAll(io.LimitReader(resp.Body, 1<<16))
59 raw, _ := io.ReadAll(io.LimitReader(resp.Body, 1<<16))
internal/backupserver/protocol/compat.go added +121 −0
@@ -0,0 +1,121 @@
1 package protocol
2
3 import (
4 "net/http"
5 "strconv"
6 "strings"
7 )
8
9 // Compatibiliteit tussen BlueGit en bluegit-backup (gelijk aan
10 // internal/backup/compat.go in BlueGit).
11 //
12 // Elke kant heeft een protocolversie (wat hij zelf spreekt) en een
13 // minimumversie (de oudste versie van de andere kant die hij nog
14 // ondersteunt). Ze passen als elk de minimumversie van de ander haalt. Een
15 // kant die geen protocol meldt, spreekt protocol 1 (BlueGit vóór de
16 // protocolversie en bluegit-backup v0.1.0).
17 //
18 // Strings, zodat een test-build ze met -ldflags -X kan overschrijven; de
19 // integratietests zetten ze direct (de backup server draait in het
20 // testproces).
21 var (
22 ProtocolVersion = "1"
23 MinBlueGitProtocol = "1"
24 )
25
26 // Koppen met de protocolversie.
27 const (
28 HeaderBlueGitProtocol = "X-BlueGit-Protocol"
29 HeaderBlueGitMinProtocol = "X-BlueGit-Min-Protocol"
30 HeaderBlueGitVersion = "X-BlueGit-Version"
31 HeaderBackupProtocol = "X-Backup-Protocol"
32 HeaderBackupMinProtocol = "X-Backup-Min-Protocol"
33 HeaderBackupVersion = "X-Backup-Version"
34 )
35
36 // Uitkomsten van Compat.
37 const (
38 CompatOK = "ok"
39 CompatBlueGitTooOld = "bluegit_too_old"
40 CompatBackupTooOld = "backup_too_old"
41 )
42
43 func atoiMin1(s string) int {
44 n, err := strconv.Atoi(strings.TrimSpace(s))
45 if err != nil || n < 1 {
46 return 1
47 }
48 return n
49 }
50
51 // Protocol is de protocolversie van deze backup server.
52 func Protocol() int { return atoiMin1(ProtocolVersion) }
53
54 // MinProtocol is de oudste protocolversie van BlueGit die deze backup
55 // server ondersteunt.
56 func MinProtocol() int {
57 if m := atoiMin1(MinBlueGitProtocol); m <= Protocol() {
58 return m
59 }
60 return Protocol()
61 }
62
63 // Compat vergelijkt BlueGit (protocol, minimum voor de backup server) met
64 // een backup server (protocol, minimum voor BlueGit).
65 func Compat(bluegit, bluegitMin, backup, backupMin int) string {
66 switch {
67 case backup < bluegitMin:
68 return CompatBackupTooOld
69 case bluegit < backupMin:
70 return CompatBlueGitTooOld
71 }
72 return CompatOK
73 }
74
75 // Peer is wat BlueGit over zijn protocol zegt.
76 type Peer struct {
77 Protocol int `json:"protocol"`
78 MinProtocol int `json:"min_protocol"`
79 Version string `json:"version,omitempty"`
80 }
81
82 // Compat beoordeelt deze backup server tegen BlueGit p.
83 func (p Peer) Compat() string {
84 return Compat(atoiMin1(strconv.Itoa(p.Protocol)), atoiMin1(strconv.Itoa(p.MinProtocol)), Protocol(), MinProtocol())
85 }
86
87 // BlueGitFromHeader leest de X-BlueGit-koppen. ok is false zonder
88 // protocolkop; p is dan protocol 1.
89 func BlueGitFromHeader(h http.Header) (Peer, bool) {
90 p := Peer{Protocol: 1, MinProtocol: 1}
91 raw := h.Get(HeaderBlueGitProtocol)
92 if raw == "" {
93 return p, false
94 }
95 p.Protocol = atoiMin1(raw)
96 if m := h.Get(HeaderBlueGitMinProtocol); m != "" {
97 p.MinProtocol = atoiMin1(m)
98 }
99 p.Version = cleanVersion(h.Get(HeaderBlueGitVersion))
100 return p, true
101 }
102
103 func cleanVersion(v string) string {
104 out := make([]rune, 0, len(v))
105 for _, r := range strings.TrimSpace(v) {
106 if r > ' ' && r < 0x7f && r != '<' && r != '>' && r != '"' {
107 out = append(out, r)
108 }
109 if len(out) == 40 {
110 break
111 }
112 }
113 return string(out)
114 }
115
116 // SetOwnHeaders zet de X-Backup-koppen.
117 func SetOwnHeaders(h http.Header, version string) {
118 h.Set(HeaderBackupProtocol, strconv.Itoa(Protocol()))
119 h.Set(HeaderBackupMinProtocol, strconv.Itoa(MinProtocol()))
120 h.Set(HeaderBackupVersion, version)
121 }
@@ -0,0 +1,121 @@
1package protocol
2
3import (
4 "net/http"
5 "strconv"
6 "strings"
7)
8
9// Compatibiliteit tussen BlueGit en bluegit-backup (gelijk aan
10// internal/backup/compat.go in BlueGit).
11//
12// Elke kant heeft een protocolversie (wat hij zelf spreekt) en een
13// minimumversie (de oudste versie van de andere kant die hij nog
14// ondersteunt). Ze passen als elk de minimumversie van de ander haalt. Een
15// kant die geen protocol meldt, spreekt protocol 1 (BlueGit vóór de
16// protocolversie en bluegit-backup v0.1.0).
17//
18// Strings, zodat een test-build ze met -ldflags -X kan overschrijven; de
19// integratietests zetten ze direct (de backup server draait in het
20// testproces).
21var (
22 ProtocolVersion = "1"
23 MinBlueGitProtocol = "1"
24)
25
26// Koppen met de protocolversie.
27const (
28 HeaderBlueGitProtocol = "X-BlueGit-Protocol"
29 HeaderBlueGitMinProtocol = "X-BlueGit-Min-Protocol"
30 HeaderBlueGitVersion = "X-BlueGit-Version"
31 HeaderBackupProtocol = "X-Backup-Protocol"
32 HeaderBackupMinProtocol = "X-Backup-Min-Protocol"
33 HeaderBackupVersion = "X-Backup-Version"
34)
35
36// Uitkomsten van Compat.
37const (
38 CompatOK = "ok"
39 CompatBlueGitTooOld = "bluegit_too_old"
40 CompatBackupTooOld = "backup_too_old"
41)
42
43func atoiMin1(s string) int {
44 n, err := strconv.Atoi(strings.TrimSpace(s))
45 if err != nil || n < 1 {
46 return 1
47 }
48 return n
49}
50
51// Protocol is de protocolversie van deze backup server.
52func Protocol() int { return atoiMin1(ProtocolVersion) }
53
54// MinProtocol is de oudste protocolversie van BlueGit die deze backup
55// server ondersteunt.
56func MinProtocol() int {
57 if m := atoiMin1(MinBlueGitProtocol); m <= Protocol() {
58 return m
59 }
60 return Protocol()
61}
62
63// Compat vergelijkt BlueGit (protocol, minimum voor de backup server) met
64// een backup server (protocol, minimum voor BlueGit).
65func Compat(bluegit, bluegitMin, backup, backupMin int) string {
66 switch {
67 case backup < bluegitMin:
68 return CompatBackupTooOld
69 case bluegit < backupMin:
70 return CompatBlueGitTooOld
71 }
72 return CompatOK
73}
74
75// Peer is wat BlueGit over zijn protocol zegt.
76type Peer struct {
77 Protocol int `json:"protocol"`
78 MinProtocol int `json:"min_protocol"`
79 Version string `json:"version,omitempty"`
80}
81
82// Compat beoordeelt deze backup server tegen BlueGit p.
83func (p Peer) Compat() string {
84 return Compat(atoiMin1(strconv.Itoa(p.Protocol)), atoiMin1(strconv.Itoa(p.MinProtocol)), Protocol(), MinProtocol())
85}
86
87// BlueGitFromHeader leest de X-BlueGit-koppen. ok is false zonder
88// protocolkop; p is dan protocol 1.
89func BlueGitFromHeader(h http.Header) (Peer, bool) {
90 p := Peer{Protocol: 1, MinProtocol: 1}
91 raw := h.Get(HeaderBlueGitProtocol)
92 if raw == "" {
93 return p, false
94 }
95 p.Protocol = atoiMin1(raw)
96 if m := h.Get(HeaderBlueGitMinProtocol); m != "" {
97 p.MinProtocol = atoiMin1(m)
98 }
99 p.Version = cleanVersion(h.Get(HeaderBlueGitVersion))
100 return p, true
101}
102
103func cleanVersion(v string) string {
104 out := make([]rune, 0, len(v))
105 for _, r := range strings.TrimSpace(v) {
106 if r > ' ' && r < 0x7f && r != '<' && r != '>' && r != '"' {
107 out = append(out, r)
108 }
109 if len(out) == 40 {
110 break
111 }
112 }
113 return string(out)
114}
115
116// SetOwnHeaders zet de X-Backup-koppen.
117func SetOwnHeaders(h http.Header, version string) {
118 h.Set(HeaderBackupProtocol, strconv.Itoa(Protocol()))
119 h.Set(HeaderBackupMinProtocol, strconv.Itoa(MinProtocol()))
120 h.Set(HeaderBackupVersion, version)
121}
internal/backupserver/protocol/compat_test.go added +41 −0
@@ -0,0 +1,41 @@
1 package protocol
2
3 import (
4 "net/http"
5 "testing"
6 )
7
8 func TestCompat(t *testing.T) {
9 cases := []struct {
10 bg, bgMin, bk, bkMin int
11 want string
12 }{
13 {1, 1, 1, 1, CompatOK},
14 {2, 1, 1, 1, CompatOK},
15 {1, 1, 2, 1, CompatOK},
16 {3, 2, 1, 1, CompatBackupTooOld},
17 {1, 1, 3, 2, CompatBlueGitTooOld},
18 }
19 for _, c := range cases {
20 if got := Compat(c.bg, c.bgMin, c.bk, c.bkMin); got != c.want {
21 t.Errorf("Compat(%d,%d,%d,%d) = %s, wil %s", c.bg, c.bgMin, c.bk, c.bkMin, got, c.want)
22 }
23 }
24 }
25
26 func TestBlueGitFromHeader(t *testing.T) {
27 if p, ok := BlueGitFromHeader(http.Header{}); ok || p.Protocol != 1 || p.MinProtocol != 1 {
28 t.Fatalf("zonder koppen: %+v", p)
29 }
30 h := http.Header{}
31 h.Set(HeaderBlueGitProtocol, "4")
32 h.Set(HeaderBlueGitMinProtocol, "3")
33 h.Set(HeaderBlueGitVersion, "abc<def")
34 p, ok := BlueGitFromHeader(h)
35 if !ok || p.Protocol != 4 || p.MinProtocol != 3 || p.Version != "abcdef" {
36 t.Fatalf("%+v", p)
37 }
38 if p.Compat() != CompatBackupTooOld {
39 t.Fatalf("BlueGit 4 vraagt 3, wij spreken 1: %s", p.Compat())
40 }
41 }
@@ -0,0 +1,41 @@
1package protocol
2
3import (
4 "net/http"
5 "testing"
6)
7
8func TestCompat(t *testing.T) {
9 cases := []struct {
10 bg, bgMin, bk, bkMin int
11 want string
12 }{
13 {1, 1, 1, 1, CompatOK},
14 {2, 1, 1, 1, CompatOK},
15 {1, 1, 2, 1, CompatOK},
16 {3, 2, 1, 1, CompatBackupTooOld},
17 {1, 1, 3, 2, CompatBlueGitTooOld},
18 }
19 for _, c := range cases {
20 if got := Compat(c.bg, c.bgMin, c.bk, c.bkMin); got != c.want {
21 t.Errorf("Compat(%d,%d,%d,%d) = %s, wil %s", c.bg, c.bgMin, c.bk, c.bkMin, got, c.want)
22 }
23 }
24}
25
26func TestBlueGitFromHeader(t *testing.T) {
27 if p, ok := BlueGitFromHeader(http.Header{}); ok || p.Protocol != 1 || p.MinProtocol != 1 {
28 t.Fatalf("zonder koppen: %+v", p)
29 }
30 h := http.Header{}
31 h.Set(HeaderBlueGitProtocol, "4")
32 h.Set(HeaderBlueGitMinProtocol, "3")
33 h.Set(HeaderBlueGitVersion, "abc<def")
34 p, ok := BlueGitFromHeader(h)
35 if !ok || p.Protocol != 4 || p.MinProtocol != 3 || p.Version != "abcdef" {
36 t.Fatalf("%+v", p)
37 }
38 if p.Compat() != CompatBackupTooOld {
39 t.Fatalf("BlueGit 4 vraagt 3, wij spreken 1: %s", p.Compat())
40 }
41}
internal/backupserver/protocol/protocol.go +17 −0
@@ -53,6 +53,23 @@ type Info struct {
53 53 ServerURL string `json:"server_url"`
54 54 ServerID string `json:"server_id"`
55 55 HasStorage bool `json:"has_storage"`
56 // Protocol en MinProtocol zijn 0 bij een BlueGit van vóór de
57 // protocolversie (dat is protocol 1).
58 Protocol int `json:"protocol"`
59 MinProtocol int `json:"min_protocol"`
60 Version string `json:"version"`
61 }
62
63 // Peer geeft het protocol van BlueGit uit info.
64 func (i Info) Peer() Peer {
65 p := Peer{Protocol: i.Protocol, MinProtocol: i.MinProtocol, Version: cleanVersion(i.Version)}
66 if p.Protocol < 1 {
67 p.Protocol = 1
68 }
69 if p.MinProtocol < 1 {
70 p.MinProtocol = 1
71 }
72 return p
56 73 }
57 74
58 75 // SigningSecret leidt het HMAC-geheim af uit de key.
@@ -53,6 +53,23 @@ type Info struct {
53 ServerURL string `json:"server_url"`
53 ServerURL string `json:"server_url"`
54 ServerID string `json:"server_id"`
54 ServerID string `json:"server_id"`
55 HasStorage bool `json:"has_storage"`
55 HasStorage bool `json:"has_storage"`
56 // Protocol en MinProtocol zijn 0 bij een BlueGit van vóór de
57 // protocolversie (dat is protocol 1).
58 Protocol int `json:"protocol"`
59 MinProtocol int `json:"min_protocol"`
60 Version string `json:"version"`
61}
62
63// Peer geeft het protocol van BlueGit uit info.
64func (i Info) Peer() Peer {
65 p := Peer{Protocol: i.Protocol, MinProtocol: i.MinProtocol, Version: cleanVersion(i.Version)}
66 if p.Protocol < 1 {
67 p.Protocol = 1
68 }
69 if p.MinProtocol < 1 {
70 p.MinProtocol = 1
71 }
72 return p
56}
73}
57
74
58// SigningSecret leidt het HMAC-geheim af uit de key.
75// SigningSecret leidt het HMAC-geheim af uit de key.
internal/backupserver/server/actions.go +10 −0
@@ -243,6 +243,7 @@ func (s *Server) Disconnect() error {
243 243 }
244 244 s.mu.Lock()
245 245 s.state = keep
246 s.bluegitKnown = false
246 247 s.mu.Unlock()
247 248 s.Log.Warn("ontkoppeld", "bluegit", st.BlueGitURL)
248 249 return nil
@@ -267,6 +268,9 @@ func (s *Server) actSync(ctx context.Context, in Input) (int, any) {
267 268 return 202, map[string]string{"state": "started"}
268 269 }
269 270 stats, err := s.SyncNow(ctx)
271 if errors.Is(err, ErrIncompatible) {
272 return http.StatusConflict, errBody(err)
273 }
270 274 if err != nil {
271 275 return 502, errBody(err)
272 276 }
@@ -307,6 +311,9 @@ func (s *Server) startRollback(name string) (int, any) {
307 311 if !s.getState().Connected() {
308 312 return 409, errBody(errors.New("geen BlueGit gekoppeld"))
309 313 }
314 if c, p := s.compat(); c != "" && c != protocol.CompatOK {
315 return 409, errBody(fmt.Errorf("%w: %s", ErrIncompatible, compatMessage(c, p)))
316 }
310 317 s.mu.Lock()
311 318 busy := s.rollback.State == "running"
312 319 if !busy {
@@ -346,6 +353,7 @@ func (s *Server) Handler() http.Handler {
346 353
347 354 func securityHeaders(h http.Handler) http.Handler {
348 355 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
356 protocol.SetOwnHeaders(w.Header(), Version)
349 357 w.Header().Set("X-Content-Type-Options", "nosniff")
350 358 w.Header().Set("Referrer-Policy", "same-origin")
351 359 h.ServeHTTP(w, r)
@@ -405,6 +413,8 @@ func (s *Server) authorize(r *http.Request, a Action, body []byte) (int, string)
405 413 if err := protocol.Verify(r, protocol.SigningSecret(st.Key), body, s.now()); err != nil {
406 414 return 401, err.Error()
407 415 }
416 p, _ := protocol.BlueGitFromHeader(r.Header)
417 s.setBlueGit(p)
408 418 return 0, ""
409 419 }
410 420 if sess, ok := s.session(r); ok {
@@ -243,6 +243,7 @@ func (s *Server) Disconnect() error {
243 }
243 }
244 s.mu.Lock()
244 s.mu.Lock()
245 s.state = keep
245 s.state = keep
246 s.bluegitKnown = false
246 s.mu.Unlock()
247 s.mu.Unlock()
247 s.Log.Warn("ontkoppeld", "bluegit", st.BlueGitURL)
248 s.Log.Warn("ontkoppeld", "bluegit", st.BlueGitURL)
248 return nil
249 return nil
@@ -267,6 +268,9 @@ func (s *Server) actSync(ctx context.Context, in Input) (int, any) {
267 return 202, map[string]string{"state": "started"}
268 return 202, map[string]string{"state": "started"}
268 }
269 }
269 stats, err := s.SyncNow(ctx)
270 stats, err := s.SyncNow(ctx)
271 if errors.Is(err, ErrIncompatible) {
272 return http.StatusConflict, errBody(err)
273 }
270 if err != nil {
274 if err != nil {
271 return 502, errBody(err)
275 return 502, errBody(err)
272 }
276 }
@@ -307,6 +311,9 @@ func (s *Server) startRollback(name string) (int, any) {
307 if !s.getState().Connected() {
311 if !s.getState().Connected() {
308 return 409, errBody(errors.New("geen BlueGit gekoppeld"))
312 return 409, errBody(errors.New("geen BlueGit gekoppeld"))
309 }
313 }
314 if c, p := s.compat(); c != "" && c != protocol.CompatOK {
315 return 409, errBody(fmt.Errorf("%w: %s", ErrIncompatible, compatMessage(c, p)))
316 }
310 s.mu.Lock()
317 s.mu.Lock()
311 busy := s.rollback.State == "running"
318 busy := s.rollback.State == "running"
312 if !busy {
319 if !busy {
@@ -346,6 +353,7 @@ func (s *Server) Handler() http.Handler {
346
353
347func securityHeaders(h http.Handler) http.Handler {
354func securityHeaders(h http.Handler) http.Handler {
348 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
355 return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
356 protocol.SetOwnHeaders(w.Header(), Version)
349 w.Header().Set("X-Content-Type-Options", "nosniff")
357 w.Header().Set("X-Content-Type-Options", "nosniff")
350 w.Header().Set("Referrer-Policy", "same-origin")
358 w.Header().Set("Referrer-Policy", "same-origin")
351 h.ServeHTTP(w, r)
359 h.ServeHTTP(w, r)
@@ -405,6 +413,8 @@ func (s *Server) authorize(r *http.Request, a Action, body []byte) (int, string)
405 if err := protocol.Verify(r, protocol.SigningSecret(st.Key), body, s.now()); err != nil {
413 if err := protocol.Verify(r, protocol.SigningSecret(st.Key), body, s.now()); err != nil {
406 return 401, err.Error()
414 return 401, err.Error()
407 }
415 }
416 p, _ := protocol.BlueGitFromHeader(r.Header)
417 s.setBlueGit(p)
408 return 0, ""
418 return 0, ""
409 }
419 }
410 if sess, ok := s.session(r); ok {
420 if sess, ok := s.session(r); ok {
internal/backupserver/server/server.go +94 −5
@@ -55,6 +55,9 @@ type Server struct {
55 55 lastArchive time.Time
56 56 archiveErr string
57 57 rollback RollbackStatus
58 // bluegit is het protocol dat de gekoppelde BlueGit het laatst meldde.
59 bluegit protocol.Peer
60 bluegitKnown bool
58 61
59 62 kick chan struct{}
60 63
@@ -126,7 +129,57 @@ func (s *Server) AdminToken() string { return s.adminToken }
126 129 func (s *Server) now() time.Time { return s.Now() }
127 130
128 131 func (s *Server) remote(st State) *mirror.Remote {
129 return &mirror.Remote{URL: st.BlueGitURL, Key: st.Key, HTTP: s.HTTP, Limiter: s.limiter}
132 return &mirror.Remote{URL: st.BlueGitURL, Key: st.Key, HTTP: s.HTTP, Limiter: s.limiter, Version: Version, OnPeer: s.setBlueGit}
133 }
134
135 // setBlueGit legt het protocol van BlueGit vast.
136 func (s *Server) setBlueGit(p protocol.Peer) {
137 s.mu.Lock()
138 changed := !s.bluegitKnown || s.bluegit != p
139 s.bluegit, s.bluegitKnown = p, true
140 s.mu.Unlock()
141 if changed && p.Compat() != protocol.CompatOK {
142 s.Log.Warn("niet compatibel met BlueGit", "compat", p.Compat(), "bluegit_protocol", p.Protocol, "bluegit_min", p.MinProtocol,
143 "protocol", protocol.Protocol(), "min", protocol.MinProtocol())
144 }
145 }
146
147 // compat is "" (nog onbekend), ok, bluegit_too_old of backup_too_old.
148 func (s *Server) compat() (string, protocol.Peer) {
149 s.mu.Lock()
150 defer s.mu.Unlock()
151 if !s.bluegitKnown {
152 return "", s.bluegit
153 }
154 return s.bluegit.Compat(), s.bluegit
155 }
156
157 // compatMessage zegt wie er geüpdatet moet worden (leeg als alles past).
158 func compatMessage(c string, p protocol.Peer) string {
159 switch c {
160 case protocol.CompatBlueGitTooOld:
161 return fmt.Sprintf("niet compatibel: BlueGit is verouderd (protocol %d; deze backup server vraagt minstens %d). Update BlueGit; tot dan wordt er niets gesynchroniseerd of teruggezet.", p.Protocol, protocol.MinProtocol())
162 case protocol.CompatBackupTooOld:
163 return fmt.Sprintf("niet compatibel: deze backup server is verouderd (protocol %d; BlueGit vraagt minstens %d). Update de backup server; tot dan wordt er niets gesynchroniseerd of teruggezet.", protocol.Protocol(), p.MinProtocol)
164 }
165 return ""
166 }
167
168 // ErrIncompatible: BlueGit en deze backup server passen niet bij elkaar.
169 var ErrIncompatible = errors.New("niet compatibel")
170
171 // checkCompat vraagt info op bij BlueGit en weigert als de protocollen niet
172 // passen. Aanroepen vóór elke sync, rollback of restore.
173 func (s *Server) checkCompat(ctx context.Context, rem *mirror.Remote) error {
174 info, err := rem.Info(ctx)
175 if err != nil {
176 return err
177 }
178 s.setBlueGit(info.Peer())
179 if c, p := s.compat(); c != protocol.CompatOK {
180 return fmt.Errorf("%w: %s", ErrIncompatible, compatMessage(c, p))
181 }
182 return nil
130 183 }
131 184
132 185 func (s *Server) getState() State {
@@ -198,7 +251,12 @@ func (s *Server) SyncNow(ctx context.Context) (mirror.Stats, error) {
198 251 if !st.Connected() {
199 252 return mirror.Stats{}, errors.New("geen BlueGit gekoppeld")
200 253 }
201 stats, err := s.mirror.Sync(ctx, s.remote(st))
254 rem := s.remote(st)
255 var stats mirror.Stats
256 err := s.checkCompat(ctx, rem)
257 if err == nil {
258 stats, err = s.mirror.Sync(ctx, rem)
259 }
202 260 s.mu.Lock()
203 261 s.lastSync = s.now()
204 262 s.syncs++
@@ -332,6 +390,9 @@ func (s *Server) signed(h http.HandlerFunc) http.HandlerFunc {
332 390 writeErr(w, http.StatusUnauthorized, err.Error())
333 391 return
334 392 }
393 // Zonder koppen is het een BlueGit van vóór de protocolversie.
394 p, _ := protocol.BlueGitFromHeader(r.Header)
395 s.setBlueGit(p)
335 396 r = r.WithContext(context.WithValue(r.Context(), ctxBody{}, body))
336 397 h(w, r)
337 398 }
@@ -382,20 +443,35 @@ type Status struct {
382 443 RetentionDays int `json:"retention_days"`
383 444 RateLimitKiB int64 `json:"rate_limit_kib"`
384 445 Rollback RollbackStatus `json:"rollback"`
446 // Protocol van deze server en van BlueGit; Compat is "" (nog
447 // onbekend), ok, bluegit_too_old of backup_too_old.
448 Protocol int `json:"protocol"`
449 MinProtocol int `json:"min_protocol"`
450 BlueGitProtocol int `json:"bluegit_protocol,omitempty"`
451 BlueGitMinProtocol int `json:"bluegit_min_protocol,omitempty"`
452 BlueGitVersion string `json:"bluegit_version,omitempty"`
453 Compat string `json:"compat"`
454 CompatMessage string `json:"compat_message,omitempty"`
385 455 }
386 456
387 457 // Status geeft de huidige stand.
388 458 func (s *Server) Status() Status {
389 459 list, _ := s.archives.List()
460 compat, peer := s.compat()
390 461 s.mu.Lock()
391 462 defer s.mu.Unlock()
392 return Status{
463 st := Status{
393 464 Version: Version, ServerID: s.serverID, BlueGitURL: s.state.BlueGitURL, InstanceID: s.state.InstanceID,
394 465 Connected: s.state.Connected(), LastSync: s.lastSync, SyncError: s.lastSyncErr, LastStats: s.lastStats,
395 466 Syncs: s.syncs, Notifies: s.notifies, MirrorBytes: s.mirror.Size(), Archives: len(list),
396 467 LastArchive: s.lastArchive, ArchiveError: s.archiveErr, Interval: s.Cfg.ArchiveInterval.String(),
397 468 RetentionDays: s.Cfg.RetentionDays, RateLimitKiB: s.Cfg.RateLimitKiB, Rollback: s.rollback,
469 Protocol: protocol.Protocol(), MinProtocol: protocol.MinProtocol(), Compat: compat, CompatMessage: compatMessage(compat, peer),
398 470 }
471 if s.bluegitKnown {
472 st.BlueGitProtocol, st.BlueGitMinProtocol, st.BlueGitVersion = peer.Protocol, peer.MinProtocol, peer.Version
473 }
474 return st
399 475 }
400 476
401 477 func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }
@@ -445,11 +521,15 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
445 521 }
446 522 s.work.Lock()
447 523 defer s.work.Unlock()
448 rem := &mirror.Remote{URL: in.URL, Key: in.Key, HTTP: s.HTTP, Limiter: s.limiter}
524 rem := &mirror.Remote{URL: in.URL, Key: in.Key, HTTP: s.HTTP, Limiter: s.limiter, Version: Version, OnPeer: s.setBlueGit}
449 525 info, err := rem.Info(ctx)
450 526 if err != nil {
451 527 return nil, nil, err
452 528 }
529 // Ook bij een niet-passende BlueGit koppelen we, zodat BlueGit het zijn
530 // beheerders kan laten zien; synchroniseren en terugzetten gebeurt dan niet.
531 s.setBlueGit(info.Peer())
532 compat := info.Peer().Compat()
453 533 old := s.getState()
454 534 list, _ := s.archives.List()
455 535 hasData := !s.mirror.Empty() || len(list) > 0
@@ -477,6 +557,9 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
477 557 s.mu.Unlock()
478 558 s.Log.Warn("oude backups verwijderd voor een nieuwe BlueGit", "old", old.InstanceID, "new", info.InstanceID)
479 559 }
560 if mode == "restore" && compat != protocol.CompatOK {
561 return nil, nil, fmt.Errorf("%w: %s", ErrIncompatible, compatMessage(compat, info.Peer()))
562 }
480 563 if mode == "restore" && s.mirror.Empty() {
481 564 return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)
482 565 }
@@ -491,7 +574,10 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
491 574 s.state = st
492 575 s.mu.Unlock()
493 576 s.Log.Info("gekoppeld", "bluegit", in.URL, "instance", info.InstanceID, "mode", mode)
494 out := map[string]any{"instance_id": info.InstanceID, "bluegit_url": in.URL, "mode": mode}
577 out := map[string]any{"instance_id": info.InstanceID, "bluegit_url": in.URL, "mode": mode, "compat": compat}
578 if msg := compatMessage(compat, info.Peer()); msg != "" {
579 out["warning"] = msg
580 }
495 581 if mode == "restore" {
496 582 if err := s.sendMirror(ctx, rem, "restore"); err != nil {
497 583 return nil, nil, fmt.Errorf("terugzetten naar de nieuwe BlueGit mislukt: %w", err)
@@ -555,6 +641,9 @@ func (s *Server) Rollback(ctx context.Context, name string) error {
555 641 if !st.Connected() {
556 642 return fail(errors.New("geen BlueGit gekoppeld"))
557 643 }
644 if err := s.checkCompat(ctx, s.remote(st)); err != nil {
645 return fail(err)
646 }
558 647 src, err := s.archives.Path(name)
559 648 if err != nil {
560 649 return fail(err)
@@ -55,6 +55,9 @@ type Server struct {
55 lastArchive time.Time
55 lastArchive time.Time
56 archiveErr string
56 archiveErr string
57 rollback RollbackStatus
57 rollback RollbackStatus
58 // bluegit is het protocol dat de gekoppelde BlueGit het laatst meldde.
59 bluegit protocol.Peer
60 bluegitKnown bool
58
61
59 kick chan struct{}
62 kick chan struct{}
60
63
@@ -126,7 +129,57 @@ func (s *Server) AdminToken() string { return s.adminToken }
126func (s *Server) now() time.Time { return s.Now() }
129func (s *Server) now() time.Time { return s.Now() }
127
130
128func (s *Server) remote(st State) *mirror.Remote {
131func (s *Server) remote(st State) *mirror.Remote {
129 return &mirror.Remote{URL: st.BlueGitURL, Key: st.Key, HTTP: s.HTTP, Limiter: s.limiter}
132 return &mirror.Remote{URL: st.BlueGitURL, Key: st.Key, HTTP: s.HTTP, Limiter: s.limiter, Version: Version, OnPeer: s.setBlueGit}
133}
134
135// setBlueGit legt het protocol van BlueGit vast.
136func (s *Server) setBlueGit(p protocol.Peer) {
137 s.mu.Lock()
138 changed := !s.bluegitKnown || s.bluegit != p
139 s.bluegit, s.bluegitKnown = p, true
140 s.mu.Unlock()
141 if changed && p.Compat() != protocol.CompatOK {
142 s.Log.Warn("niet compatibel met BlueGit", "compat", p.Compat(), "bluegit_protocol", p.Protocol, "bluegit_min", p.MinProtocol,
143 "protocol", protocol.Protocol(), "min", protocol.MinProtocol())
144 }
145}
146
147// compat is "" (nog onbekend), ok, bluegit_too_old of backup_too_old.
148func (s *Server) compat() (string, protocol.Peer) {
149 s.mu.Lock()
150 defer s.mu.Unlock()
151 if !s.bluegitKnown {
152 return "", s.bluegit
153 }
154 return s.bluegit.Compat(), s.bluegit
155}
156
157// compatMessage zegt wie er geüpdatet moet worden (leeg als alles past).
158func compatMessage(c string, p protocol.Peer) string {
159 switch c {
160 case protocol.CompatBlueGitTooOld:
161 return fmt.Sprintf("niet compatibel: BlueGit is verouderd (protocol %d; deze backup server vraagt minstens %d). Update BlueGit; tot dan wordt er niets gesynchroniseerd of teruggezet.", p.Protocol, protocol.MinProtocol())
162 case protocol.CompatBackupTooOld:
163 return fmt.Sprintf("niet compatibel: deze backup server is verouderd (protocol %d; BlueGit vraagt minstens %d). Update de backup server; tot dan wordt er niets gesynchroniseerd of teruggezet.", protocol.Protocol(), p.MinProtocol)
164 }
165 return ""
166}
167
168// ErrIncompatible: BlueGit en deze backup server passen niet bij elkaar.
169var ErrIncompatible = errors.New("niet compatibel")
170
171// checkCompat vraagt info op bij BlueGit en weigert als de protocollen niet
172// passen. Aanroepen vóór elke sync, rollback of restore.
173func (s *Server) checkCompat(ctx context.Context, rem *mirror.Remote) error {
174 info, err := rem.Info(ctx)
175 if err != nil {
176 return err
177 }
178 s.setBlueGit(info.Peer())
179 if c, p := s.compat(); c != protocol.CompatOK {
180 return fmt.Errorf("%w: %s", ErrIncompatible, compatMessage(c, p))
181 }
182 return nil
130}
183}
131
184
132func (s *Server) getState() State {
185func (s *Server) getState() State {
@@ -198,7 +251,12 @@ func (s *Server) SyncNow(ctx context.Context) (mirror.Stats, error) {
198 if !st.Connected() {
251 if !st.Connected() {
199 return mirror.Stats{}, errors.New("geen BlueGit gekoppeld")
252 return mirror.Stats{}, errors.New("geen BlueGit gekoppeld")
200 }
253 }
201 stats, err := s.mirror.Sync(ctx, s.remote(st))
254 rem := s.remote(st)
255 var stats mirror.Stats
256 err := s.checkCompat(ctx, rem)
257 if err == nil {
258 stats, err = s.mirror.Sync(ctx, rem)
259 }
202 s.mu.Lock()
260 s.mu.Lock()
203 s.lastSync = s.now()
261 s.lastSync = s.now()
204 s.syncs++
262 s.syncs++
@@ -332,6 +390,9 @@ func (s *Server) signed(h http.HandlerFunc) http.HandlerFunc {
332 writeErr(w, http.StatusUnauthorized, err.Error())
390 writeErr(w, http.StatusUnauthorized, err.Error())
333 return
391 return
334 }
392 }
393 // Zonder koppen is het een BlueGit van vóór de protocolversie.
394 p, _ := protocol.BlueGitFromHeader(r.Header)
395 s.setBlueGit(p)
335 r = r.WithContext(context.WithValue(r.Context(), ctxBody{}, body))
396 r = r.WithContext(context.WithValue(r.Context(), ctxBody{}, body))
336 h(w, r)
397 h(w, r)
337 }
398 }
@@ -382,20 +443,35 @@ type Status struct {
382 RetentionDays int `json:"retention_days"`
443 RetentionDays int `json:"retention_days"`
383 RateLimitKiB int64 `json:"rate_limit_kib"`
444 RateLimitKiB int64 `json:"rate_limit_kib"`
384 Rollback RollbackStatus `json:"rollback"`
445 Rollback RollbackStatus `json:"rollback"`
446 // Protocol van deze server en van BlueGit; Compat is "" (nog
447 // onbekend), ok, bluegit_too_old of backup_too_old.
448 Protocol int `json:"protocol"`
449 MinProtocol int `json:"min_protocol"`
450 BlueGitProtocol int `json:"bluegit_protocol,omitempty"`
451 BlueGitMinProtocol int `json:"bluegit_min_protocol,omitempty"`
452 BlueGitVersion string `json:"bluegit_version,omitempty"`
453 Compat string `json:"compat"`
454 CompatMessage string `json:"compat_message,omitempty"`
385}
455}
386
456
387// Status geeft de huidige stand.
457// Status geeft de huidige stand.
388func (s *Server) Status() Status {
458func (s *Server) Status() Status {
389 list, _ := s.archives.List()
459 list, _ := s.archives.List()
460 compat, peer := s.compat()
390 s.mu.Lock()
461 s.mu.Lock()
391 defer s.mu.Unlock()
462 defer s.mu.Unlock()
392 return Status{
463 st := Status{
393 Version: Version, ServerID: s.serverID, BlueGitURL: s.state.BlueGitURL, InstanceID: s.state.InstanceID,
464 Version: Version, ServerID: s.serverID, BlueGitURL: s.state.BlueGitURL, InstanceID: s.state.InstanceID,
394 Connected: s.state.Connected(), LastSync: s.lastSync, SyncError: s.lastSyncErr, LastStats: s.lastStats,
465 Connected: s.state.Connected(), LastSync: s.lastSync, SyncError: s.lastSyncErr, LastStats: s.lastStats,
395 Syncs: s.syncs, Notifies: s.notifies, MirrorBytes: s.mirror.Size(), Archives: len(list),
466 Syncs: s.syncs, Notifies: s.notifies, MirrorBytes: s.mirror.Size(), Archives: len(list),
396 LastArchive: s.lastArchive, ArchiveError: s.archiveErr, Interval: s.Cfg.ArchiveInterval.String(),
467 LastArchive: s.lastArchive, ArchiveError: s.archiveErr, Interval: s.Cfg.ArchiveInterval.String(),
397 RetentionDays: s.Cfg.RetentionDays, RateLimitKiB: s.Cfg.RateLimitKiB, Rollback: s.rollback,
468 RetentionDays: s.Cfg.RetentionDays, RateLimitKiB: s.Cfg.RateLimitKiB, Rollback: s.rollback,
469 Protocol: protocol.Protocol(), MinProtocol: protocol.MinProtocol(), Compat: compat, CompatMessage: compatMessage(compat, peer),
398 }
470 }
471 if s.bluegitKnown {
472 st.BlueGitProtocol, st.BlueGitMinProtocol, st.BlueGitVersion = peer.Protocol, peer.MinProtocol, peer.Version
473 }
474 return st
399}
475}
400
476
401func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }
477func (s *Server) apiStatus(w http.ResponseWriter, r *http.Request) { writeJSON(w, 200, s.Status()) }
@@ -445,11 +521,15 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
445 }
521 }
446 s.work.Lock()
522 s.work.Lock()
447 defer s.work.Unlock()
523 defer s.work.Unlock()
448 rem := &mirror.Remote{URL: in.URL, Key: in.Key, HTTP: s.HTTP, Limiter: s.limiter}
524 rem := &mirror.Remote{URL: in.URL, Key: in.Key, HTTP: s.HTTP, Limiter: s.limiter, Version: Version, OnPeer: s.setBlueGit}
449 info, err := rem.Info(ctx)
525 info, err := rem.Info(ctx)
450 if err != nil {
526 if err != nil {
451 return nil, nil, err
527 return nil, nil, err
452 }
528 }
529 // Ook bij een niet-passende BlueGit koppelen we, zodat BlueGit het zijn
530 // beheerders kan laten zien; synchroniseren en terugzetten gebeurt dan niet.
531 s.setBlueGit(info.Peer())
532 compat := info.Peer().Compat()
453 old := s.getState()
533 old := s.getState()
454 list, _ := s.archives.List()
534 list, _ := s.archives.List()
455 hasData := !s.mirror.Empty() || len(list) > 0
535 hasData := !s.mirror.Empty() || len(list) > 0
@@ -477,6 +557,9 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
477 s.mu.Unlock()
557 s.mu.Unlock()
478 s.Log.Warn("oude backups verwijderd voor een nieuwe BlueGit", "old", old.InstanceID, "new", info.InstanceID)
558 s.Log.Warn("oude backups verwijderd voor een nieuwe BlueGit", "old", old.InstanceID, "new", info.InstanceID)
479 }
559 }
560 if mode == "restore" && compat != protocol.CompatOK {
561 return nil, nil, fmt.Errorf("%w: %s", ErrIncompatible, compatMessage(compat, info.Peer()))
562 }
480 if mode == "restore" && s.mirror.Empty() {
563 if mode == "restore" && s.mirror.Empty() {
481 return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)
564 return nil, nil, fmt.Errorf("%w: de kopie is leeg; er is niets om terug te zetten", errBadRequest)
482 }
565 }
@@ -491,7 +574,10 @@ func (s *Server) Connect(ctx context.Context, in ConnectRequest) (map[string]any
491 s.state = st
574 s.state = st
492 s.mu.Unlock()
575 s.mu.Unlock()
493 s.Log.Info("gekoppeld", "bluegit", in.URL, "instance", info.InstanceID, "mode", mode)
576 s.Log.Info("gekoppeld", "bluegit", in.URL, "instance", info.InstanceID, "mode", mode)
494 out := map[string]any{"instance_id": info.InstanceID, "bluegit_url": in.URL, "mode": mode}
577 out := map[string]any{"instance_id": info.InstanceID, "bluegit_url": in.URL, "mode": mode, "compat": compat}
578 if msg := compatMessage(compat, info.Peer()); msg != "" {
579 out["warning"] = msg
580 }
495 if mode == "restore" {
581 if mode == "restore" {
496 if err := s.sendMirror(ctx, rem, "restore"); err != nil {
582 if err := s.sendMirror(ctx, rem, "restore"); err != nil {
497 return nil, nil, fmt.Errorf("terugzetten naar de nieuwe BlueGit mislukt: %w", err)
583 return nil, nil, fmt.Errorf("terugzetten naar de nieuwe BlueGit mislukt: %w", err)
@@ -555,6 +641,9 @@ func (s *Server) Rollback(ctx context.Context, name string) error {
555 if !st.Connected() {
641 if !st.Connected() {
556 return fail(errors.New("geen BlueGit gekoppeld"))
642 return fail(errors.New("geen BlueGit gekoppeld"))
557 }
643 }
644 if err := s.checkCompat(ctx, s.remote(st)); err != nil {
645 return fail(err)
646 }
558 src, err := s.archives.Path(name)
647 src, err := s.archives.Path(name)
559 if err != nil {
648 if err != nil {
560 return fail(err)
649 return fail(err)
internal/backupserver/server/web/index.html +2 −0
@@ -4,6 +4,7 @@
4 4 <span class="badge{{if not .Status.Connected}} off{{end}}">{{if .Status.Connected}}gekoppeld{{else}}niet gekoppeld{{end}}</span>
5 5 <form method="post" action="/logout"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Uitloggen</button></form>
6 6 </header>
7 {{if .Status.CompatMessage}}<div class="compat-banner" role="alert" id="compat"><strong>BlueGit en deze backup server passen niet bij elkaar.</strong> {{.Status.CompatMessage}}</div>{{end}}
7 8 <main>
8 9 {{if .Flash}}<div class="flash{{if .FlashErr}} err{{end}}" role="status">{{.Flash}}</div>{{end}}
9 10
@@ -18,6 +19,7 @@
18 19 <dt>Archieven</dt><dd>{{.Status.Archives}}, laatste {{when .Status.LastArchive}}{{if .Status.ArchiveError}} <span class="badge off">{{.Status.ArchiveError}}</span>{{end}}</dd>
19 20 <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 21 <dt>Versie</dt><dd>{{.Status.Version}} <small>server-id {{.Status.ServerID}}</small></dd>
22 <dt>Protocol</dt><dd>{{.Status.Protocol}} <small>(ondersteunt BlueGit ≥ {{.Status.MinProtocol}})</small>{{if .Status.BlueGitProtocol}} · BlueGit {{.Status.BlueGitProtocol}} <small>(ondersteunt backup server ≥ {{.Status.BlueGitMinProtocol}}{{if .Status.BlueGitVersion}}, versie {{.Status.BlueGitVersion}}{{end}})</small>{{end}}{{if eq .Status.Compat "ok"}} <span class="badge">compatibel</span>{{else if .Status.Compat}} <span class="badge off">niet compatibel</span>{{end}}</dd>
21 23 </dl>
22 24 <div class="row" style="margin-top:.8rem">
23 25 <form method="post" action="/ui/act/sync"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu synchroniseren</button></form>
@@ -4,6 +4,7 @@
4<span class="badge{{if not .Status.Connected}} off{{end}}">{{if .Status.Connected}}gekoppeld{{else}}niet gekoppeld{{end}}</span>
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>
5<form method="post" action="/logout"><input type="hidden" name="csrf" value="{{.CSRF}}"><button class="secondary" type="submit">Uitloggen</button></form>
6</header>
6</header>
7{{if .Status.CompatMessage}}<div class="compat-banner" role="alert" id="compat"><strong>BlueGit en deze backup server passen niet bij elkaar.</strong> {{.Status.CompatMessage}}</div>{{end}}
7<main>
8<main>
8{{if .Flash}}<div class="flash{{if .FlashErr}} err{{end}}" role="status">{{.Flash}}</div>{{end}}
9{{if .Flash}}<div class="flash{{if .FlashErr}} err{{end}}" role="status">{{.Flash}}</div>{{end}}
9
10
@@ -18,6 +19,7 @@
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>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>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<dt>Versie</dt><dd>{{.Status.Version}} <small>server-id {{.Status.ServerID}}</small></dd>
22<dt>Protocol</dt><dd>{{.Status.Protocol}} <small>(ondersteunt BlueGit ≥ {{.Status.MinProtocol}})</small>{{if .Status.BlueGitProtocol}} · BlueGit {{.Status.BlueGitProtocol}} <small>(ondersteunt backup server ≥ {{.Status.BlueGitMinProtocol}}{{if .Status.BlueGitVersion}}, versie {{.Status.BlueGitVersion}}{{end}})</small>{{end}}{{if eq .Status.Compat "ok"}} <span class="badge">compatibel</span>{{else if .Status.Compat}} <span class="badge off">niet compatibel</span>{{end}}</dd>
21</dl>
23</dl>
22<div class="row" style="margin-top:.8rem">
24<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>
25<form method="post" action="/ui/act/sync"><input type="hidden" name="csrf" value="{{.CSRF}}"><button type="submit">Nu synchroniseren</button></form>
internal/backupserver/server/web/style.html +1 −0
@@ -17,6 +17,7 @@ table{width:100%;border-collapse:collapse}th,td{text-align:left;padding:.4rem .5
17 17 .flash.err{background:#ffebe9;border-color:var(--danger)}
18 18 .badge{display:inline-block;padding:0 .5rem;border-radius:1rem;font-size:.85rem;background:#ddf4ff}
19 19 .badge.off{background:#ffebe9}
20 .compat-banner{background:#fff4d6;color:#6b4a00;border-bottom:1px solid #e8c766;padding:.7rem 1.2rem}
20 21 .backup-danger{border:2px solid var(--danger);background:#ffebe9;border-radius:8px;padding:.8rem 1rem;margin:.8rem 0}
21 22 .backup-danger strong{color:var(--danger);font-size:1.1rem;display:block}
22 23 details{margin-top:.5rem}code{background:var(--bg);padding:0 .3rem;border-radius:4px}
@@ -17,6 +17,7 @@ table{width:100%;border-collapse:collapse}th,td{text-align:left;padding:.4rem .5
17.flash.err{background:#ffebe9;border-color:var(--danger)}
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}
18.badge{display:inline-block;padding:0 .5rem;border-radius:1rem;font-size:.85rem;background:#ddf4ff}
19.badge.off{background:#ffebe9}
19.badge.off{background:#ffebe9}
20.compat-banner{background:#fff4d6;color:#6b4a00;border-bottom:1px solid #e8c766;padding:.7rem 1.2rem}
20.backup-danger{border:2px solid var(--danger);background:#ffebe9;border-radius:8px;padding:.8rem 1rem;margin:.8rem 0}
21.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.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}
23details{margin-top:.5rem}code{background:var(--bg);padding:0 .3rem;border-radius:4px}