BlueGit

timfa bluegit

Files

bluegit / docs / BACKUP-SERVER.md

BACKUP-SERVER.md

BACKUP-SERVER.md 12.9 KiB Download Raw

bluegit-backup

Een losse backup server voor één BlueGit-instantie.

  • Koppelt met een Backupserver-Key die een BlueGit-beheerder in BlueGit maakt (Beheer → Backup).
  • Haalt alle data en configuratie van BlueGit binnen: database, sleutels, SSH-hostkeys, logo's, avatars, repositories, releases en artifacts. Dat gaat gedoseerd (rate_limit_kib), zodat BlueGit er geen last van heeft.
  • BlueGit meldt elke wijziging. De backup server haalt dan alleen op wat veranderd is. Daarnaast loopt hij elk full_sync_interval alles na.
  • Elk archive_interval (standaard dagelijks) gaat de hele kopie gecomprimeerd in een archief (tar.gz).
  • 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.
  • 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.
  • 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.
  • 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).
  • 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.

Het protocol staat in docs/BACKUP-PROTOCOL.md. De aannames staan in docs/ASSUMPTIONS.md.

Installeren

Arch Linux (AUR)

yay -S bluegit-backup

Het pakket zet de binary in /usr/bin/bluegit-backup, de gegevens in /var/lib/bluegit-backup en een systemd-unit bluegit-backup.service (gebruiker bluegit-backup, start met --data-dir /var/lib/bluegit-backup). Er wordt geen config.yml meer meeleverd: instellingen regel je in de webinterface. Een bestaande /etc/bluegit-backup/config.yml wordt bij de eerste start één keer overgenomen in data_dir/settings.yml.

Binary

Bij een release staan onder andere bluegit-backup-linux-amd64, bluegit-backup-linux-arm64, bluegit-backup-windows-amd64.zip, bluegit-backup-windows-arm64.zip en SHA256SUMS. Zelf bouwen:

go build -o bluegit-backup ./cmd/bluegit-backup
./bluegit-backup serve --data-dir ./backup-data

Open daarna http://127.0.0.1:8080. Het beheertoken toon je met ./bluegit-backup token --data-dir ./backup-data (na de eerste start). example-config print nog het oude YAML-formaat, alleen voor een eenmalige import.

Koppelen

1. Zet in config.yml public_url op het adres waarop BlueGit deze server bereikt. 2. Start de server: systemctl enable --now bluegit-backup. 3. Voeg in BlueGit onder Beheer → Backup een backup server toe. De Backupserver-Key wordt één keer getoond. 4. Koppel in de webinterface (http://<server>:8080, sectie Koppeling), of met de CLI:

   BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com

Had deze server al backups van een andere BlueGit, dan vraagt connect:

   1) oude backups wissen en opnieuw beginnen
   2) de nieuwe BlueGit herstellen met de laatste backupdata

Zonder terminal kies je met --on-conflict wipe of --on-conflict restore.

Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.

Webinterface

Open http://<server>:8080 en log in met het beheertoken uit data_dir/admin.token:

sudo -u bluegit-backup bluegit-backup token

Daar staan:

  • Overzicht: koppeling, laatste sync, kopie, archieven en de laatste rollback, met Nu synchroniseren, Nu archiveren en Nu opruimen.
  • Koppeling: koppelen (met de keuze wissen of herstellen bij een andere BlueGit) en ontkoppelen.
  • Instellingen: elk veld uit de tabel hieronder, in data_dir/settings.yml. listen geldt meteen (als het nieuwe adres niet bindt, blijft het oude in gebruik). data_dir is alleen zichtbaar: die zet je bij het starten (--data-dir of BLUEGIT_BACKUP_DATA_DIR).
  • Voortgang: in het overzicht een balk met het percentage van de BlueGit-dataset dat al in de kopie staat (100% is volledig in sync). Zonder manifest staat er onbekend.
  • Archieven: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
  • API: de lijst met alle acties.

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.

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.

API

Elke actie uit de webinterface is ook een API-aanroep, met Authorization: Bearer <admin.token>:

MethodePadActieBlueGit
GET/api/v1/admin/statusStatus✓
GET/api/v1/admin/actionsAlle acties✓
GET/api/v1/admin/configInstellingen met uitleg✓
PUT/api/v1/admin/configInstellingen wijzigen, bv. {"retention_days": 14}✓
POST/api/v1/admin/connect`{"url", "key", "on_conflict": ""\"wipe"\"restore"}`
POST/api/v1/admin/disconnectOntkoppelen (kopie en archieven blijven)✓
POST/api/v1/admin/syncNu synchroniseren ({"wait": false}: op de achtergrond)✓
POST/api/v1/admin/archiveNu archiveren✓
POST/api/v1/admin/pruneBewaarregels nu toepassen✓
GET/api/v1/admin/archivesArchieven✓
GET/api/v1/admin/archives/{name}/downloadArchief downloaden
DELETE/api/v1/admin/archives/{name}Archief verwijderen✓
POST/api/v1/admin/rollback{"archive", "confirm": archiefnaam}; niet terug te draaien✓

✓ 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.

Compatibiliteit

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 2 en ondersteunt BlueGit vanaf protocol 1. Een BlueGit die geen protocol meldt, spreekt protocol 1. Protocol 2 voegt alleen optionele velden toe (sync-voortgang); een oudere peer blijft compatibel.

Past het niet:

  • 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;
  • 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;
  • weigert BlueGit de gegevens (426).

Updaten doe je zelf (zie Releases); bij het volgende contact is alles weer normaal. Het protocol staat in docs/BACKUP-PROTOCOL.md.

CLI

bluegit-backup status | list | config | actions
bluegit-backup sync | archive | prune | disconnect
bluegit-backup set retention_days=14 archive_interval=12h
bluegit-backup delete bluegit-20261115-030000.tar.gz
bluegit-backup rollback bluegit-20261115-030000.tar.gz   # vraagt om de naam over te typen
bluegit-backup token                                     # beheertoken voor de webinterface

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 …).

Configuratie

SleutelStandaardBetekenis
listen0.0.0.0:8080Adres van de webinterface en API (meteen van kracht)
public_url(leeg)Adres waarop BlueGit deze server bereikt (domein of IP)
data_dir/var/lib/bluegit-backupKopie, archieven, settings.yml en token. Alleen bij het starten (--data-dir / BLUEGIT_BACKUP_DATA_DIR); in de UI alleen-lezen.
archive_interval24hHoe vaak een archief
retention_days30Archieven ouder dan dit weg (0 = nooit)
min_free_mb1024Minder vrij: oudste archief weg
rate_limit_kib1024Downloadsnelheid in KiB/s (0 = onbeperkt)
full_sync_interval1hOok zonder melding alles nalopen
min_sync_interval10sMinimale tijd tussen syncs na meldingen

In data_dir:

  • mirror/ is de lopende kopie.
  • archives/ bevat bluegit-YYYYMMDD-HHMMSS.tar.gz (UTC).
  • state.json (0600) is de koppeling met de key.
  • admin.token (0600) is voor de webinterface, de API en de CLI.
  • settings.yml (0600) bevat wat via de webinterface, API of BlueGit is ingesteld.

Releases

Sinds 16-11-2026 staat bluegit-backup in de BlueGit-repository (timfa/bluegit): cmd/bluegit-backup, internal/backupserver/…, packaging/backup en packaging/aur-backup. De history van de oude repository timfa/bluegit-backup is meegenomen. Zie blue-ci-cd.yml.

  • Het AUR-pakket bluegit-backup wordt vanaf master van timfa/bluegit bijgewerkt (job publish_aur_backup, net als bluegit-runner), uit het bronarchief van timfa/bluegit.
  • Bij een tag v* komt bluegit-backup in dezelfde release als bluegit en bluegit-runner: binaries (amd64, arm64), .deb, .rpm, .pkg.tar.zst en SHA256SUMS.
  • Publicatie en release hangen af van de job backup_integration. Die bouwt BlueGit uit dezelfde checkout, start hem, configureert hem en test daarmee elke feature. Faalt er één test, dan komt er geen release.
  • De oude release v0.1.0 kwam uit timfa/bluegit-backup.

Updaten doe je zelf: met je AUR-helper (bijvoorbeeld yay -Syu bluegit-backup), met een nieuw pakket of met een nieuwe binary van de releasepagina. Er is geen self-update.

Tests

go test ./internal/backupserver/...             # unit-tests
go test -tags integration -v ./internal/backupserver/integration/   # bouwt BlueGit uit deze checkout

Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.

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:

TestFeature
TestKeyGenerationAndConnectKey maken in BlueGit, koppelen, verkeerde key geweigerd
TestFullSyncCopiesAllDataAlle data en configuratie komt binnen, en de kopie klopt
TestNotificationTriggersSyncEen wijziging in BlueGit geeft een melding en daarna een sync
TestDownloadIsThrottledDownloaden blijft onder rate_limit_kib
TestArchiveIntervalAndListInBlueGitArchief per interval, lijst zichtbaar in BlueGit
TestRetentionAndDiskFullWeggooien op leeftijd en bij volle schijf
TestRollbackFromBlueGitRollback vanuit BlueGit (met bevestiging), BlueGit staat daarna terug
TestNewInstanceWipeNieuwe instantie, keuze wissen
TestNewInstanceRestoreNieuwe instantie, keuze herstellen
TestCLIConnectAsksOnConflictconnect vraagt de keuze
TestWebUIConfiguresAndOperatesEverythingWebinterface: inloggen, alle instellingen, koppelen, sync, archief, download, opruimen, rollback, verwijderen, ontkoppelen
TestAPIDoesEverythingTheUICanElke actie via de API; de test faalt als er een actie bij komt zonder test
TestBlueGitControlsBackupServerInstellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface)
TestMultipleBackupServersTwee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene
TestCompatBlueGitTooOldBackup 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
TestCompatBackupTooOldTest-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

De pipeline bouwt BlueGit van de ref in .bluegit-ref, plus een test-build met protocol 99 (.bluegit-bin/bluegit-future) voor TestCompatBackupTooOld.

Licentie

Zie LICENSE.

Source
1# bluegit-backup
2
3Een losse backup server voor één [BlueGit](https://git.timfalken.com/timfa/bluegit)-instantie.
4
5- Koppelt met een **Backupserver-Key** die een BlueGit-beheerder in BlueGit maakt (*Beheer → Backup*).
6- Haalt alle data en configuratie van BlueGit binnen: database, sleutels, SSH-hostkeys, logo's, avatars, repositories, releases en artifacts. Dat gaat **gedoseerd** (`rate_limit_kib`), zodat BlueGit er geen last van heeft.
7- BlueGit **meldt elke wijziging**. De backup server haalt dan alleen op wat veranderd is. Daarnaast loopt hij elk `full_sync_interval` alles na.
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.
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. 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.
14
15Het protocol staat in [docs/BACKUP-PROTOCOL.md](BACKUP-PROTOCOL.md). De aannames staan in [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md).
16
17## Installeren
18
19### Arch Linux (AUR)
20
21```sh
22yay -S bluegit-backup
23```
24
25Het pakket zet de binary in `/usr/bin/bluegit-backup`, de gegevens in `/var/lib/bluegit-backup` en een systemd-unit `bluegit-backup.service` (gebruiker `bluegit-backup`, start met `--data-dir /var/lib/bluegit-backup`). Er wordt geen `config.yml` meer meeleverd: instellingen regel je in de webinterface. Een bestaande `/etc/bluegit-backup/config.yml` wordt bij de eerste start één keer overgenomen in `data_dir/settings.yml`.
26
27### Binary
28
29Bij een release staan onder andere `bluegit-backup-linux-amd64`, `bluegit-backup-linux-arm64`, `bluegit-backup-windows-amd64.zip`, `bluegit-backup-windows-arm64.zip` en `SHA256SUMS`. Zelf bouwen:
30
31```sh
32go build -o bluegit-backup ./cmd/bluegit-backup
33./bluegit-backup serve --data-dir ./backup-data
34```
35
36Open daarna `http://127.0.0.1:8080`. Het beheertoken toon je met `./bluegit-backup token --data-dir ./backup-data` (na de eerste start). `example-config` print nog het oude YAML-formaat, alleen voor een eenmalige import.
37
38## Koppelen
39
401. Zet in `config.yml` `public_url` op het adres waarop BlueGit deze server bereikt.
412. Start de server: `systemctl enable --now bluegit-backup`.
423. Voeg in BlueGit onder *Beheer → Backup* een backup server toe. De Backupserver-Key wordt één keer getoond.
434. Koppel in de webinterface (`http://<server>:8080`, sectie *Koppeling*), of met de CLI:
44
45 ```sh
46 BLUEGIT_BACKUP_KEY=bgbk_… bluegit-backup connect --url https://git.example.com
47 ```
48
49 Had deze server al backups van een andere BlueGit, dan vraagt `connect`:
50
51 ```
52 1) oude backups wissen en opnieuw beginnen
53 2) de nieuwe BlueGit herstellen met de laatste backupdata
54 ```
55
56 Zonder terminal kies je met `--on-conflict wipe` of `--on-conflict restore`.
57
58Daarna haalt de server meteen een volledige kopie op en maakt hij een eerste archief.
59
60## Webinterface
61
62Open `http://<server>:8080` en log in met het beheertoken uit `data_dir/admin.token`:
63
64```sh
65sudo -u bluegit-backup bluegit-backup token
66```
67
68Daar staan:
69
70- **Overzicht**: koppeling, laatste sync, kopie, archieven en de laatste rollback, met *Nu synchroniseren*, *Nu archiveren* en *Nu opruimen*.
71- **Koppeling**: koppelen (met de keuze wissen of herstellen bij een andere BlueGit) en ontkoppelen.
72- **Instellingen**: elk veld uit de tabel hieronder, in `data_dir/settings.yml`. `listen` geldt meteen (als het nieuwe adres niet bindt, blijft het oude in gebruik). `data_dir` is alleen zichtbaar: die zet je bij het starten (`--data-dir` of `BLUEGIT_BACKUP_DATA_DIR`).
73- **Voortgang**: in het overzicht een balk met het percentage van de BlueGit-dataset dat al in de kopie staat (100% is volledig in sync). Zonder manifest staat er *onbekend*.
74- **Archieven**: downloaden, verwijderen en een rollback (met waarschuwing, vinkje en de archiefnaam overtypen).
75- **API**: de lijst met alle acties.
76
77Passen 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).
78
79De 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.
80
81## API
82
83Elke actie uit de webinterface is ook een API-aanroep, met `Authorization: Bearer <admin.token>`:
84
85| Methode | Pad | Actie | BlueGit |
86|---|---|---|---|
87| GET | `/api/v1/admin/status` | Status | ✓ |
88| GET | `/api/v1/admin/actions` | Alle acties | ✓ |
89| GET | `/api/v1/admin/config` | Instellingen met uitleg | ✓ |
90| PUT | `/api/v1/admin/config` | Instellingen wijzigen, bv. `{"retention_days": 14}` | ✓ |
91| POST | `/api/v1/admin/connect` | `{"url", "key", "on_conflict": ""\|"wipe"\|"restore"}` | |
92| POST | `/api/v1/admin/disconnect` | Ontkoppelen (kopie en archieven blijven) | ✓ |
93| POST | `/api/v1/admin/sync` | Nu synchroniseren (`{"wait": false}`: op de achtergrond) | ✓ |
94| POST | `/api/v1/admin/archive` | Nu archiveren | ✓ |
95| POST | `/api/v1/admin/prune` | Bewaarregels nu toepassen | ✓ |
96| GET | `/api/v1/admin/archives` | Archieven | ✓ |
97| GET | `/api/v1/admin/archives/{name}/download` | Archief downloaden | |
98| DELETE | `/api/v1/admin/archives/{name}` | Archief verwijderen | ✓ |
99| POST | `/api/v1/admin/rollback` | `{"archive", "confirm": archiefnaam}`; niet terug te draaien | ✓ |
100
101✓ 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`.
102
103## Compatibiliteit
104
105BlueGit 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 2 en ondersteunt BlueGit vanaf protocol 1. Een BlueGit die geen protocol meldt, spreekt protocol 1. Protocol 2 voegt alleen optionele velden toe (sync-voortgang); een oudere peer blijft compatibel.
106
107Past het niet:
108
109- 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;
110- 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;
111- weigert BlueGit de gegevens (`426`).
112
113Updaten doe je zelf (zie [Releases](#releases)); bij het volgende contact is alles weer normaal. Het protocol staat in [docs/BACKUP-PROTOCOL.md](BACKUP-PROTOCOL.md).
114
115## CLI
116
117```sh
118bluegit-backup status | list | config | actions
119bluegit-backup sync | archive | prune | disconnect
120bluegit-backup set retention_days=14 archive_interval=12h
121bluegit-backup delete bluegit-20261115-030000.tar.gz
122bluegit-backup rollback bluegit-20261115-030000.tar.gz # vraagt om de naam over te typen
123bluegit-backup token # beheertoken voor de webinterface
124```
125
126Deze 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 …`).
127
128## Configuratie
129
130| Sleutel | Standaard | Betekenis |
131|---|---|---|
132| `listen` | `0.0.0.0:8080` | Adres van de webinterface en API (meteen van kracht) |
133| `public_url` | (leeg) | Adres waarop BlueGit deze server bereikt (domein of IP) |
134| `data_dir` | `/var/lib/bluegit-backup` | Kopie, archieven, `settings.yml` en token. Alleen bij het starten (`--data-dir` / `BLUEGIT_BACKUP_DATA_DIR`); in de UI alleen-lezen. |
135| `archive_interval` | `24h` | Hoe vaak een archief |
136| `retention_days` | `30` | Archieven ouder dan dit weg (0 = nooit) |
137| `min_free_mb` | `1024` | Minder vrij: oudste archief weg |
138| `rate_limit_kib` | `1024` | Downloadsnelheid in KiB/s (0 = onbeperkt) |
139| `full_sync_interval` | `1h` | Ook zonder melding alles nalopen |
140| `min_sync_interval` | `10s` | Minimale tijd tussen syncs na meldingen |
141
142In `data_dir`:
143
144- `mirror/` is de lopende kopie.
145- `archives/` bevat `bluegit-YYYYMMDD-HHMMSS.tar.gz` (UTC).
146- `state.json` (0600) is de koppeling met de key.
147- `admin.token` (0600) is voor de webinterface, de API en de CLI.
148- `settings.yml` (0600) bevat wat via de webinterface, API of BlueGit is ingesteld.
149
150## Releases
151
152Sinds 16-11-2026 staat bluegit-backup in de BlueGit-repository ([timfa/bluegit](https://git.timfalken.com/timfa/bluegit)): `cmd/bluegit-backup`, `internal/backupserver/…`, `packaging/backup` en `packaging/aur-backup`. De history van de oude repository timfa/bluegit-backup is meegenomen. Zie `blue-ci-cd.yml`.
153
154- Het AUR-pakket `bluegit-backup` wordt vanaf master van timfa/bluegit bijgewerkt (job `publish_aur_backup`, net als `bluegit-runner`), uit het bronarchief van timfa/bluegit.
155- Bij een tag `v*` komt bluegit-backup in dezelfde release als bluegit en bluegit-runner: binaries (amd64, arm64), `.deb`, `.rpm`, `.pkg.tar.zst` en `SHA256SUMS`.
156- Publicatie en release hangen af van de job `backup_integration`. Die bouwt BlueGit uit dezelfde checkout, start hem, configureert hem en test daarmee elke feature. Faalt er één test, dan komt er geen release.
157- De oude release v0.1.0 kwam uit timfa/bluegit-backup.
158
159Updaten doe je zelf: met je AUR-helper (bijvoorbeeld `yay -Syu bluegit-backup`), met een nieuw pakket of met een nieuwe binary van de releasepagina. Er is geen self-update.
160
161## Tests
162
163```sh
164go test ./internal/backupserver/... # unit-tests
165go test -tags integration -v ./internal/backupserver/integration/ # bouwt BlueGit uit deze checkout
166```
167
168Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.
169
170De 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:
171
172| Test | Feature |
173|---|---|
174| `TestKeyGenerationAndConnect` | Key maken in BlueGit, koppelen, verkeerde key geweigerd |
175| `TestFullSyncCopiesAllData` | Alle data en configuratie komt binnen, en de kopie klopt |
176| `TestNotificationTriggersSync` | Een wijziging in BlueGit geeft een melding en daarna een sync |
177| `TestDownloadIsThrottled` | Downloaden blijft onder `rate_limit_kib` |
178| `TestArchiveIntervalAndListInBlueGit` | Archief per interval, lijst zichtbaar in BlueGit |
179| `TestRetentionAndDiskFull` | Weggooien op leeftijd en bij volle schijf |
180| `TestRollbackFromBlueGit` | Rollback vanuit BlueGit (met bevestiging), BlueGit staat daarna terug |
181| `TestNewInstanceWipe` | Nieuwe instantie, keuze wissen |
182| `TestNewInstanceRestore` | Nieuwe instantie, keuze herstellen |
183| `TestCLIConnectAsksOnConflict` | `connect` vraagt de keuze |
184| `TestWebUIConfiguresAndOperatesEverything` | Webinterface: inloggen, alle instellingen, koppelen, sync, archief, download, opruimen, rollback, verwijderen, ontkoppelen |
185| `TestAPIDoesEverythingTheUICan` | Elke actie via de API; de test faalt als er een actie bij komt zonder test |
186| `TestBlueGitControlsBackupServer` | Instellingen, archief, sync en verwijderen vanuit BlueGit (API en webinterface) |
187| `TestMultipleBackupServers` | Twee backup servers aan één BlueGit; meldingen naar beide; verwijderen ontkoppelt alleen die ene |
188| `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 |
189| `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 |
190
191De pipeline bouwt BlueGit van de ref in `.bluegit-ref`, plus een test-build met protocol 99 (`.bluegit-bin/bluegit-future`) voor `TestCompatBackupTooOld`.
192
193## Licentie
194
195Zie [LICENSE](LICENSE).