BlueGit

timfa bluegit

Releasepakketten: binaries, deb, rpm en arch (nfpm) voor bluegit, bluegit-runner en bluegit-backup, installatietests per distro, release bij tag v*, AUR bluegit-backup vanuit timfa/bluegit, --version

timfa Grok Bot · pushed by timfa

Authored 2026-11-16 · 1 day ago

Hash
1acb856a8c93bd9bbcd96cc8101ce0be10e465de
Parent
bdfdabbb
23 files changed +850 −33
README.md +14 −2
@@ -23,7 +23,7 @@ Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).
23 23 - Periodiek onderhoud van de bare repositories (`git gc --auto`, plus `git maintenance` voor loose objects en incremental-repack als de git-binary dat kent). Standaard elke 24 uur (`git.maintenance_interval`; `off` of `0` zet het uit). Eén repo tegelijk, met lage prioriteit (`nice -n 19`) en gits eigen locking, nooit `--prune=now`. Een fout op één repo slaat die over. Installatiebeheerders zien de status en kunnen een ronde starten via `GET`/`POST /api/v1/admin/git-maintenance`.
24 24 - REST-API. Het schema staat op `/api/v1/openapi.json`.
25 25 - Self-update: de instantie installeert een nieuw AUR-pakket met pacman.
26 - Een of meer losse backup servers ([bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Past een backup server niet bij deze BlueGit (een van de twee is verouderd), dan zien beheerders bovenaan elke pagina een waarschuwing. Zie [docs/BACKUP.md](docs/BACKUP.md).
26 - Een of meer losse backup servers (`bluegit-backup`, ook in deze repository, zie [docs/BACKUP-SERVER.md](docs/BACKUP-SERVER.md)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Past een backup server niet bij deze BlueGit (een van de twee is verouderd), dan zien beheerders bovenaan elke pagina een waarschuwing. Zie [docs/BACKUP.md](docs/BACKUP.md).
27 27 - Linkpreviews: een gedeelde pagina krijgt een kaart via Open Graph, oEmbed en `/-/card.png`.
28 28
29 29 Een repository hoort bij een gebruiker of bij een groep. De hoogste rol telt.
@@ -42,7 +42,17 @@ Op Arch installeer je het AUR-pakket `bluegit`. De configuratie staat in `/etc/b
42 42
43 43 `bluegit example-config` print een voorbeeld. Het clientgeheim hoort in `/etc/bluegit/client_secret` (mode `0600`) of als `BLUEGIT_AUTH_CLIENT_SECRET` in `/etc/bluegit/secret.env`. Zonder configuratie én geheim start de service niet. De eerste aangemelde gebruiker wordt installatiebeheerder en kiest in `/setup` de schijf voor de repositories.
44 44
45 Hoe het pakket gepubliceerd wordt en hoe de self-update via pacman werkt, staat in [docs/AUR.md](docs/AUR.md). De stappen voor de installatie op git.timfalken.com staan in [docs/BEHEER.md](docs/BEHEER.md).
45 Op andere distro's gebruik je de pakketten van de [releasepagina](https://git.timfalken.com/timfa/bluegit/-/releases). Elke release (tag `v*`) heeft voor `bluegit`, `bluegit-runner` en `bluegit-backup`:
46
47 - losse binaries voor linux amd64 en arm64 (`bluegit-linux-amd64`, …);
48 - `.deb` voor Ubuntu Server en Debian (`apt install ./bluegit_amd64.deb`);
49 - `.rpm` voor RHEL, Rocky, Alma en Fedora (`dnf install ./bluegit.x86_64.rpm`);
50 - `.pkg.tar.zst` voor Arch (`pacman -U bluegit-x86_64.pkg.tar.zst`);
51 - `SHA256SUMS` over alle bestanden.
52
53 De pakketten installeren de systemd-unit, de gebruiker (`bluegit`, `bluegit-runner`, `bluegit-backup`) en de config onder `/etc/<naam>/`, net als de AUR-pakketten. Ze zetten de service niet aan. De self-update (bluegit-update) zit alleen in het AUR-pakket. `<programma> --version` toont de tag. De CI test elk pakket in ubuntu:24.04, debian:12, rockylinux:9, fedora en archlinux voordat er een release komt.
54
55 Hoe het AUR-pakket gepubliceerd wordt en hoe de self-update via pacman werkt, staat in [docs/AUR.md](docs/AUR.md). De stappen voor de installatie op git.timfalken.com staan in [docs/BEHEER.md](docs/BEHEER.md).
46 56
47 57 ## Microsoft Entra ID
48 58
@@ -118,6 +128,8 @@ git clone http://tim:bg_…@127.0.0.1:8080/tim/demo.git
118 128 - [docs/AUR.md](docs/AUR.md) beschrijft het pakket en de self-update.
119 129 - [docs/BEHEER.md](docs/BEHEER.md) beschrijft de installatie op git.timfalken.com.
120 130 - [docs/BACKUP.md](docs/BACKUP.md) beschrijft de koppeling met losse backup servers (bluegit-backup): Backupserver-Keys, meldingen, archieven, rollback en bediening vanuit BlueGit.
131 - [docs/BACKUP-SERVER.md](docs/BACKUP-SERVER.md) beschrijft de backup server zelf, [docs/BACKUP-PROTOCOL.md](docs/BACKUP-PROTOCOL.md) het protocol.
132 - [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md) bevat de aannames.
121 133 - [docs/MIGRATIE.md](docs/MIGRATIE.md) beschrijft de overstap van de user-unit naar de system-service.
122 134 - [docs/ROADMAP.md](docs/ROADMAP.md) en [docs/VRAGEN.md](docs/VRAGEN.md) houden bij wat nog openstaat en welke besluiten al vastliggen.
123 135
@@ -23,7 +23,7 @@ Het logo is de blauwe ster: [`assets/logo.svg`](assets/logo.svg).
23- Periodiek onderhoud van de bare repositories (`git gc --auto`, plus `git maintenance` voor loose objects en incremental-repack als de git-binary dat kent). Standaard elke 24 uur (`git.maintenance_interval`; `off` of `0` zet het uit). Eén repo tegelijk, met lage prioriteit (`nice -n 19`) en gits eigen locking, nooit `--prune=now`. Een fout op één repo slaat die over. Installatiebeheerders zien de status en kunnen een ronde starten via `GET`/`POST /api/v1/admin/git-maintenance`.
23- Periodiek onderhoud van de bare repositories (`git gc --auto`, plus `git maintenance` voor loose objects en incremental-repack als de git-binary dat kent). Standaard elke 24 uur (`git.maintenance_interval`; `off` of `0` zet het uit). Eén repo tegelijk, met lage prioriteit (`nice -n 19`) en gits eigen locking, nooit `--prune=now`. Een fout op één repo slaat die over. Installatiebeheerders zien de status en kunnen een ronde starten via `GET`/`POST /api/v1/admin/git-maintenance`.
24- REST-API. Het schema staat op `/api/v1/openapi.json`.
24- REST-API. Het schema staat op `/api/v1/openapi.json`.
25- Self-update: de instantie installeert een nieuw AUR-pakket met pacman.
25- Self-update: de instantie installeert een nieuw AUR-pakket met pacman.
26- Een of meer losse backup servers ([bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Past een backup server niet bij deze BlueGit (een van de twee is verouderd), dan zien beheerders bovenaan elke pagina een waarschuwing. Zie [docs/BACKUP.md](docs/BACKUP.md).
26- Een of meer losse backup servers (`bluegit-backup`, ook in deze repository, zie [docs/BACKUP-SERVER.md](docs/BACKUP-SERVER.md)) onder Beheer > Backup: per server een Backupserver-Key, een melding na elke wijziging, de archieflijst, een rollback met waarschuwing en de bediening en instellingen van de backup server zelf. Past een backup server niet bij deze BlueGit (een van de twee is verouderd), dan zien beheerders bovenaan elke pagina een waarschuwing. Zie [docs/BACKUP.md](docs/BACKUP.md).
27- Linkpreviews: een gedeelde pagina krijgt een kaart via Open Graph, oEmbed en `/-/card.png`.
27- Linkpreviews: een gedeelde pagina krijgt een kaart via Open Graph, oEmbed en `/-/card.png`.
28
28
29Een repository hoort bij een gebruiker of bij een groep. De hoogste rol telt.
29Een repository hoort bij een gebruiker of bij een groep. De hoogste rol telt.
@@ -42,7 +42,17 @@ Op Arch installeer je het AUR-pakket `bluegit`. De configuratie staat in `/etc/b
42
42
43`bluegit example-config` print een voorbeeld. Het clientgeheim hoort in `/etc/bluegit/client_secret` (mode `0600`) of als `BLUEGIT_AUTH_CLIENT_SECRET` in `/etc/bluegit/secret.env`. Zonder configuratie én geheim start de service niet. De eerste aangemelde gebruiker wordt installatiebeheerder en kiest in `/setup` de schijf voor de repositories.
43`bluegit example-config` print een voorbeeld. Het clientgeheim hoort in `/etc/bluegit/client_secret` (mode `0600`) of als `BLUEGIT_AUTH_CLIENT_SECRET` in `/etc/bluegit/secret.env`. Zonder configuratie én geheim start de service niet. De eerste aangemelde gebruiker wordt installatiebeheerder en kiest in `/setup` de schijf voor de repositories.
44
44
45Hoe het pakket gepubliceerd wordt en hoe de self-update via pacman werkt, staat in [docs/AUR.md](docs/AUR.md). De stappen voor de installatie op git.timfalken.com staan in [docs/BEHEER.md](docs/BEHEER.md).
45Op andere distro's gebruik je de pakketten van de [releasepagina](https://git.timfalken.com/timfa/bluegit/-/releases). Elke release (tag `v*`) heeft voor `bluegit`, `bluegit-runner` en `bluegit-backup`:
46
47- losse binaries voor linux amd64 en arm64 (`bluegit-linux-amd64`, …);
48- `.deb` voor Ubuntu Server en Debian (`apt install ./bluegit_amd64.deb`);
49- `.rpm` voor RHEL, Rocky, Alma en Fedora (`dnf install ./bluegit.x86_64.rpm`);
50- `.pkg.tar.zst` voor Arch (`pacman -U bluegit-x86_64.pkg.tar.zst`);
51- `SHA256SUMS` over alle bestanden.
52
53De pakketten installeren de systemd-unit, de gebruiker (`bluegit`, `bluegit-runner`, `bluegit-backup`) en de config onder `/etc/<naam>/`, net als de AUR-pakketten. Ze zetten de service niet aan. De self-update (bluegit-update) zit alleen in het AUR-pakket. `<programma> --version` toont de tag. De CI test elk pakket in ubuntu:24.04, debian:12, rockylinux:9, fedora en archlinux voordat er een release komt.
54
55Hoe het AUR-pakket gepubliceerd wordt en hoe de self-update via pacman werkt, staat in [docs/AUR.md](docs/AUR.md). De stappen voor de installatie op git.timfalken.com staan in [docs/BEHEER.md](docs/BEHEER.md).
46
56
47## Microsoft Entra ID
57## Microsoft Entra ID
48
58
@@ -118,6 +128,8 @@ git clone http://tim:bg_…@127.0.0.1:8080/tim/demo.git
118- [docs/AUR.md](docs/AUR.md) beschrijft het pakket en de self-update.
128- [docs/AUR.md](docs/AUR.md) beschrijft het pakket en de self-update.
119- [docs/BEHEER.md](docs/BEHEER.md) beschrijft de installatie op git.timfalken.com.
129- [docs/BEHEER.md](docs/BEHEER.md) beschrijft de installatie op git.timfalken.com.
120- [docs/BACKUP.md](docs/BACKUP.md) beschrijft de koppeling met losse backup servers (bluegit-backup): Backupserver-Keys, meldingen, archieven, rollback en bediening vanuit BlueGit.
130- [docs/BACKUP.md](docs/BACKUP.md) beschrijft de koppeling met losse backup servers (bluegit-backup): Backupserver-Keys, meldingen, archieven, rollback en bediening vanuit BlueGit.
131- [docs/BACKUP-SERVER.md](docs/BACKUP-SERVER.md) beschrijft de backup server zelf, [docs/BACKUP-PROTOCOL.md](docs/BACKUP-PROTOCOL.md) het protocol.
132- [docs/ASSUMPTIONS.md](docs/ASSUMPTIONS.md) bevat de aannames.
121- [docs/MIGRATIE.md](docs/MIGRATIE.md) beschrijft de overstap van de user-unit naar de system-service.
133- [docs/MIGRATIE.md](docs/MIGRATIE.md) beschrijft de overstap van de user-unit naar de system-service.
122- [docs/ROADMAP.md](docs/ROADMAP.md) en [docs/VRAGEN.md](docs/VRAGEN.md) houden bij wat nog openstaat en welke besluiten al vastliggen.
134- [docs/ROADMAP.md](docs/ROADMAP.md) en [docs/VRAGEN.md](docs/VRAGEN.md) houden bij wat nog openstaat en welke besluiten al vastliggen.
123
135
blue-ci-cd.yml +152 −1
@@ -1,4 +1,15 @@
1 1 # Pipeline waarmee Steve BlueGit zelf test, bouwt en op master publiceert.
2 # Eén repository voor bluegit, bluegit-runner en bluegit-backup:
3 # test vet, unit-tests, frontend en de backup-integratietests (echte
4 # BlueGit uit deze checkout)
5 # build build (voor de AUR-jobs, ongewijzigd) en binaries (amd64 + arm64,
6 # met versie = tag of korte sha)
7 # package .deb, .rpm en .pkg.tar.zst per programma (nfpm) + SHA256SUMS
8 # verify installeren in ubuntu:24.04, debian:12, rockylinux:9, fedora en
9 # archlinux: --version, units, gebruiker, verwijderen
10 # release master: AUR (bluegit, bluegit-runner, bluegit-backup) en
11 # self_update; tag v*: release met alle pakketten, alleen als
12 # alle jobs hierboven slagen (create-only, de tag blijft staan)
2 13 # De mirror https://git.timfalken.com/timfa/bluegit leest dit bestand.
3 14 # .gitlab-ci.yml blijft de GitLab-pipeline zolang de repository daar nog staat.
4 15 #
@@ -13,7 +24,7 @@
13 24 # Markeer ze als beschermd en bescherm master. Dan komen ze alleen mee
14 25 # op een beschermde branch. Een merge request draait alleen test en build.
15 26
16 stages: [test, build, release]
27 stages: [test, build, package, verify, release]
17 28
18 29 variables:
19 30 CGO_ENABLED: "0"
@@ -28,6 +39,10 @@ jobs:
28 39 - if: $CI_COMMIT_BRANCH != null
29 40 - if: $CI_COMMIT_TAG != null
30 41
42 .on_tag:
43 rules:
44 - if: $CI_COMMIT_TAG =~ /^v[0-9]/
45
31 46 .on_master:
32 47 rules:
33 48 - if: $CI_PIPELINE_SOURCE == "merge_request_event"
@@ -67,6 +82,111 @@ jobs:
67 82 paths: [bluegit]
68 83 expire_in: 14d
69 84
85 # De backup server tegen een echte BlueGit, gebouwd uit deze checkout
86 # (TestMain in internal/backupserver/integration). Elke feature heeft een
87 # test; release en AUR van bluegit-backup hangen hiervan af.
88 backup_integration:
89 stage: test
90 image: bluegit/go
91 extends: .on_ci
92 timeout: 30m
93 script:
94 - go vet -tags integration ./internal/backupserver/integration/
95 - go test -tags integration -count=1 -v ./internal/backupserver/integration/
96
97 # Losse binaries voor de release en de pakketten. Versie = tag of korte sha.
98 binaries:
99 stage: build
100 image: bluegit/go
101 extends: .on_ci
102 needs: [vet, test, frontend_checks, backup_integration]
103 script:
104 - mkdir -p dist
105 - V="${CI_COMMIT_TAG:-$CI_COMMIT_SHORT_SHA}"
106 - |
107 for a in amd64 arm64; do
108 GOARCH=$a go build -trimpath -ldflags="-s -w -X main.version=$V" -o dist/bluegit-linux-$a ./cmd/bluegit
109 GOARCH=$a go build -trimpath -ldflags="-s -w -X main.version=$V" -o dist/bluegit-runner-linux-$a ./cmd/bluegit-runner
110 GOARCH=$a go build -trimpath -ldflags="-s -w -X gitlab.com/Timfa/bluegit/internal/backupserver/server.Version=$V" -o dist/bluegit-backup-linux-$a ./cmd/bluegit-backup
111 done
112 - dist/bluegit-linux-amd64 --version
113 artifacts:
114 paths: [dist/bluegit-linux-amd64, dist/bluegit-linux-arm64, dist/bluegit-runner-linux-amd64, dist/bluegit-runner-linux-arm64, dist/bluegit-backup-linux-amd64, dist/bluegit-backup-linux-arm64]
115 expire_in: 3d
116
117 # nfpm bouwt per programma .deb, .rpm en .pkg.tar.zst voor amd64 en arm64.
118 # De artifacts bevatten ook de binaries, zodat de release alles uit één
119 # job haalt; SHA256SUMS dekt alle 24 bestanden.
120 package:
121 stage: package
122 image: bluegit/go
123 extends: .on_ci
124 needs: [binaries]
125 script:
126 - go install github.com/goreleaser/nfpm/v2/cmd/nfpm@v2.43.0
127 - export PATH="$(go env GOPATH)/bin:$PATH"
128 - chmod +x scripts/build-packages.sh
129 - ./scripts/build-packages.sh
130 artifacts:
131 paths:
132 - dist/SHA256SUMS
133 - dist/bluegit-linux-amd64
134 - dist/bluegit-linux-arm64
135 - dist/bluegit_amd64.deb
136 - dist/bluegit_arm64.deb
137 - dist/bluegit.x86_64.rpm
138 - dist/bluegit.aarch64.rpm
139 - dist/bluegit-x86_64.pkg.tar.zst
140 - dist/bluegit-aarch64.pkg.tar.zst
141 - dist/bluegit-runner-linux-amd64
142 - dist/bluegit-runner-linux-arm64
143 - dist/bluegit-runner_amd64.deb
144 - dist/bluegit-runner_arm64.deb
145 - dist/bluegit-runner.x86_64.rpm
146 - dist/bluegit-runner.aarch64.rpm
147 - dist/bluegit-runner-x86_64.pkg.tar.zst
148 - dist/bluegit-runner-aarch64.pkg.tar.zst
149 - dist/bluegit-backup-linux-amd64
150 - dist/bluegit-backup-linux-arm64
151 - dist/bluegit-backup_amd64.deb
152 - dist/bluegit-backup_arm64.deb
153 - dist/bluegit-backup.x86_64.rpm
154 - dist/bluegit-backup.aarch64.rpm
155 - dist/bluegit-backup-x86_64.pkg.tar.zst
156 - dist/bluegit-backup-aarch64.pkg.tar.zst
157 expire_in: 3d
158
159 # Installatietest per distro (amd64). Zie scripts/test-package.sh.
160 .package_test:
161 stage: verify
162 needs: [package]
163 rules:
164 - if: $CI_PIPELINE_SOURCE == "merge_request_event"
165 - if: $CI_COMMIT_BRANCH != null
166 - if: $CI_COMMIT_TAG != null
167 script:
168 - bash scripts/test-package.sh
169
170 package_ubuntu:
171 extends: .package_test
172 image: ubuntu:24.04
173
174 package_debian:
175 extends: .package_test
176 image: debian:12
177
178 package_rocky:
179 extends: .package_test
180 image: rockylinux:9
181
182 package_fedora:
183 extends: .package_test
184 image: fedora:latest
185
186 package_arch:
187 extends: .package_test
188 image: archlinux:latest
189
70 190 # Vóór self_update. De archive-route staat live, dus de tarball van
71 191 # deze sha is te downloaden met de binary die al draait.
72 192 # allow_failure: een AUR-storing maakt de pipeline niet rood en houdt
@@ -98,6 +218,37 @@ jobs:
98 218 - ./scripts/aur-ssh-setup.sh
99 219 - AUR_PKG=bluegit-runner ./scripts/publish-aur.sh
100 220
221 # Het AUR-pakket bluegit-backup (tot 16-11-2026 uit timfa/bluegit-backup).
222 # Zelfde AUR-SSH-geheim; hangt ook af van de backup-integratietests.
223 publish_aur_backup:
224 stage: release
225 image: archlinux/archlinux:base-devel
226 extends: .on_master
227 needs: [build, backup_integration]
228 allow_failure: true
229 script:
230 - pacman -Syu --noconfirm
231 - pacman -S --noconfirm --needed git openssh curl coreutils shadow util-linux
232 - chmod +x scripts/aur-ssh-setup.sh scripts/publish-aur.sh
233 - ./scripts/aur-ssh-setup.sh
234 - AUR_PKG=bluegit-backup ./scripts/publish-aur.sh
235
236 # Release bij een bestaande tag v* (die Tim zet). Create-only: de server
237 # maakt of verplaatst de tag niet en weigert een tweede release.
238 release_packages:
239 stage: release
240 image: bluegit/base
241 extends: .on_tag
242 needs: [vet, test, frontend_checks, backup_integration, build, package, package_ubuntu, package_debian, package_rocky, package_fedora, package_arch]
243 script:
244 - chmod +x scripts/build-packages.sh
245 - ./scripts/build-packages.sh --json "$CI_COMMIT_TAG" "$CI_COMMIT_SHA" BlueGit > release.json
246 - |
247 curl -fsS -X POST "$CI_API_URL/repos/$CI_PROJECT_PATH/releases/$CI_COMMIT_TAG/assets" \
248 -H "Authorization: Bearer $CI_JOB_TOKEN" \
249 -H "Content-Type: application/json" \
250 --data-binary @release.json
251
101 252 # Laatste job. needs: [publish_aur] geldt ook als die job met
102 253 # allow_failure mislukt. Alleen de POST; de job eindigt meteen groen.
103 254 # De updater bouwt zelf uit git; dit artifact gaat niet mee.
@@ -1,4 +1,15 @@
1# Pipeline waarmee Steve BlueGit zelf test, bouwt en op master publiceert.
1# Pipeline waarmee Steve BlueGit zelf test, bouwt en op master publiceert.
2# Eén repository voor bluegit, bluegit-runner en bluegit-backup:
3# test vet, unit-tests, frontend en de backup-integratietests (echte
4# BlueGit uit deze checkout)
5# build build (voor de AUR-jobs, ongewijzigd) en binaries (amd64 + arm64,
6# met versie = tag of korte sha)
7# package .deb, .rpm en .pkg.tar.zst per programma (nfpm) + SHA256SUMS
8# verify installeren in ubuntu:24.04, debian:12, rockylinux:9, fedora en
9# archlinux: --version, units, gebruiker, verwijderen
10# release master: AUR (bluegit, bluegit-runner, bluegit-backup) en
11# self_update; tag v*: release met alle pakketten, alleen als
12# alle jobs hierboven slagen (create-only, de tag blijft staan)
2# De mirror https://git.timfalken.com/timfa/bluegit leest dit bestand.
13# De mirror https://git.timfalken.com/timfa/bluegit leest dit bestand.
3# .gitlab-ci.yml blijft de GitLab-pipeline zolang de repository daar nog staat.
14# .gitlab-ci.yml blijft de GitLab-pipeline zolang de repository daar nog staat.
4#
15#
@@ -13,7 +24,7 @@
13# Markeer ze als beschermd en bescherm master. Dan komen ze alleen mee
24# Markeer ze als beschermd en bescherm master. Dan komen ze alleen mee
14# op een beschermde branch. Een merge request draait alleen test en build.
25# op een beschermde branch. Een merge request draait alleen test en build.
15
26
16stages: [test, build, release]
27stages: [test, build, package, verify, release]
17
28
18variables:
29variables:
19 CGO_ENABLED: "0"
30 CGO_ENABLED: "0"
@@ -28,6 +39,10 @@ jobs:
28 - if: $CI_COMMIT_BRANCH != null
39 - if: $CI_COMMIT_BRANCH != null
29 - if: $CI_COMMIT_TAG != null
40 - if: $CI_COMMIT_TAG != null
30
41
42 .on_tag:
43 rules:
44 - if: $CI_COMMIT_TAG =~ /^v[0-9]/
45
31 .on_master:
46 .on_master:
32 rules:
47 rules:
33 - if: $CI_PIPELINE_SOURCE == "merge_request_event"
48 - if: $CI_PIPELINE_SOURCE == "merge_request_event"
@@ -67,6 +82,111 @@ jobs:
67 paths: [bluegit]
82 paths: [bluegit]
68 expire_in: 14d
83 expire_in: 14d
69
84
85 # De backup server tegen een echte BlueGit, gebouwd uit deze checkout
86 # (TestMain in internal/backupserver/integration). Elke feature heeft een
87 # test; release en AUR van bluegit-backup hangen hiervan af.
88 backup_integration:
89 stage: test
90 image: bluegit/go
91 extends: .on_ci
92 timeout: 30m
93 script:
94 - go vet -tags integration ./internal/backupserver/integration/
95 - go test -tags integration -count=1 -v ./internal/backupserver/integration/
96
97 # Losse binaries voor de release en de pakketten. Versie = tag of korte sha.
98 binaries:
99 stage: build
100 image: bluegit/go
101 extends: .on_ci
102 needs: [vet, test, frontend_checks, backup_integration]
103 script:
104 - mkdir -p dist
105 - V="${CI_COMMIT_TAG:-$CI_COMMIT_SHORT_SHA}"
106 - |
107 for a in amd64 arm64; do
108 GOARCH=$a go build -trimpath -ldflags="-s -w -X main.version=$V" -o dist/bluegit-linux-$a ./cmd/bluegit
109 GOARCH=$a go build -trimpath -ldflags="-s -w -X main.version=$V" -o dist/bluegit-runner-linux-$a ./cmd/bluegit-runner
110 GOARCH=$a go build -trimpath -ldflags="-s -w -X gitlab.com/Timfa/bluegit/internal/backupserver/server.Version=$V" -o dist/bluegit-backup-linux-$a ./cmd/bluegit-backup
111 done
112 - dist/bluegit-linux-amd64 --version
113 artifacts:
114 paths: [dist/bluegit-linux-amd64, dist/bluegit-linux-arm64, dist/bluegit-runner-linux-amd64, dist/bluegit-runner-linux-arm64, dist/bluegit-backup-linux-amd64, dist/bluegit-backup-linux-arm64]
115 expire_in: 3d
116
117 # nfpm bouwt per programma .deb, .rpm en .pkg.tar.zst voor amd64 en arm64.
118 # De artifacts bevatten ook de binaries, zodat de release alles uit één
119 # job haalt; SHA256SUMS dekt alle 24 bestanden.
120 package:
121 stage: package
122 image: bluegit/go
123 extends: .on_ci
124 needs: [binaries]
125 script:
126 - go install github.com/goreleaser/nfpm/v2/cmd/nfpm@v2.43.0
127 - export PATH="$(go env GOPATH)/bin:$PATH"
128 - chmod +x scripts/build-packages.sh
129 - ./scripts/build-packages.sh
130 artifacts:
131 paths:
132 - dist/SHA256SUMS
133 - dist/bluegit-linux-amd64
134 - dist/bluegit-linux-arm64
135 - dist/bluegit_amd64.deb
136 - dist/bluegit_arm64.deb
137 - dist/bluegit.x86_64.rpm
138 - dist/bluegit.aarch64.rpm
139 - dist/bluegit-x86_64.pkg.tar.zst
140 - dist/bluegit-aarch64.pkg.tar.zst
141 - dist/bluegit-runner-linux-amd64
142 - dist/bluegit-runner-linux-arm64
143 - dist/bluegit-runner_amd64.deb
144 - dist/bluegit-runner_arm64.deb
145 - dist/bluegit-runner.x86_64.rpm
146 - dist/bluegit-runner.aarch64.rpm
147 - dist/bluegit-runner-x86_64.pkg.tar.zst
148 - dist/bluegit-runner-aarch64.pkg.tar.zst
149 - dist/bluegit-backup-linux-amd64
150 - dist/bluegit-backup-linux-arm64
151 - dist/bluegit-backup_amd64.deb
152 - dist/bluegit-backup_arm64.deb
153 - dist/bluegit-backup.x86_64.rpm
154 - dist/bluegit-backup.aarch64.rpm
155 - dist/bluegit-backup-x86_64.pkg.tar.zst
156 - dist/bluegit-backup-aarch64.pkg.tar.zst
157 expire_in: 3d
158
159 # Installatietest per distro (amd64). Zie scripts/test-package.sh.
160 .package_test:
161 stage: verify
162 needs: [package]
163 rules:
164 - if: $CI_PIPELINE_SOURCE == "merge_request_event"
165 - if: $CI_COMMIT_BRANCH != null
166 - if: $CI_COMMIT_TAG != null
167 script:
168 - bash scripts/test-package.sh
169
170 package_ubuntu:
171 extends: .package_test
172 image: ubuntu:24.04
173
174 package_debian:
175 extends: .package_test
176 image: debian:12
177
178 package_rocky:
179 extends: .package_test
180 image: rockylinux:9
181
182 package_fedora:
183 extends: .package_test
184 image: fedora:latest
185
186 package_arch:
187 extends: .package_test
188 image: archlinux:latest
189
70 # Vóór self_update. De archive-route staat live, dus de tarball van
190 # Vóór self_update. De archive-route staat live, dus de tarball van
71 # deze sha is te downloaden met de binary die al draait.
191 # deze sha is te downloaden met de binary die al draait.
72 # allow_failure: een AUR-storing maakt de pipeline niet rood en houdt
192 # allow_failure: een AUR-storing maakt de pipeline niet rood en houdt
@@ -98,6 +218,37 @@ jobs:
98 - ./scripts/aur-ssh-setup.sh
218 - ./scripts/aur-ssh-setup.sh
99 - AUR_PKG=bluegit-runner ./scripts/publish-aur.sh
219 - AUR_PKG=bluegit-runner ./scripts/publish-aur.sh
100
220
221 # Het AUR-pakket bluegit-backup (tot 16-11-2026 uit timfa/bluegit-backup).
222 # Zelfde AUR-SSH-geheim; hangt ook af van de backup-integratietests.
223 publish_aur_backup:
224 stage: release
225 image: archlinux/archlinux:base-devel
226 extends: .on_master
227 needs: [build, backup_integration]
228 allow_failure: true
229 script:
230 - pacman -Syu --noconfirm
231 - pacman -S --noconfirm --needed git openssh curl coreutils shadow util-linux
232 - chmod +x scripts/aur-ssh-setup.sh scripts/publish-aur.sh
233 - ./scripts/aur-ssh-setup.sh
234 - AUR_PKG=bluegit-backup ./scripts/publish-aur.sh
235
236 # Release bij een bestaande tag v* (die Tim zet). Create-only: de server
237 # maakt of verplaatst de tag niet en weigert een tweede release.
238 release_packages:
239 stage: release
240 image: bluegit/base
241 extends: .on_tag
242 needs: [vet, test, frontend_checks, backup_integration, build, package, package_ubuntu, package_debian, package_rocky, package_fedora, package_arch]
243 script:
244 - chmod +x scripts/build-packages.sh
245 - ./scripts/build-packages.sh --json "$CI_COMMIT_TAG" "$CI_COMMIT_SHA" BlueGit > release.json
246 - |
247 curl -fsS -X POST "$CI_API_URL/repos/$CI_PROJECT_PATH/releases/$CI_COMMIT_TAG/assets" \
248 -H "Authorization: Bearer $CI_JOB_TOKEN" \
249 -H "Content-Type: application/json" \
250 --data-binary @release.json
251
101 # Laatste job. needs: [publish_aur] geldt ook als die job met
252 # Laatste job. needs: [publish_aur] geldt ook als die job met
102 # allow_failure mislukt. Alleen de POST; de job eindigt meteen groen.
253 # allow_failure mislukt. Alleen de POST; de job eindigt meteen groen.
103 # De updater bouwt zelf uit git; dit artifact gaat niet mee.
254 # De updater bouwt zelf uit git; dit artifact gaat niet mee.
cmd/bluegit/main.go +7 −0
@@ -27,6 +27,10 @@ import (
27 27 "gitlab.com/Timfa/bluegit/internal/store"
28 28 )
29 29
30 // version wordt bij het bouwen gezet: -ldflags "-X main.version=v0.1.0".
31 // Zonder ldflag (AUR, self-update) blijft het "dev".
32 var version = "dev"
33
30 34 func main() {
31 35 if len(os.Args) < 2 {
32 36 usage()
@@ -47,6 +51,8 @@ func main() {
47 51 }
48 52 case "example-config":
49 53 fmt.Print(config.Example())
54 case "version", "--version":
55 fmt.Println(version)
50 56 default:
51 57 usage()
52 58 os.Exit(2)
@@ -60,6 +66,7 @@ func usage() {
60 66 bluegit hook pre-receive
61 67 bluegit token create --config /etc/bluegit/config.yml --user tim --name laptop
62 68 bluegit example-config
69 bluegit version
63 70 `)
64 71 }
65 72
@@ -27,6 +27,10 @@ import (
27 "gitlab.com/Timfa/bluegit/internal/store"
27 "gitlab.com/Timfa/bluegit/internal/store"
28)
28)
29
29
30// version wordt bij het bouwen gezet: -ldflags "-X main.version=v0.1.0".
31// Zonder ldflag (AUR, self-update) blijft het "dev".
32var version = "dev"
33
30func main() {
34func main() {
31 if len(os.Args) < 2 {
35 if len(os.Args) < 2 {
32 usage()
36 usage()
@@ -47,6 +51,8 @@ func main() {
47 }
51 }
48 case "example-config":
52 case "example-config":
49 fmt.Print(config.Example())
53 fmt.Print(config.Example())
54 case "version", "--version":
55 fmt.Println(version)
50 default:
56 default:
51 usage()
57 usage()
52 os.Exit(2)
58 os.Exit(2)
@@ -60,6 +66,7 @@ func usage() {
60 bluegit hook pre-receive
66 bluegit hook pre-receive
61 bluegit token create --config /etc/bluegit/config.yml --user tim --name laptop
67 bluegit token create --config /etc/bluegit/config.yml --user tim --name laptop
62 bluegit example-config
68 bluegit example-config
69 bluegit version
63`)
70`)
64}
71}
65
72
docs/ASSUMPTIONS.md +31 −13
@@ -2,12 +2,28 @@
2 2
3 3 Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders, dan is het per punt aan te passen.
4 4
5 ## Opzet
5 ## Eén repository en releasepakketten (16-11-2026)
6
7 - **bluegit-backup in timfa/bluegit**: met history samengevoegd (git filter-repo, daarna een merge). `internal/*` van de backup server staat in `internal/backupserver/*`, de integratietests in `internal/backupserver/integration`, de packaging in `packaging/backup` en `packaging/aur-backup`, de README in `docs/BACKUP-SERVER.md` en het protocol in `docs/BACKUP-PROTOCOL.md`. Deze aannames kwamen ook uit die repository. `scripts/build-bluegit.sh` en `.bluegit-ref` zijn vervallen: de integratietests bouwen BlueGit in `TestMain` uit dezelfde checkout.
8 - De twee protocolpakketten (`internal/backup` aan de BlueGit-kant en `internal/backupserver/protocol`) blijven apart. Zo kunnen de integratietests een oudere of nieuwere kant nabootsen.
9 - **AUR**: `bluegit-backup` gaat vanaf master via `publish_aur_backup` met dezelfde AUR-geheimen als `bluegit` en `bluegit-runner`, en hangt ook af van `backup_integration`. De pkgver blijft de commit-tijd in UTC, dus het versienummer loopt door.
10 - **Pakketten**: nfpm (v2.43.0, vastgezet) maakt .deb, .rpm en .pkg.tar.zst voor amd64 en arm64. Inhoud, unit, gebruiker en config komen uit de PKGBUILDs. Het Arch-pakket heeft net als de AUR `docker` als dependency voor bluegit en bluegit-runner. Bij deb en rpm is docker alleen een aanbeveling, omdat de pakketnaam per distro verschilt (docker.io, docker-ce, moby-engine). De rpm's hangen af van `shadow-utils` voor useradd.
11 - De pakketten maken de gebruiker met systemd-sysusers, of met groupadd/useradd als dat er niet is (kale containers). Ze zetten de service niet aan en herstarten hem alleen als hij al draaide. Verwijderen zet de service uit en laat gebruiker, config en `/var/lib/<naam>` staan.
12 - `bluegit-update` (de self-update via makepkg/pacman) en de gebruiker `bluegit-build` zitten alleen in het AUR-pakket.
13 - **Bestandsnamen** in de release hebben geen versie (`bluegit_amd64.deb`, `bluegit.x86_64.rpm`, `bluegit-x86_64.pkg.tar.zst`), zodat de artifact-paden vast zijn en `SHA256SUMS` er precies bij past. De versie staat in het pakket zelf: tag `v1.2.3` wordt `1.2.3-1`, en `v1.0.0-rc1` wordt `1.0.0.rc1`, omdat archlinux geen `-` in pkgver toestaat. Builds zonder tag krijgen `0.0.0.git<sha>`.
14 - `--version` (ook `version`) toont `main.version` of `server.Version`: de tag bij een release, de korte sha op andere pipelines en `dev` zonder ldflag (AUR en self-update).
15 - De installatietest draait alleen voor amd64. De arm64-pakketten worden wel gebouwd, maar de runner heeft geen arm64.
16 - Package-artifacts blijven 3 dagen bewaard, omdat ze groot zijn (ongeveer 200 MB per pipeline). De release kopieert ze meteen.
17 - **Release**: alleen bij een tag `v*`, via het create-only endpoint `POST …/releases/{tag}/assets`, en alleen als vet, test, frontend_checks, backup_integration, package en alle vijf installatietests slagen. Het tagpatroon `v*` is beschermd.
18
19 ## Backup server (uit timfa/bluegit-backup)
20
21 ### Opzet
6 22
7 23 - **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.
8 24 - Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.
9 25
10 ## Webinterface en API
26 ### Webinterface en API
11 27
12 28 - De webinterface draait op hetzelfde adres als de API, standaard `0.0.0.0:8080`. Er komt geen aparte poort voor BlueGit: BlueGit praat met dezelfde server (ondertekend).
13 29 - **Inloggen gaat met het beheertoken** uit `data_dir/admin.token` (`bba_…`, 0600). Dat token gebruiken ook de API en de CLI. Er komt geen apart gebruikersbeheer: de backup server heeft één beheerder. `bluegit-backup token` toont het token.
@@ -17,7 +33,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
17 33 - In de webinterface kun je ook een rollback starten en een archief downloaden of verwijderen. De rollback heeft dezelfde waarschuwing en bevestiging als in BlueGit.
18 34 - De webinterface is gewone HTML zonder JavaScript, in het Nederlands. Hij weigert framing (`X-Frame-Options: DENY`). Daarom bedient BlueGit de backup server via de API en niet met een iframe.
19 35
20 ## Bediening vanuit BlueGit
36 ### Bediening vanuit BlueGit
21 37
22 38 - Tim gaf de keuze tussen een iframe of een API-koppeling met een vergelijkbare interface. Ik koos de **API-koppeling**:
23 39 - Een iframe zou een tweede login vragen.
@@ -30,7 +46,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
30 46 - De instellingen in BlueGit tonen de labels en uitleg van de backup server, dus in het Nederlands. Wat BlueGit er zelf omheen zet, is vertaald (en, nl, de, fr).
31 47 - Verwijdert een beheerder een backup server in BlueGit, dan vraagt BlueGit de backup server eerst om te ontkoppelen. De kopie en de archieven blijven op de backup server staan.
32 48
33 ## Meerdere backup servers
49 ### Meerdere backup servers
34 50
35 51 - Eén BlueGit kan tot **16** backup servers hebben, elk met een eigen naam en key. Dat zijn er genoeg voor een paar plekken (bijvoorbeeld thuis en offsite), en het begrenst het aantal meldingen per wijziging.
36 52 - Elke backup server krijgt elke melding, parallel. Een server die niet reageert, houdt de andere niet op.
@@ -38,7 +54,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
38 54 - Koppelt een tweede backup server met dezelfde key, dan gaat de koppeling (het adres voor meldingen) naar die server. Een key hoort bij één server. Geef een nieuwe server een eigen key.
39 55 - `backup.json` bevat nu een lijst met servers. De oude vorm met één koppeling wordt bij het lezen omgezet.
40 56
41 ## Key en authenticatie
57 ### Key en authenticatie
42 58
43 59 - BlueGit maakt per backup server een Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
44 60 - Een nieuwe key voor een server maakt zijn oude key ongeldig. Verwijderen ontkoppelt die server.
@@ -47,7 +63,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
47 63 - De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.
48 64 - Je koppelt in de webinterface, met de API, of met `bluegit-backup connect --url …` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
49 65
50 ## Wat wordt geback-upt
66 ### Wat wordt geback-upt
51 67
52 68 - Alles wat BlueGit nodig heeft om identiek terug te komen:
53 69 - de database (`bluegit.db`) als consistente snapshot via `VACUUM INTO`
@@ -62,7 +78,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
62 78 - de backupkoppeling en het instance-id
63 79 - "Configuratie" in de opdracht lees ik als: alle instellingen die BlueGit in zijn database en state-map bewaart, plus de sleutels. `config.yml` valt daar niet onder.
64 80
65 ## Meldingen en synchroniseren
81 ### Meldingen en synchroniseren
66 82
67 83 - BlueGit meldt een wijziging na elk muterend verzoek: elke niet-GET, behalve de backup-API zelf en `git-upload-pack` (clonen en fetchen). Daarnaast meldt BlueGit na elke push (HTTP en SSH) en na elk intern event, zoals CI of releases.
68 84 - Meldingen worden 2 seconden gebundeld en tot 4 keer opnieuw geprobeerd. Een melding bevat geen data, alleen "er is iets veranderd" (`POST /api/v1/notify`).
@@ -71,13 +87,13 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
71 87 - Mist de server een melding (omdat hij uit stond of het netwerk weg was), dan vangt de volledige controle elk `full_sync_interval` (1u) dat op, en ook een herstart.
72 88 - Een bestand dat tijdens het downloaden verandert (grootte klopt niet), wordt bij de volgende sync opnieuw opgehaald.
73 89
74 ## Gedoseerd downloaden
90 ### Gedoseerd downloaden
75 91
76 92 - Een token bucket begrenst de downloadsnelheid tot `rate_limit_kib` KiB/s (standaard 1024, dus 1 MiB/s), over alle downloads samen.
77 93 - Er is altijd maar één download tegelijk. BlueGit krijgt dus nooit meer dan één verzoek tegelijk van de backup server.
78 94 - De database-snapshot kost BlueGit eenmalig een `VACUUM INTO` per manifest. Bij een grote database is dat het zwaarste deel, maar het blokkeert schrijvers in WAL-modus niet.
79 95
80 ## Archieven
96 ### Archieven
81 97
82 98 - Formaat: `tar.gz` (PAX), met de lopende kopie als inhoud (`state/…` en `data/…`). Je kunt een archief dus ook met de hand uitpakken.
83 99 - Naam: `bluegit-YYYYMMDD-HHMMSS.tar.gz` in UTC, met `-2`, `-3`, … als er in dezelfde seconde meer zijn.
@@ -89,7 +105,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
89 105 - Het nieuwste archief blijft altijd staan, ook als het te oud is. Anders zou er geen backup meer zijn.
90 106 - Is er vóór een nieuw archief niet genoeg ruimte, dan mogen alle oude archieven weg om plaats te maken. Het nieuwe archief wordt dan het enige.
91 107
92 ## Rollback
108 ### Rollback
93 109
94 110 - De beheerder start de rollback in BlueGit onder *Beheer → Backup*. Daar staat een grote rode waarschuwing: "Dit kan niet ongedaan worden gemaakt". Er moet een vinkje gezet worden en de archiefnaam overgetypt. De API vraagt `"confirm": "<archiefnaam>"`.
95 111 - Het verloop:
@@ -102,7 +118,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
102 118 - Archieven die nieuwer zijn dan het teruggezette archief blijven bewaard. Een rollback naar een te oud archief is zo nog te herstellen met een nieuwere rollback, maar alleen voor wat er in die archieven zat.
103 119 - Het upload-verkeer naar BlueGit bij een rollback is **niet** gedoseerd. BlueGit staat dan toch al stil, en een snelle terugzet is belangrijker.
104 120
105 ## Nieuwe instantie
121 ### Nieuwe instantie
106 122
107 123 - Een BlueGit wordt herkend aan zijn `instance_id` (`<state>/instance_id`). Een andere URL met hetzelfde instance-id is dezelfde instantie, bijvoorbeeld na een verhuizing.
108 124 - Koppel je een andere instantie, dan weigert de server (`409`) en moet je kiezen:
@@ -111,7 +127,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
111 127 - `connect` vraagt de keuze in de terminal. Zonder keuze (lege invoer) gebeurt er niets. Zonder terminal gebruik je `--on-conflict wipe|restore`.
112 128 - De nieuwe BlueGit moet al draaien met een eigen `config.yml` en data-schijf. Het herstel vult alleen de inhoud.
113 129
114 ## Compatibiliteit (t1209u)
130 ### Compatibiliteit (t1209u)
115 131
116 132 - 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 133 - 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`.
@@ -125,7 +141,9 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
125 141 - **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 142 - **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 143
128 ## Releases en tests
144 ### Releases en tests
145
146 Tot 16-11-2026, toen dit nog een aparte repository was. Wat er sindsdien geldt, staat bovenaan.
129 147
130 148 - "Dezelfde release-opties als BlueGit" betekent:
131 149 - een AUR-pakket `bluegit-backup` dat vanaf master wordt bijgewerkt
@@ -2,12 +2,28 @@
2
2
3Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders, dan is het per punt aan te passen.
3Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders, dan is het per punt aan te passen.
4
4
5## Opzet
5## Eén repository en releasepakketten (16-11-2026)
6
7- **bluegit-backup in timfa/bluegit**: met history samengevoegd (git filter-repo, daarna een merge). `internal/*` van de backup server staat in `internal/backupserver/*`, de integratietests in `internal/backupserver/integration`, de packaging in `packaging/backup` en `packaging/aur-backup`, de README in `docs/BACKUP-SERVER.md` en het protocol in `docs/BACKUP-PROTOCOL.md`. Deze aannames kwamen ook uit die repository. `scripts/build-bluegit.sh` en `.bluegit-ref` zijn vervallen: de integratietests bouwen BlueGit in `TestMain` uit dezelfde checkout.
8- De twee protocolpakketten (`internal/backup` aan de BlueGit-kant en `internal/backupserver/protocol`) blijven apart. Zo kunnen de integratietests een oudere of nieuwere kant nabootsen.
9- **AUR**: `bluegit-backup` gaat vanaf master via `publish_aur_backup` met dezelfde AUR-geheimen als `bluegit` en `bluegit-runner`, en hangt ook af van `backup_integration`. De pkgver blijft de commit-tijd in UTC, dus het versienummer loopt door.
10- **Pakketten**: nfpm (v2.43.0, vastgezet) maakt .deb, .rpm en .pkg.tar.zst voor amd64 en arm64. Inhoud, unit, gebruiker en config komen uit de PKGBUILDs. Het Arch-pakket heeft net als de AUR `docker` als dependency voor bluegit en bluegit-runner. Bij deb en rpm is docker alleen een aanbeveling, omdat de pakketnaam per distro verschilt (docker.io, docker-ce, moby-engine). De rpm's hangen af van `shadow-utils` voor useradd.
11- De pakketten maken de gebruiker met systemd-sysusers, of met groupadd/useradd als dat er niet is (kale containers). Ze zetten de service niet aan en herstarten hem alleen als hij al draaide. Verwijderen zet de service uit en laat gebruiker, config en `/var/lib/<naam>` staan.
12- `bluegit-update` (de self-update via makepkg/pacman) en de gebruiker `bluegit-build` zitten alleen in het AUR-pakket.
13- **Bestandsnamen** in de release hebben geen versie (`bluegit_amd64.deb`, `bluegit.x86_64.rpm`, `bluegit-x86_64.pkg.tar.zst`), zodat de artifact-paden vast zijn en `SHA256SUMS` er precies bij past. De versie staat in het pakket zelf: tag `v1.2.3` wordt `1.2.3-1`, en `v1.0.0-rc1` wordt `1.0.0.rc1`, omdat archlinux geen `-` in pkgver toestaat. Builds zonder tag krijgen `0.0.0.git<sha>`.
14- `--version` (ook `version`) toont `main.version` of `server.Version`: de tag bij een release, de korte sha op andere pipelines en `dev` zonder ldflag (AUR en self-update).
15- De installatietest draait alleen voor amd64. De arm64-pakketten worden wel gebouwd, maar de runner heeft geen arm64.
16- Package-artifacts blijven 3 dagen bewaard, omdat ze groot zijn (ongeveer 200 MB per pipeline). De release kopieert ze meteen.
17- **Release**: alleen bij een tag `v*`, via het create-only endpoint `POST …/releases/{tag}/assets`, en alleen als vet, test, frontend_checks, backup_integration, package en alle vijf installatietests slagen. Het tagpatroon `v*` is beschermd.
18
19## Backup server (uit timfa/bluegit-backup)
20
21### Opzet
6
22
7- **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.
23- **Go**, net als BlueGit. Eén binary zonder CGO. De enige externe dependency is `gopkg.in/yaml.v3`.
8- Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.
24- Eén backup server hoort bij precies één BlueGit. Dat staat in `data_dir/state.json` (0600). Daar staat ook de key in, want die is nodig om op te halen en om meldingen te controleren.
9
25
10## Webinterface en API
26### Webinterface en API
11
27
12- De webinterface draait op hetzelfde adres als de API, standaard `0.0.0.0:8080`. Er komt geen aparte poort voor BlueGit: BlueGit praat met dezelfde server (ondertekend).
28- De webinterface draait op hetzelfde adres als de API, standaard `0.0.0.0:8080`. Er komt geen aparte poort voor BlueGit: BlueGit praat met dezelfde server (ondertekend).
13- **Inloggen gaat met het beheertoken** uit `data_dir/admin.token` (`bba_…`, 0600). Dat token gebruiken ook de API en de CLI. Er komt geen apart gebruikersbeheer: de backup server heeft één beheerder. `bluegit-backup token` toont het token.
29- **Inloggen gaat met het beheertoken** uit `data_dir/admin.token` (`bba_…`, 0600). Dat token gebruiken ook de API en de CLI. Er komt geen apart gebruikersbeheer: de backup server heeft één beheerder. `bluegit-backup token` toont het token.
@@ -17,7 +33,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
17- In de webinterface kun je ook een rollback starten en een archief downloaden of verwijderen. De rollback heeft dezelfde waarschuwing en bevestiging als in BlueGit.
33- In de webinterface kun je ook een rollback starten en een archief downloaden of verwijderen. De rollback heeft dezelfde waarschuwing en bevestiging als in BlueGit.
18- De webinterface is gewone HTML zonder JavaScript, in het Nederlands. Hij weigert framing (`X-Frame-Options: DENY`). Daarom bedient BlueGit de backup server via de API en niet met een iframe.
34- De webinterface is gewone HTML zonder JavaScript, in het Nederlands. Hij weigert framing (`X-Frame-Options: DENY`). Daarom bedient BlueGit de backup server via de API en niet met een iframe.
19
35
20## Bediening vanuit BlueGit
36### Bediening vanuit BlueGit
21
37
22- Tim gaf de keuze tussen een iframe of een API-koppeling met een vergelijkbare interface. Ik koos de **API-koppeling**:
38- Tim gaf de keuze tussen een iframe of een API-koppeling met een vergelijkbare interface. Ik koos de **API-koppeling**:
23 - Een iframe zou een tweede login vragen.
39 - Een iframe zou een tweede login vragen.
@@ -30,7 +46,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
30- De instellingen in BlueGit tonen de labels en uitleg van de backup server, dus in het Nederlands. Wat BlueGit er zelf omheen zet, is vertaald (en, nl, de, fr).
46- De instellingen in BlueGit tonen de labels en uitleg van de backup server, dus in het Nederlands. Wat BlueGit er zelf omheen zet, is vertaald (en, nl, de, fr).
31- Verwijdert een beheerder een backup server in BlueGit, dan vraagt BlueGit de backup server eerst om te ontkoppelen. De kopie en de archieven blijven op de backup server staan.
47- Verwijdert een beheerder een backup server in BlueGit, dan vraagt BlueGit de backup server eerst om te ontkoppelen. De kopie en de archieven blijven op de backup server staan.
32
48
33## Meerdere backup servers
49### Meerdere backup servers
34
50
35- Eén BlueGit kan tot **16** backup servers hebben, elk met een eigen naam en key. Dat zijn er genoeg voor een paar plekken (bijvoorbeeld thuis en offsite), en het begrenst het aantal meldingen per wijziging.
51- Eén BlueGit kan tot **16** backup servers hebben, elk met een eigen naam en key. Dat zijn er genoeg voor een paar plekken (bijvoorbeeld thuis en offsite), en het begrenst het aantal meldingen per wijziging.
36- Elke backup server krijgt elke melding, parallel. Een server die niet reageert, houdt de andere niet op.
52- Elke backup server krijgt elke melding, parallel. Een server die niet reageert, houdt de andere niet op.
@@ -38,7 +54,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
38- Koppelt een tweede backup server met dezelfde key, dan gaat de koppeling (het adres voor meldingen) naar die server. Een key hoort bij één server. Geef een nieuwe server een eigen key.
54- Koppelt een tweede backup server met dezelfde key, dan gaat de koppeling (het adres voor meldingen) naar die server. Een key hoort bij één server. Geef een nieuwe server een eigen key.
39- `backup.json` bevat nu een lijst met servers. De oude vorm met één koppeling wordt bij het lezen omgezet.
55- `backup.json` bevat nu een lijst met servers. De oude vorm met één koppeling wordt bij het lezen omgezet.
40
56
41## Key en authenticatie
57### Key en authenticatie
42
58
43- BlueGit maakt per backup server een Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
59- BlueGit maakt per backup server een Backupserver-Key (`bgbk_` + 64 hex) onder *Beheer → Backup* en toont hem één keer. BlueGit bewaart alleen `sha256(key)`.
44- Een nieuwe key voor een server maakt zijn oude key ongeldig. Verwijderen ontkoppelt die server.
60- Een nieuwe key voor een server maakt zijn oude key ongeldig. Verwijderen ontkoppelt die server.
@@ -47,7 +63,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
47- De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.
63- De koppeling in BlueGit (`<state>/backup.json`) zit **niet** in de backup. Een rollback zet de koppeling dus niet terug naar een oude key.
48- Je koppelt in de webinterface, met de API, of met `bluegit-backup connect --url …` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
64- Je koppelt in de webinterface, met de API, of met `bluegit-backup connect --url …` en de key uit `BLUEGIT_BACKUP_KEY` (of `--key`). De server meldt BlueGit daarna zijn `public_url`, zodat BlueGit weet waar de meldingen heen moeten.
49
65
50## Wat wordt geback-upt
66### Wat wordt geback-upt
51
67
52- Alles wat BlueGit nodig heeft om identiek terug te komen:
68- Alles wat BlueGit nodig heeft om identiek terug te komen:
53 - de database (`bluegit.db`) als consistente snapshot via `VACUUM INTO`
69 - de database (`bluegit.db`) als consistente snapshot via `VACUUM INTO`
@@ -62,7 +78,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
62 - de backupkoppeling en het instance-id
78 - de backupkoppeling en het instance-id
63- "Configuratie" in de opdracht lees ik als: alle instellingen die BlueGit in zijn database en state-map bewaart, plus de sleutels. `config.yml` valt daar niet onder.
79- "Configuratie" in de opdracht lees ik als: alle instellingen die BlueGit in zijn database en state-map bewaart, plus de sleutels. `config.yml` valt daar niet onder.
64
80
65## Meldingen en synchroniseren
81### Meldingen en synchroniseren
66
82
67- BlueGit meldt een wijziging na elk muterend verzoek: elke niet-GET, behalve de backup-API zelf en `git-upload-pack` (clonen en fetchen). Daarnaast meldt BlueGit na elke push (HTTP en SSH) en na elk intern event, zoals CI of releases.
83- BlueGit meldt een wijziging na elk muterend verzoek: elke niet-GET, behalve de backup-API zelf en `git-upload-pack` (clonen en fetchen). Daarnaast meldt BlueGit na elke push (HTTP en SSH) en na elk intern event, zoals CI of releases.
68- Meldingen worden 2 seconden gebundeld en tot 4 keer opnieuw geprobeerd. Een melding bevat geen data, alleen "er is iets veranderd" (`POST /api/v1/notify`).
84- Meldingen worden 2 seconden gebundeld en tot 4 keer opnieuw geprobeerd. Een melding bevat geen data, alleen "er is iets veranderd" (`POST /api/v1/notify`).
@@ -71,13 +87,13 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
71- Mist de server een melding (omdat hij uit stond of het netwerk weg was), dan vangt de volledige controle elk `full_sync_interval` (1u) dat op, en ook een herstart.
87- Mist de server een melding (omdat hij uit stond of het netwerk weg was), dan vangt de volledige controle elk `full_sync_interval` (1u) dat op, en ook een herstart.
72- Een bestand dat tijdens het downloaden verandert (grootte klopt niet), wordt bij de volgende sync opnieuw opgehaald.
88- Een bestand dat tijdens het downloaden verandert (grootte klopt niet), wordt bij de volgende sync opnieuw opgehaald.
73
89
74## Gedoseerd downloaden
90### Gedoseerd downloaden
75
91
76- Een token bucket begrenst de downloadsnelheid tot `rate_limit_kib` KiB/s (standaard 1024, dus 1 MiB/s), over alle downloads samen.
92- Een token bucket begrenst de downloadsnelheid tot `rate_limit_kib` KiB/s (standaard 1024, dus 1 MiB/s), over alle downloads samen.
77- Er is altijd maar één download tegelijk. BlueGit krijgt dus nooit meer dan één verzoek tegelijk van de backup server.
93- Er is altijd maar één download tegelijk. BlueGit krijgt dus nooit meer dan één verzoek tegelijk van de backup server.
78- De database-snapshot kost BlueGit eenmalig een `VACUUM INTO` per manifest. Bij een grote database is dat het zwaarste deel, maar het blokkeert schrijvers in WAL-modus niet.
94- De database-snapshot kost BlueGit eenmalig een `VACUUM INTO` per manifest. Bij een grote database is dat het zwaarste deel, maar het blokkeert schrijvers in WAL-modus niet.
79
95
80## Archieven
96### Archieven
81
97
82- Formaat: `tar.gz` (PAX), met de lopende kopie als inhoud (`state/…` en `data/…`). Je kunt een archief dus ook met de hand uitpakken.
98- Formaat: `tar.gz` (PAX), met de lopende kopie als inhoud (`state/…` en `data/…`). Je kunt een archief dus ook met de hand uitpakken.
83- Naam: `bluegit-YYYYMMDD-HHMMSS.tar.gz` in UTC, met `-2`, `-3`, … als er in dezelfde seconde meer zijn.
99- Naam: `bluegit-YYYYMMDD-HHMMSS.tar.gz` in UTC, met `-2`, `-3`, … als er in dezelfde seconde meer zijn.
@@ -89,7 +105,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
89 - Het nieuwste archief blijft altijd staan, ook als het te oud is. Anders zou er geen backup meer zijn.
105 - Het nieuwste archief blijft altijd staan, ook als het te oud is. Anders zou er geen backup meer zijn.
90 - Is er vóór een nieuw archief niet genoeg ruimte, dan mogen alle oude archieven weg om plaats te maken. Het nieuwe archief wordt dan het enige.
106 - Is er vóór een nieuw archief niet genoeg ruimte, dan mogen alle oude archieven weg om plaats te maken. Het nieuwe archief wordt dan het enige.
91
107
92## Rollback
108### Rollback
93
109
94- De beheerder start de rollback in BlueGit onder *Beheer → Backup*. Daar staat een grote rode waarschuwing: "Dit kan niet ongedaan worden gemaakt". Er moet een vinkje gezet worden en de archiefnaam overgetypt. De API vraagt `"confirm": "<archiefnaam>"`.
110- De beheerder start de rollback in BlueGit onder *Beheer → Backup*. Daar staat een grote rode waarschuwing: "Dit kan niet ongedaan worden gemaakt". Er moet een vinkje gezet worden en de archiefnaam overgetypt. De API vraagt `"confirm": "<archiefnaam>"`.
95- Het verloop:
111- Het verloop:
@@ -102,7 +118,7 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
102- Archieven die nieuwer zijn dan het teruggezette archief blijven bewaard. Een rollback naar een te oud archief is zo nog te herstellen met een nieuwere rollback, maar alleen voor wat er in die archieven zat.
118- Archieven die nieuwer zijn dan het teruggezette archief blijven bewaard. Een rollback naar een te oud archief is zo nog te herstellen met een nieuwere rollback, maar alleen voor wat er in die archieven zat.
103- Het upload-verkeer naar BlueGit bij een rollback is **niet** gedoseerd. BlueGit staat dan toch al stil, en een snelle terugzet is belangrijker.
119- Het upload-verkeer naar BlueGit bij een rollback is **niet** gedoseerd. BlueGit staat dan toch al stil, en een snelle terugzet is belangrijker.
104
120
105## Nieuwe instantie
121### Nieuwe instantie
106
122
107- Een BlueGit wordt herkend aan zijn `instance_id` (`<state>/instance_id`). Een andere URL met hetzelfde instance-id is dezelfde instantie, bijvoorbeeld na een verhuizing.
123- Een BlueGit wordt herkend aan zijn `instance_id` (`<state>/instance_id`). Een andere URL met hetzelfde instance-id is dezelfde instantie, bijvoorbeeld na een verhuizing.
108- Koppel je een andere instantie, dan weigert de server (`409`) en moet je kiezen:
124- Koppel je een andere instantie, dan weigert de server (`409`) en moet je kiezen:
@@ -111,7 +127,7 @@ 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`.
127- `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.
128- De nieuwe BlueGit moet al draaien met een eigen `config.yml` en data-schijf. Het herstel vult alleen de inhoud.
113
129
114## Compatibiliteit (t1209u)
130### Compatibiliteit (t1209u)
115
131
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.
132- 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`.
133- 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`.
@@ -125,7 +141,9 @@ Deze keuzes heb ik gemaakt waar de opdracht niets vastlegde. Wil je iets anders,
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`.
141- **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.
142- **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
143
128## Releases en tests
144### Releases en tests
145
146Tot 16-11-2026, toen dit nog een aparte repository was. Wat er sindsdien geldt, staat bovenaan.
129
147
130- "Dezelfde release-opties als BlueGit" betekent:
148- "Dezelfde release-opties als BlueGit" betekent:
131 - een AUR-pakket `bluegit-backup` dat vanaf master wordt bijgewerkt
149 - een AUR-pakket `bluegit-backup` dat vanaf master wordt bijgewerkt
docs/AUR.md +2 −0
@@ -2,6 +2,8 @@
2 2
3 3 Elke push naar `master` werkt `packaging/aur/PKGBUILD` bij en pusht die naar `ssh://aur@aur.archlinux.org/bluegit.git` (branch `master`; AUR accepteert niets anders). De aanpak en de geheimnamen zijn dezelfde als in Posprint. Posprint publiceert bij een tag; BlueGit doet het bij elke commit op `master`, omdat er geen vaste versietag is.
4 4
5 Dezelfde pipeline publiceert ook `bluegit-runner` (`packaging/aur-runner`, job `publish_aur_runner`) en sinds 16-11-2026 `bluegit-backup` (`packaging/aur-backup`, job `publish_aur_backup`, voorheen uit timfa/bluegit-backup). `scripts/publish-aur.sh` kiest het pakket met `AUR_PKG`. Alle drie halen hun bron uit het archief van timfa/bluegit. Pakketten voor andere distro's (deb, rpm) staan bij de releases, zie de README.
6
5 7 ## Package
6 8
7 9 Er is één source-package, `bluegit`. Geen `-bin`. De PKGBUILD haalt het archief van BlueGit op, op de commit-sha:
@@ -2,6 +2,8 @@
2
2
3Elke push naar `master` werkt `packaging/aur/PKGBUILD` bij en pusht die naar `ssh://aur@aur.archlinux.org/bluegit.git` (branch `master`; AUR accepteert niets anders). De aanpak en de geheimnamen zijn dezelfde als in Posprint. Posprint publiceert bij een tag; BlueGit doet het bij elke commit op `master`, omdat er geen vaste versietag is.
3Elke push naar `master` werkt `packaging/aur/PKGBUILD` bij en pusht die naar `ssh://aur@aur.archlinux.org/bluegit.git` (branch `master`; AUR accepteert niets anders). De aanpak en de geheimnamen zijn dezelfde als in Posprint. Posprint publiceert bij een tag; BlueGit doet het bij elke commit op `master`, omdat er geen vaste versietag is.
4
4
5Dezelfde pipeline publiceert ook `bluegit-runner` (`packaging/aur-runner`, job `publish_aur_runner`) en sinds 16-11-2026 `bluegit-backup` (`packaging/aur-backup`, job `publish_aur_backup`, voorheen uit timfa/bluegit-backup). `scripts/publish-aur.sh` kiest het pakket met `AUR_PKG`. Alle drie halen hun bron uit het archief van timfa/bluegit. Pakketten voor andere distro's (deb, rpm) staan bij de releases, zie de README.
6
5## Package
7## Package
6
8
7Er is één source-package, `bluegit`. Geen `-bin`. De PKGBUILD haalt het archief van BlueGit op, op de commit-sha:
9Er is één source-package, `bluegit`. Geen `-bin`. De PKGBUILD haalt het archief van BlueGit op, op de commit-sha:
docs/BACKUP-SERVER.md +8 −9
@@ -147,21 +147,20 @@ In `data_dir`:
147 147
148 148 ## Releases
149 149
150 Een AUR-pakket (`bluegit-backup`, bijgewerkt vanaf master) en binaries bij een tag. Zie `blue-ci-cd.yml`.
150 Sinds 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`.
151 151
152 - Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit (`scripts/build-bluegit.sh`, ref in `.bluegit-ref`), start hem, configureert hem en test daarmee elke feature. Faalt er één test, dan is er geen release.
153 - Releases vanaf master staan pas aan zodra het bestand `.release-enabled` in de repository staat. De geheimen staan in de kop van `blue-ci-cd.yml`.
154 - Een release bij een tag (`v*`) publiceert de binaries bij een bestaande tag.
155 - Eerste release: [v0.1.0](https://git.timfalken.com/timfa/bluegit-backup/-/releases) (linux amd64/arm64 en `SHA256SUMS`).
152 - 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.
153 - 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`.
154 - 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.
155 - De oude release v0.1.0 kwam uit timfa/bluegit-backup.
156 156
157 Updaten doe je zelf: met je AUR-helper (bijvoorbeeld `yay -Syu bluegit-backup`) of met een nieuwe binary van de releasepagina. Er is geen self-update.
157 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.
158 158
159 159 ## Tests
160 160
161 161 ```sh
162 go test ./... # unit-tests
163 ./scripts/build-bluegit.sh # bouwt .bluegit-bin/bluegit
164 BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/
162 go test ./internal/backupserver/... # unit-tests
163 go test -tags integration -v ./internal/backupserver/integration/ # bouwt BlueGit uit deze checkout
165 164 ```
166 165
167 166 Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.
@@ -147,21 +147,20 @@ In `data_dir`:
147
147
148## Releases
148## Releases
149
149
150Een AUR-pakket (`bluegit-backup`, bijgewerkt vanaf master) en binaries bij een tag. Zie `blue-ci-cd.yml`.
150Sinds 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`.
151
151
152- Elke release-job hangt af van de job `integration`. Die bouwt een echte BlueGit (`scripts/build-bluegit.sh`, ref in `.bluegit-ref`), start hem, configureert hem en test daarmee elke feature. Faalt er één test, dan is er geen release.
152- 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.
153- Releases vanaf master staan pas aan zodra het bestand `.release-enabled` in de repository staat. De geheimen staan in de kop van `blue-ci-cd.yml`.
153- 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`.
154- Een release bij een tag (`v*`) publiceert de binaries bij een bestaande tag.
154- 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.
155- Eerste release: [v0.1.0](https://git.timfalken.com/timfa/bluegit-backup/-/releases) (linux amd64/arm64 en `SHA256SUMS`).
155- De oude release v0.1.0 kwam uit timfa/bluegit-backup.
156
156
157Updaten doe je zelf: met je AUR-helper (bijvoorbeeld `yay -Syu bluegit-backup`) of met een nieuwe binary van de releasepagina. Er is geen self-update.
157Updaten 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.
158
158
159## Tests
159## Tests
160
160
161```sh
161```sh
162go test ./... # unit-tests
162go test ./internal/backupserver/... # unit-tests
163./scripts/build-bluegit.sh # bouwt .bluegit-bin/bluegit
163go test -tags integration -v ./internal/backupserver/integration/ # bouwt BlueGit uit deze checkout
164BLUEGIT_BIN=$PWD/.bluegit-bin/bluegit go test -tags integration -v ./integration/
165```
164```
166
165
167Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.
166Daarnaast controleren unit-tests dat elke wijzigende actie een formulier in de webinterface heeft, en elk formulier een API-actie.
docs/BACKUP.md +2 −2
@@ -1,6 +1,6 @@
1 1 # Backup servers (bluegit-backup)
2 2
3 Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
3 Een losse backup server (`bluegit-backup`, in deze repository: `cmd/bluegit-backup`, zie [BACKUP-SERVER.md](BACKUP-SERVER.md)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
4 4
5 5 Eén BlueGit kan meerdere backup servers hebben (hoogstens 16), elk met een eigen Backupserver-Key. Een backup server hoort bij één BlueGit.
6 6
@@ -79,7 +79,7 @@ Wat er gebeurt als ze niet passen:
79 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 80 - Na een update van de verouderde kant herstelt alles vanzelf bij het volgende contact.
81 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).
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 in `internal/backupserver/integration` doen dat zelf in hun `TestMain`).
83 83
84 84 ## Wat er in een backup zit
85 85
@@ -1,6 +1,6 @@
1# Backup servers (bluegit-backup)
1# Backup servers (bluegit-backup)
2
2
3Een losse backup server ([timfa/bluegit-backup](https://git.timfalken.com/timfa/bluegit-backup)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
3Een losse backup server (`bluegit-backup`, in deze repository: `cmd/bluegit-backup`, zie [BACKUP-SERVER.md](BACKUP-SERVER.md)) houdt een kopie bij van alle gegevens en configuratie van één BlueGit. Hij haalt ze langzaam op, krijgt na elke wijziging een melding, maakt periodiek een gecomprimeerd archief, en kan BlueGit naar zo'n archief terugzetten.
4
4
5Eén BlueGit kan meerdere backup servers hebben (hoogstens 16), elk met een eigen Backupserver-Key. Een backup server hoort bij één BlueGit.
5Eén BlueGit kan meerdere backup servers hebben (hoogstens 16), elk met een eigen Backupserver-Key. Een backup server hoort bij één BlueGit.
6
6
@@ -79,7 +79,7 @@ Wat er gebeurt als ze niet passen:
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`.
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.
80- Na een update van de verouderde kant herstelt alles vanzelf bij het volgende contact.
81
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).
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 in `internal/backupserver/integration` doen dat zelf in hun `TestMain`).
83
83
84## Wat er in een backup zit
84## Wat er in een backup zit
85
85
internal/ci/example_test.go +20 −6
@@ -19,7 +19,7 @@ func TestBlueGitExampleFile(t *testing.T) {
19 19 if len(p.Warnings) != 0 {
20 20 t.Fatalf("warnings %v", p.Warnings)
21 21 }
22 if len(p.Jobs) != 7 {
22 if len(p.Jobs) != 17 {
23 23 t.Fatalf("jobs %d", len(p.Jobs))
24 24 }
25 25 by := map[string]Job{}
@@ -53,7 +53,7 @@ func TestBlueGitExampleFile(t *testing.T) {
53 53 if err != nil {
54 54 t.Fatal(err)
55 55 }
56 if names := jobNames(feature); names != "build,frontend_checks,test,vet" {
56 if names := jobNames(feature); names != "backup_integration,binaries,build,frontend_checks,package,package_arch,package_debian,package_fedora,package_rocky,package_ubuntu,test,vet" {
57 57 t.Fatalf("feature %s", names)
58 58 }
59 59 mr, err := p.ActiveJobs(map[string]string{
@@ -62,7 +62,7 @@ func TestBlueGitExampleFile(t *testing.T) {
62 62 if err != nil {
63 63 t.Fatal(err)
64 64 }
65 if names := jobNames(mr); names != "build,frontend_checks,test,vet" {
65 if names := jobNames(mr); names != "backup_integration,binaries,build,frontend_checks,package,package_arch,package_debian,package_fedora,package_rocky,package_ubuntu,test,vet" {
66 66 t.Fatalf("merge request %s", names)
67 67 }
68 68 tag, err := p.ActiveJobs(map[string]string{
@@ -71,20 +71,20 @@ func TestBlueGitExampleFile(t *testing.T) {
71 71 if err != nil {
72 72 t.Fatal(err)
73 73 }
74 if names := jobNames(tag); names != "build,frontend_checks,test,vet" {
74 if names := jobNames(tag); names != "backup_integration,binaries,build,frontend_checks,package,package_arch,package_debian,package_fedora,package_rocky,package_ubuntu,release_packages,test,vet" {
75 75 t.Fatalf("tag %s", names)
76 76 }
77 77 web, err := p.ActiveJobs(map[string]string{
78 78 "CI_COMMIT_BRANCH": "master", "CI_PIPELINE_SOURCE": "web",
79 79 })
80 if err != nil || len(web) != 7 {
80 if err != nil || len(web) != 16 {
81 81 t.Fatalf("web op master %d %v", len(web), err)
82 82 }
83 83
84 84 active, err := p.ActiveJobs(map[string]string{
85 85 "CI_COMMIT_BRANCH": "master", "CI_PIPELINE_SOURCE": "push",
86 86 })
87 if err != nil || len(active) != 7 {
87 if err != nil || len(active) != 16 {
88 88 t.Fatalf("master %d %v", len(active), err)
89 89 }
90 90 aur := by["publish_aur"]
@@ -112,6 +112,20 @@ func TestBlueGitExampleFile(t *testing.T) {
112 112 !strings.Contains(strings.Join(runnerAUR.Script, "\n"), "AUR_PKG=bluegit-runner ./scripts/publish-aur.sh") {
113 113 t.Fatalf("publish_aur_runner: %+v", runnerAUR)
114 114 }
115 backupAUR := by["publish_aur_backup"]
116 if !backupAUR.AllowFailure || strings.Join(backupAUR.Needs, ",") != "build,backup_integration" ||
117 !strings.Contains(strings.Join(backupAUR.Script, "\n"), "AUR_PKG=bluegit-backup ./scripts/publish-aur.sh") {
118 t.Fatalf("publish_aur_backup: %+v", backupAUR)
119 }
120 rel := by["release_packages"]
121 for _, n := range []string{"vet", "test", "frontend_checks", "backup_integration", "package", "package_ubuntu", "package_debian", "package_rocky", "package_fedora", "package_arch"} {
122 if !contains(rel.Needs, n) {
123 t.Fatalf("release_packages wacht niet op %s: %v", n, rel.Needs)
124 }
125 }
126 if joined := strings.Join(rel.Script, "\n"); !strings.Contains(joined, "/releases/$CI_COMMIT_TAG/assets") {
127 t.Fatalf("release_packages gebruikt het create-only endpoint niet: %s", joined)
128 }
115 129 upd := by["self_update"]
116 130 if !upd.NeedsSet || len(upd.Needs) != 2 || upd.Needs[0] != "publish_aur" || upd.Needs[1] != "publish_aur_runner" {
117 131 t.Fatalf("self_update hoort op publish_aur te wachten: %+v", upd)
@@ -19,7 +19,7 @@ func TestBlueGitExampleFile(t *testing.T) {
19 if len(p.Warnings) != 0 {
19 if len(p.Warnings) != 0 {
20 t.Fatalf("warnings %v", p.Warnings)
20 t.Fatalf("warnings %v", p.Warnings)
21 }
21 }
22 if len(p.Jobs) != 7 {
22 if len(p.Jobs) != 17 {
23 t.Fatalf("jobs %d", len(p.Jobs))
23 t.Fatalf("jobs %d", len(p.Jobs))
24 }
24 }
25 by := map[string]Job{}
25 by := map[string]Job{}
@@ -53,7 +53,7 @@ func TestBlueGitExampleFile(t *testing.T) {
53 if err != nil {
53 if err != nil {
54 t.Fatal(err)
54 t.Fatal(err)
55 }
55 }
56 if names := jobNames(feature); names != "build,frontend_checks,test,vet" {
56 if names := jobNames(feature); names != "backup_integration,binaries,build,frontend_checks,package,package_arch,package_debian,package_fedora,package_rocky,package_ubuntu,test,vet" {
57 t.Fatalf("feature %s", names)
57 t.Fatalf("feature %s", names)
58 }
58 }
59 mr, err := p.ActiveJobs(map[string]string{
59 mr, err := p.ActiveJobs(map[string]string{
@@ -62,7 +62,7 @@ func TestBlueGitExampleFile(t *testing.T) {
62 if err != nil {
62 if err != nil {
63 t.Fatal(err)
63 t.Fatal(err)
64 }
64 }
65 if names := jobNames(mr); names != "build,frontend_checks,test,vet" {
65 if names := jobNames(mr); names != "backup_integration,binaries,build,frontend_checks,package,package_arch,package_debian,package_fedora,package_rocky,package_ubuntu,test,vet" {
66 t.Fatalf("merge request %s", names)
66 t.Fatalf("merge request %s", names)
67 }
67 }
68 tag, err := p.ActiveJobs(map[string]string{
68 tag, err := p.ActiveJobs(map[string]string{
@@ -71,20 +71,20 @@ func TestBlueGitExampleFile(t *testing.T) {
71 if err != nil {
71 if err != nil {
72 t.Fatal(err)
72 t.Fatal(err)
73 }
73 }
74 if names := jobNames(tag); names != "build,frontend_checks,test,vet" {
74 if names := jobNames(tag); names != "backup_integration,binaries,build,frontend_checks,package,package_arch,package_debian,package_fedora,package_rocky,package_ubuntu,release_packages,test,vet" {
75 t.Fatalf("tag %s", names)
75 t.Fatalf("tag %s", names)
76 }
76 }
77 web, err := p.ActiveJobs(map[string]string{
77 web, err := p.ActiveJobs(map[string]string{
78 "CI_COMMIT_BRANCH": "master", "CI_PIPELINE_SOURCE": "web",
78 "CI_COMMIT_BRANCH": "master", "CI_PIPELINE_SOURCE": "web",
79 })
79 })
80 if err != nil || len(web) != 7 {
80 if err != nil || len(web) != 16 {
81 t.Fatalf("web op master %d %v", len(web), err)
81 t.Fatalf("web op master %d %v", len(web), err)
82 }
82 }
83
83
84 active, err := p.ActiveJobs(map[string]string{
84 active, err := p.ActiveJobs(map[string]string{
85 "CI_COMMIT_BRANCH": "master", "CI_PIPELINE_SOURCE": "push",
85 "CI_COMMIT_BRANCH": "master", "CI_PIPELINE_SOURCE": "push",
86 })
86 })
87 if err != nil || len(active) != 7 {
87 if err != nil || len(active) != 16 {
88 t.Fatalf("master %d %v", len(active), err)
88 t.Fatalf("master %d %v", len(active), err)
89 }
89 }
90 aur := by["publish_aur"]
90 aur := by["publish_aur"]
@@ -112,6 +112,20 @@ func TestBlueGitExampleFile(t *testing.T) {
112 !strings.Contains(strings.Join(runnerAUR.Script, "\n"), "AUR_PKG=bluegit-runner ./scripts/publish-aur.sh") {
112 !strings.Contains(strings.Join(runnerAUR.Script, "\n"), "AUR_PKG=bluegit-runner ./scripts/publish-aur.sh") {
113 t.Fatalf("publish_aur_runner: %+v", runnerAUR)
113 t.Fatalf("publish_aur_runner: %+v", runnerAUR)
114 }
114 }
115 backupAUR := by["publish_aur_backup"]
116 if !backupAUR.AllowFailure || strings.Join(backupAUR.Needs, ",") != "build,backup_integration" ||
117 !strings.Contains(strings.Join(backupAUR.Script, "\n"), "AUR_PKG=bluegit-backup ./scripts/publish-aur.sh") {
118 t.Fatalf("publish_aur_backup: %+v", backupAUR)
119 }
120 rel := by["release_packages"]
121 for _, n := range []string{"vet", "test", "frontend_checks", "backup_integration", "package", "package_ubuntu", "package_debian", "package_rocky", "package_fedora", "package_arch"} {
122 if !contains(rel.Needs, n) {
123 t.Fatalf("release_packages wacht niet op %s: %v", n, rel.Needs)
124 }
125 }
126 if joined := strings.Join(rel.Script, "\n"); !strings.Contains(joined, "/releases/$CI_COMMIT_TAG/assets") {
127 t.Fatalf("release_packages gebruikt het create-only endpoint niet: %s", joined)
128 }
115 upd := by["self_update"]
129 upd := by["self_update"]
116 if !upd.NeedsSet || len(upd.Needs) != 2 || upd.Needs[0] != "publish_aur" || upd.Needs[1] != "publish_aur_runner" {
130 if !upd.NeedsSet || len(upd.Needs) != 2 || upd.Needs[0] != "publish_aur" || upd.Needs[1] != "publish_aur_runner" {
117 t.Fatalf("self_update hoort op publish_aur te wachten: %+v", upd)
131 t.Fatalf("self_update hoort op publish_aur te wachten: %+v", upd)
packaging/nfpm/bluegit-backup.postinstall.sh added +25 −0
@@ -0,0 +1,25 @@
1 #!/bin/sh
2 # Na installeren of bijwerken (deb, rpm en archlinux). Maakt de gebruiker
3 # bluegit-backup en /var/lib/bluegit-backup, zoals sysusers.d en tmpfiles.d. Zonder
4 # systemd-sysusers (een kale container) doen useradd en install het.
5 # De service wordt niet aangezet; een draaiende service herstart.
6 set -e
7 if command -v systemd-sysusers >/dev/null 2>&1; then
8 systemd-sysusers /usr/lib/sysusers.d/bluegit-backup.conf || true
9 fi
10 if ! getent group bluegit-backup >/dev/null 2>&1; then
11 groupadd --system bluegit-backup
12 fi
13 if ! getent passwd bluegit-backup >/dev/null 2>&1; then
14 useradd --system --gid bluegit-backup --home-dir /var/lib/bluegit-backup --no-create-home \
15 --shell /usr/sbin/nologin --comment "BlueGit backup server" bluegit-backup
16 fi
17 if command -v systemd-tmpfiles >/dev/null 2>&1; then
18 systemd-tmpfiles --create /usr/lib/tmpfiles.d/bluegit-backup.conf || true
19 fi
20 install -d -m 0750 -o bluegit-backup -g bluegit-backup /var/lib/bluegit-backup
21 if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
22 systemctl daemon-reload || true
23 systemctl try-restart bluegit-backup.service || true
24 fi
25 exit 0
@@ -0,0 +1,25 @@
1#!/bin/sh
2# Na installeren of bijwerken (deb, rpm en archlinux). Maakt de gebruiker
3# bluegit-backup en /var/lib/bluegit-backup, zoals sysusers.d en tmpfiles.d. Zonder
4# systemd-sysusers (een kale container) doen useradd en install het.
5# De service wordt niet aangezet; een draaiende service herstart.
6set -e
7if command -v systemd-sysusers >/dev/null 2>&1; then
8 systemd-sysusers /usr/lib/sysusers.d/bluegit-backup.conf || true
9fi
10if ! getent group bluegit-backup >/dev/null 2>&1; then
11 groupadd --system bluegit-backup
12fi
13if ! getent passwd bluegit-backup >/dev/null 2>&1; then
14 useradd --system --gid bluegit-backup --home-dir /var/lib/bluegit-backup --no-create-home \
15 --shell /usr/sbin/nologin --comment "BlueGit backup server" bluegit-backup
16fi
17if command -v systemd-tmpfiles >/dev/null 2>&1; then
18 systemd-tmpfiles --create /usr/lib/tmpfiles.d/bluegit-backup.conf || true
19fi
20install -d -m 0750 -o bluegit-backup -g bluegit-backup /var/lib/bluegit-backup
21if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
22 systemctl daemon-reload || true
23 systemctl try-restart bluegit-backup.service || true
24fi
25exit 0
packaging/nfpm/bluegit-backup.preremove.sh added +11 −0
@@ -0,0 +1,11 @@
1 #!/bin/sh
2 # Vóór verwijderen. Bij een upgrade (deb: upgrade, rpm: 1 of hoger) niets
3 # doen. archlinux roept dit alleen bij verwijderen aan ($1 is dan de versie).
4 # Gebruiker, config en /var/lib/bluegit-backup blijven staan.
5 case "$1" in
6 upgrade|failed-upgrade|[1-9]) exit 0 ;;
7 esac
8 if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
9 systemctl disable --now bluegit-backup.service >/dev/null 2>&1 || true
10 fi
11 exit 0
@@ -0,0 +1,11 @@
1#!/bin/sh
2# Vóór verwijderen. Bij een upgrade (deb: upgrade, rpm: 1 of hoger) niets
3# doen. archlinux roept dit alleen bij verwijderen aan ($1 is dan de versie).
4# Gebruiker, config en /var/lib/bluegit-backup blijven staan.
5case "$1" in
6 upgrade|failed-upgrade|[1-9]) exit 0 ;;
7esac
8if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
9 systemctl disable --now bluegit-backup.service >/dev/null 2>&1 || true
10fi
11exit 0
packaging/nfpm/bluegit-backup.yaml added +51 −0
@@ -0,0 +1,51 @@
1 # nfpm-recept voor bluegit-backup (.deb, .rpm en .pkg.tar.zst).
2 # Zelfde unit, gebruiker en paden als packaging/aur-backup/PKGBUILD.
3 # scripts/build-packages.sh zet VERSION en ARCH.
4 name: bluegit-backup
5 arch: ${ARCH}
6 platform: linux
7 version: ${VERSION}
8 version_schema: none
9 release: "1"
10 maintainer: Tim Falken <tim@timfalken.com>
11 description: "Backup server for a BlueGit instance: incremental copy, archives, rollback"
12 vendor: Tim Falken
13 homepage: https://git.timfalken.com/timfa/bluegit
14 license: MIT
15 overrides:
16 rpm:
17 depends:
18 - shadow-utils
19 contents:
20 - src: dist/.stage/bluegit-backup
21 dst: /usr/bin/bluegit-backup
22 file_info:
23 mode: 0755
24 - src: packaging/backup/bluegit-backup.service
25 dst: /usr/lib/systemd/system/bluegit-backup.service
26 file_info:
27 mode: 0644
28 - src: packaging/backup/config.yml
29 dst: /etc/bluegit-backup/config.yml
30 type: config|noreplace
31 file_info:
32 mode: 0644
33 - src: packaging/backup/sysusers.conf
34 dst: /usr/lib/sysusers.d/bluegit-backup.conf
35 file_info:
36 mode: 0644
37 - src: packaging/backup/tmpfiles.conf
38 dst: /usr/lib/tmpfiles.d/bluegit-backup.conf
39 file_info:
40 mode: 0644
41 - src: LICENSE
42 dst: /usr/share/licenses/bluegit-backup/LICENSE
43 file_info:
44 mode: 0644
45 scripts:
46 postinstall: packaging/nfpm/bluegit-backup.postinstall.sh
47 preremove: packaging/nfpm/bluegit-backup.preremove.sh
48 postremove: packaging/nfpm/postremove.sh
49 archlinux:
50 scripts:
51 postupgrade: packaging/nfpm/bluegit-backup.postinstall.sh
@@ -0,0 +1,51 @@
1# nfpm-recept voor bluegit-backup (.deb, .rpm en .pkg.tar.zst).
2# Zelfde unit, gebruiker en paden als packaging/aur-backup/PKGBUILD.
3# scripts/build-packages.sh zet VERSION en ARCH.
4name: bluegit-backup
5arch: ${ARCH}
6platform: linux
7version: ${VERSION}
8version_schema: none
9release: "1"
10maintainer: Tim Falken <tim@timfalken.com>
11description: "Backup server for a BlueGit instance: incremental copy, archives, rollback"
12vendor: Tim Falken
13homepage: https://git.timfalken.com/timfa/bluegit
14license: MIT
15overrides:
16 rpm:
17 depends:
18 - shadow-utils
19contents:
20 - src: dist/.stage/bluegit-backup
21 dst: /usr/bin/bluegit-backup
22 file_info:
23 mode: 0755
24 - src: packaging/backup/bluegit-backup.service
25 dst: /usr/lib/systemd/system/bluegit-backup.service
26 file_info:
27 mode: 0644
28 - src: packaging/backup/config.yml
29 dst: /etc/bluegit-backup/config.yml
30 type: config|noreplace
31 file_info:
32 mode: 0644
33 - src: packaging/backup/sysusers.conf
34 dst: /usr/lib/sysusers.d/bluegit-backup.conf
35 file_info:
36 mode: 0644
37 - src: packaging/backup/tmpfiles.conf
38 dst: /usr/lib/tmpfiles.d/bluegit-backup.conf
39 file_info:
40 mode: 0644
41 - src: LICENSE
42 dst: /usr/share/licenses/bluegit-backup/LICENSE
43 file_info:
44 mode: 0644
45scripts:
46 postinstall: packaging/nfpm/bluegit-backup.postinstall.sh
47 preremove: packaging/nfpm/bluegit-backup.preremove.sh
48 postremove: packaging/nfpm/postremove.sh
49archlinux:
50 scripts:
51 postupgrade: packaging/nfpm/bluegit-backup.postinstall.sh
packaging/nfpm/bluegit-runner.postinstall.sh added +33 −0
@@ -0,0 +1,33 @@
1 #!/bin/sh
2 # Na installeren of bijwerken (deb, rpm en archlinux). Maakt de gebruiker
3 # bluegit-runner (lid van docker), /etc/bluegit-runner en
4 # /var/lib/bluegit-runner, zoals sysusers.d en tmpfiles.d. Zonder
5 # systemd-sysusers (een kale container) doen groupadd/useradd het.
6 # De service start pas na "bluegit-runner register"; een draaiende herstart.
7 set -e
8 if command -v systemd-sysusers >/dev/null 2>&1; then
9 systemd-sysusers /usr/lib/sysusers.d/bluegit-runner.conf || true
10 fi
11 if ! getent group bluegit-runner >/dev/null 2>&1; then
12 groupadd --system bluegit-runner
13 fi
14 if ! getent passwd bluegit-runner >/dev/null 2>&1; then
15 useradd --system --gid bluegit-runner --home-dir /var/lib/bluegit-runner --no-create-home \
16 --shell /usr/sbin/nologin --comment "BlueGit runner" bluegit-runner
17 fi
18 # Zoals "m bluegit-runner docker" in sysusers.d: de groep bestaat ook als
19 # docker nog niet geïnstalleerd is.
20 if ! getent group docker >/dev/null 2>&1; then
21 groupadd --system docker
22 fi
23 usermod -a -G docker bluegit-runner
24 if command -v systemd-tmpfiles >/dev/null 2>&1; then
25 systemd-tmpfiles --create /usr/lib/tmpfiles.d/bluegit-runner.conf || true
26 fi
27 install -d -m 0750 -o root -g bluegit-runner /etc/bluegit-runner
28 install -d -m 0750 -o bluegit-runner -g bluegit-runner /var/lib/bluegit-runner
29 if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
30 systemctl daemon-reload || true
31 systemctl try-restart bluegit-runner.service || true
32 fi
33 exit 0
@@ -0,0 +1,33 @@
1#!/bin/sh
2# Na installeren of bijwerken (deb, rpm en archlinux). Maakt de gebruiker
3# bluegit-runner (lid van docker), /etc/bluegit-runner en
4# /var/lib/bluegit-runner, zoals sysusers.d en tmpfiles.d. Zonder
5# systemd-sysusers (een kale container) doen groupadd/useradd het.
6# De service start pas na "bluegit-runner register"; een draaiende herstart.
7set -e
8if command -v systemd-sysusers >/dev/null 2>&1; then
9 systemd-sysusers /usr/lib/sysusers.d/bluegit-runner.conf || true
10fi
11if ! getent group bluegit-runner >/dev/null 2>&1; then
12 groupadd --system bluegit-runner
13fi
14if ! getent passwd bluegit-runner >/dev/null 2>&1; then
15 useradd --system --gid bluegit-runner --home-dir /var/lib/bluegit-runner --no-create-home \
16 --shell /usr/sbin/nologin --comment "BlueGit runner" bluegit-runner
17fi
18# Zoals "m bluegit-runner docker" in sysusers.d: de groep bestaat ook als
19# docker nog niet geïnstalleerd is.
20if ! getent group docker >/dev/null 2>&1; then
21 groupadd --system docker
22fi
23usermod -a -G docker bluegit-runner
24if command -v systemd-tmpfiles >/dev/null 2>&1; then
25 systemd-tmpfiles --create /usr/lib/tmpfiles.d/bluegit-runner.conf || true
26fi
27install -d -m 0750 -o root -g bluegit-runner /etc/bluegit-runner
28install -d -m 0750 -o bluegit-runner -g bluegit-runner /var/lib/bluegit-runner
29if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
30 systemctl daemon-reload || true
31 systemctl try-restart bluegit-runner.service || true
32fi
33exit 0
packaging/nfpm/bluegit-runner.preremove.sh added +11 −0
@@ -0,0 +1,11 @@
1 #!/bin/sh
2 # Vóór verwijderen. Bij een upgrade (deb: upgrade, rpm: 1 of hoger) niets
3 # doen. archlinux roept dit alleen bij verwijderen aan ($1 is dan de versie).
4 # Gebruiker, config en /var/lib/bluegit-runner blijven staan.
5 case "$1" in
6 upgrade|failed-upgrade|[1-9]) exit 0 ;;
7 esac
8 if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
9 systemctl disable --now bluegit-runner.service >/dev/null 2>&1 || true
10 fi
11 exit 0
@@ -0,0 +1,11 @@
1#!/bin/sh
2# Vóór verwijderen. Bij een upgrade (deb: upgrade, rpm: 1 of hoger) niets
3# doen. archlinux roept dit alleen bij verwijderen aan ($1 is dan de versie).
4# Gebruiker, config en /var/lib/bluegit-runner blijven staan.
5case "$1" in
6 upgrade|failed-upgrade|[1-9]) exit 0 ;;
7esac
8if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
9 systemctl disable --now bluegit-runner.service >/dev/null 2>&1 || true
10fi
11exit 0
packaging/nfpm/bluegit-runner.yaml added +66 −0
@@ -0,0 +1,66 @@
1 # nfpm-recept voor bluegit-runner (.deb, .rpm en .pkg.tar.zst).
2 # Zelfde unit, gebruiker en paden als packaging/aur-runner/PKGBUILD.
3 # scripts/build-packages.sh zet VERSION en ARCH.
4 name: bluegit-runner
5 arch: ${ARCH}
6 platform: linux
7 version: ${VERSION}
8 version_schema: none
9 release: "1"
10 maintainer: Tim Falken <tim@timfalken.com>
11 description: Separate CI runner for BlueGit
12 vendor: Tim Falken
13 homepage: https://git.timfalken.com/timfa/bluegit
14 license: MIT
15 depends:
16 - git
17 overrides:
18 deb:
19 recommends:
20 - docker.io | docker-ce
21 rpm:
22 depends:
23 - git
24 - shadow-utils
25 recommends:
26 - docker
27 archlinux:
28 depends:
29 - git
30 - docker
31 contents:
32 - src: dist/.stage/bluegit-runner
33 dst: /usr/bin/bluegit-runner
34 file_info:
35 mode: 0755
36 - src: packaging/runner/bluegit-runner.service
37 dst: /usr/lib/systemd/system/bluegit-runner.service
38 file_info:
39 mode: 0644
40 - src: packaging/runner/sysusers.conf
41 dst: /usr/lib/sysusers.d/bluegit-runner.conf
42 file_info:
43 mode: 0644
44 - src: packaging/runner/tmpfiles.conf
45 dst: /usr/lib/tmpfiles.d/bluegit-runner.conf
46 file_info:
47 mode: 0644
48 - src: packaging/runner/config.yml.example
49 dst: /usr/share/bluegit-runner/config.yml.example
50 file_info:
51 mode: 0644
52 - src: docs/runner.md
53 dst: /usr/share/doc/bluegit-runner/README.md
54 file_info:
55 mode: 0644
56 - src: LICENSE
57 dst: /usr/share/licenses/bluegit-runner/LICENSE
58 file_info:
59 mode: 0644
60 scripts:
61 postinstall: packaging/nfpm/bluegit-runner.postinstall.sh
62 preremove: packaging/nfpm/bluegit-runner.preremove.sh
63 postremove: packaging/nfpm/postremove.sh
64 archlinux:
65 scripts:
66 postupgrade: packaging/nfpm/bluegit-runner.postinstall.sh
@@ -0,0 +1,66 @@
1# nfpm-recept voor bluegit-runner (.deb, .rpm en .pkg.tar.zst).
2# Zelfde unit, gebruiker en paden als packaging/aur-runner/PKGBUILD.
3# scripts/build-packages.sh zet VERSION en ARCH.
4name: bluegit-runner
5arch: ${ARCH}
6platform: linux
7version: ${VERSION}
8version_schema: none
9release: "1"
10maintainer: Tim Falken <tim@timfalken.com>
11description: Separate CI runner for BlueGit
12vendor: Tim Falken
13homepage: https://git.timfalken.com/timfa/bluegit
14license: MIT
15depends:
16 - git
17overrides:
18 deb:
19 recommends:
20 - docker.io | docker-ce
21 rpm:
22 depends:
23 - git
24 - shadow-utils
25 recommends:
26 - docker
27 archlinux:
28 depends:
29 - git
30 - docker
31contents:
32 - src: dist/.stage/bluegit-runner
33 dst: /usr/bin/bluegit-runner
34 file_info:
35 mode: 0755
36 - src: packaging/runner/bluegit-runner.service
37 dst: /usr/lib/systemd/system/bluegit-runner.service
38 file_info:
39 mode: 0644
40 - src: packaging/runner/sysusers.conf
41 dst: /usr/lib/sysusers.d/bluegit-runner.conf
42 file_info:
43 mode: 0644
44 - src: packaging/runner/tmpfiles.conf
45 dst: /usr/lib/tmpfiles.d/bluegit-runner.conf
46 file_info:
47 mode: 0644
48 - src: packaging/runner/config.yml.example
49 dst: /usr/share/bluegit-runner/config.yml.example
50 file_info:
51 mode: 0644
52 - src: docs/runner.md
53 dst: /usr/share/doc/bluegit-runner/README.md
54 file_info:
55 mode: 0644
56 - src: LICENSE
57 dst: /usr/share/licenses/bluegit-runner/LICENSE
58 file_info:
59 mode: 0644
60scripts:
61 postinstall: packaging/nfpm/bluegit-runner.postinstall.sh
62 preremove: packaging/nfpm/bluegit-runner.preremove.sh
63 postremove: packaging/nfpm/postremove.sh
64archlinux:
65 scripts:
66 postupgrade: packaging/nfpm/bluegit-runner.postinstall.sh
packaging/nfpm/bluegit.postinstall.sh added +25 −0
@@ -0,0 +1,25 @@
1 #!/bin/sh
2 # Na installeren of bijwerken (deb, rpm en archlinux). Maakt de gebruiker
3 # bluegit en /var/lib/bluegit, zoals sysusers.d en tmpfiles.d. Zonder
4 # systemd-sysusers (een kale container) doen useradd en install het.
5 # De service wordt niet aangezet; een draaiende service herstart.
6 set -e
7 if command -v systemd-sysusers >/dev/null 2>&1; then
8 systemd-sysusers /usr/lib/sysusers.d/bluegit.conf || true
9 fi
10 if ! getent group bluegit >/dev/null 2>&1; then
11 groupadd --system bluegit
12 fi
13 if ! getent passwd bluegit >/dev/null 2>&1; then
14 useradd --system --gid bluegit --home-dir /var/lib/bluegit --no-create-home \
15 --shell /usr/sbin/nologin --comment BlueGit bluegit
16 fi
17 if command -v systemd-tmpfiles >/dev/null 2>&1; then
18 systemd-tmpfiles --create /usr/lib/tmpfiles.d/bluegit.conf || true
19 fi
20 install -d -m 0750 -o bluegit -g bluegit /var/lib/bluegit
21 if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
22 systemctl daemon-reload || true
23 systemctl try-restart bluegit.service || true
24 fi
25 exit 0
@@ -0,0 +1,25 @@
1#!/bin/sh
2# Na installeren of bijwerken (deb, rpm en archlinux). Maakt de gebruiker
3# bluegit en /var/lib/bluegit, zoals sysusers.d en tmpfiles.d. Zonder
4# systemd-sysusers (een kale container) doen useradd en install het.
5# De service wordt niet aangezet; een draaiende service herstart.
6set -e
7if command -v systemd-sysusers >/dev/null 2>&1; then
8 systemd-sysusers /usr/lib/sysusers.d/bluegit.conf || true
9fi
10if ! getent group bluegit >/dev/null 2>&1; then
11 groupadd --system bluegit
12fi
13if ! getent passwd bluegit >/dev/null 2>&1; then
14 useradd --system --gid bluegit --home-dir /var/lib/bluegit --no-create-home \
15 --shell /usr/sbin/nologin --comment BlueGit bluegit
16fi
17if command -v systemd-tmpfiles >/dev/null 2>&1; then
18 systemd-tmpfiles --create /usr/lib/tmpfiles.d/bluegit.conf || true
19fi
20install -d -m 0750 -o bluegit -g bluegit /var/lib/bluegit
21if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
22 systemctl daemon-reload || true
23 systemctl try-restart bluegit.service || true
24fi
25exit 0
packaging/nfpm/bluegit.preremove.sh added +11 −0
@@ -0,0 +1,11 @@
1 #!/bin/sh
2 # Vóór verwijderen. Bij een upgrade (deb: upgrade, rpm: 1 of hoger) niets
3 # doen. archlinux roept dit alleen bij verwijderen aan ($1 is dan de versie).
4 # Gebruiker, config en /var/lib/bluegit blijven staan.
5 case "$1" in
6 upgrade|failed-upgrade|[1-9]) exit 0 ;;
7 esac
8 if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
9 systemctl disable --now bluegit.service >/dev/null 2>&1 || true
10 fi
11 exit 0
@@ -0,0 +1,11 @@
1#!/bin/sh
2# Vóór verwijderen. Bij een upgrade (deb: upgrade, rpm: 1 of hoger) niets
3# doen. archlinux roept dit alleen bij verwijderen aan ($1 is dan de versie).
4# Gebruiker, config en /var/lib/bluegit blijven staan.
5case "$1" in
6 upgrade|failed-upgrade|[1-9]) exit 0 ;;
7esac
8if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
9 systemctl disable --now bluegit.service >/dev/null 2>&1 || true
10fi
11exit 0
packaging/nfpm/bluegit.sysusers.conf added +1 −0
@@ -0,0 +1 @@
1 u bluegit - "BlueGit" /var/lib/bluegit /usr/sbin/nologin
@@ -0,0 +1 @@
1u bluegit - "BlueGit" /var/lib/bluegit /usr/sbin/nologin
packaging/nfpm/bluegit.tmpfiles.conf added +1 −0
@@ -0,0 +1 @@
1 d /var/lib/bluegit 0750 bluegit bluegit -
@@ -0,0 +1 @@
1d /var/lib/bluegit 0750 bluegit bluegit -
packaging/nfpm/bluegit.yaml added +68 −0
@@ -0,0 +1,68 @@
1 # nfpm-recept voor bluegit (.deb, .rpm en .pkg.tar.zst).
2 # Zelfde unit, gebruiker en paden als packaging/aur/PKGBUILD, maar zonder
3 # bluegit-update: die bouwt met makepkg en hoort alleen bij de AUR.
4 # scripts/build-packages.sh zet VERSION en ARCH.
5 name: bluegit
6 arch: ${ARCH}
7 platform: linux
8 version: ${VERSION}
9 version_schema: none
10 release: "1"
11 maintainer: Tim Falken <tim@timfalken.com>
12 description: Self-hosted git-platform
13 vendor: Tim Falken
14 homepage: https://git.timfalken.com/timfa/bluegit
15 license: MIT
16 depends:
17 - git
18 overrides:
19 deb:
20 recommends:
21 - docker.io | docker-ce
22 rpm:
23 depends:
24 - git
25 - shadow-utils
26 recommends:
27 - docker
28 archlinux:
29 depends:
30 - git
31 - docker
32 contents:
33 - src: dist/.stage/bluegit
34 dst: /usr/bin/bluegit
35 file_info:
36 mode: 0755
37 - src: packaging/bluegit.service
38 dst: /usr/lib/systemd/system/bluegit.service
39 file_info:
40 mode: 0644
41 - src: packaging/bluegit.yml
42 dst: /etc/bluegit/config.yml
43 type: config|noreplace
44 file_info:
45 mode: 0644
46 - src: packaging/storage.conf
47 dst: /usr/share/bluegit/storage.conf.example
48 file_info:
49 mode: 0644
50 - src: packaging/nfpm/bluegit.sysusers.conf
51 dst: /usr/lib/sysusers.d/bluegit.conf
52 file_info:
53 mode: 0644
54 - src: packaging/nfpm/bluegit.tmpfiles.conf
55 dst: /usr/lib/tmpfiles.d/bluegit.conf
56 file_info:
57 mode: 0644
58 - src: LICENSE
59 dst: /usr/share/licenses/bluegit/LICENSE
60 file_info:
61 mode: 0644
62 scripts:
63 postinstall: packaging/nfpm/bluegit.postinstall.sh
64 preremove: packaging/nfpm/bluegit.preremove.sh
65 postremove: packaging/nfpm/postremove.sh
66 archlinux:
67 scripts:
68 postupgrade: packaging/nfpm/bluegit.postinstall.sh
@@ -0,0 +1,68 @@
1# nfpm-recept voor bluegit (.deb, .rpm en .pkg.tar.zst).
2# Zelfde unit, gebruiker en paden als packaging/aur/PKGBUILD, maar zonder
3# bluegit-update: die bouwt met makepkg en hoort alleen bij de AUR.
4# scripts/build-packages.sh zet VERSION en ARCH.
5name: bluegit
6arch: ${ARCH}
7platform: linux
8version: ${VERSION}
9version_schema: none
10release: "1"
11maintainer: Tim Falken <tim@timfalken.com>
12description: Self-hosted git-platform
13vendor: Tim Falken
14homepage: https://git.timfalken.com/timfa/bluegit
15license: MIT
16depends:
17 - git
18overrides:
19 deb:
20 recommends:
21 - docker.io | docker-ce
22 rpm:
23 depends:
24 - git
25 - shadow-utils
26 recommends:
27 - docker
28 archlinux:
29 depends:
30 - git
31 - docker
32contents:
33 - src: dist/.stage/bluegit
34 dst: /usr/bin/bluegit
35 file_info:
36 mode: 0755
37 - src: packaging/bluegit.service
38 dst: /usr/lib/systemd/system/bluegit.service
39 file_info:
40 mode: 0644
41 - src: packaging/bluegit.yml
42 dst: /etc/bluegit/config.yml
43 type: config|noreplace
44 file_info:
45 mode: 0644
46 - src: packaging/storage.conf
47 dst: /usr/share/bluegit/storage.conf.example
48 file_info:
49 mode: 0644
50 - src: packaging/nfpm/bluegit.sysusers.conf
51 dst: /usr/lib/sysusers.d/bluegit.conf
52 file_info:
53 mode: 0644
54 - src: packaging/nfpm/bluegit.tmpfiles.conf
55 dst: /usr/lib/tmpfiles.d/bluegit.conf
56 file_info:
57 mode: 0644
58 - src: LICENSE
59 dst: /usr/share/licenses/bluegit/LICENSE
60 file_info:
61 mode: 0644
62scripts:
63 postinstall: packaging/nfpm/bluegit.postinstall.sh
64 preremove: packaging/nfpm/bluegit.preremove.sh
65 postremove: packaging/nfpm/postremove.sh
66archlinux:
67 scripts:
68 postupgrade: packaging/nfpm/bluegit.postinstall.sh
packaging/nfpm/postremove.sh added +6 −0
@@ -0,0 +1,6 @@
1 #!/bin/sh
2 # Na verwijderen of bijwerken: systemd de units opnieuw laten lezen.
3 if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
4 systemctl daemon-reload >/dev/null 2>&1 || true
5 fi
6 exit 0
@@ -0,0 +1,6 @@
1#!/bin/sh
2# Na verwijderen of bijwerken: systemd de units opnieuw laten lezen.
3if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
4 systemctl daemon-reload >/dev/null 2>&1 || true
5fi
6exit 0
scripts/build-packages.sh added +89 −0
@@ -0,0 +1,89 @@
1 #!/usr/bin/env bash
2 # Bouwt .deb, .rpm en .pkg.tar.zst voor amd64 en arm64 uit de binaries in
3 # dist/ (job binaries) en schrijft dist/SHA256SUMS over alles wat in een
4 # release komt. Draait vanuit de root van de repository.
5 #
6 # scripts/build-packages.sh [versie] standaard CI_COMMIT_TAG of de korte sha
7 # PACKAGES="bluegit bluegit-runner bluegit-backup" welke nfpm-recepten (packaging/nfpm/<naam>.yaml)
8 # NFPM=nfpm het nfpm-programma
9 #
10 # Bestandsnamen zonder versie, zodat de artifact-paden vast zijn:
11 # dist/<naam>_amd64.deb dist/<naam>.x86_64.rpm dist/<naam>-x86_64.pkg.tar.zst
12 # dist/<naam>_arm64.deb dist/<naam>.aarch64.rpm dist/<naam>-aarch64.pkg.tar.zst
13 set -euo pipefail
14
15 : "${PACKAGES:=bluegit bluegit-runner bluegit-backup}"
16 : "${NFPM:=nfpm}"
17
18 # pkg_version zet een tag om naar een pakketversie: v1.2.3 -> 1.2.3. Een tag
19 # met een achtervoegsel (v1.0.0-rc1) wordt 1.0.0.rc1: archlinux staat geen -
20 # in pkgver toe en deb leest - als revisie. Geen tag (een sha) wordt
21 # 0.0.0.git<sha>.
22 pkg_version() {
23 local v="$1"
24 if [[ "$v" =~ ^v[0-9] ]]; then
25 v="${v#v}"
26 printf '%s\n' "${v//[^0-9A-Za-z.]/.}"
27 return
28 fi
29 printf '0.0.0.git%s\n' "${v//[^0-9A-Za-z.]/.}"
30 }
31
32 # release_files: alle bestanden die in de release komen, in vaste volgorde.
33 release_files() {
34 local p
35 for p in $PACKAGES; do
36 printf 'dist/%s-linux-amd64\n' "$p"
37 printf 'dist/%s-linux-arm64\n' "$p"
38 printf 'dist/%s_amd64.deb\n' "$p"
39 printf 'dist/%s_arm64.deb\n' "$p"
40 printf 'dist/%s.x86_64.rpm\n' "$p"
41 printf 'dist/%s.aarch64.rpm\n' "$p"
42 printf 'dist/%s-x86_64.pkg.tar.zst\n' "$p"
43 printf 'dist/%s-aarch64.pkg.tar.zst\n' "$p"
44 done
45 }
46
47 # release_json TAG COMMIT TITEL: body voor POST .../releases/TAG/assets.
48 # Alle assets komen uit job package (die ook de binaries doorgeeft).
49 release_json() {
50 local tag="$1" commit="$2" title="$3" f first=1
51 printf '{"commit":"%s","name":"%s","body":"%s %s","assets":[' "$commit" "$tag" "$title" "$tag"
52 for f in $(release_files) dist/SHA256SUMS; do
53 [[ $first == 1 ]] || printf ','
54 first=0
55 printf '{"job":"package","path":"%s","name":"%s"}' "$f" "${f#dist/}"
56 done
57 printf ']}\n'
58 }
59
60 build() {
61 local version pv p arch nfarch
62 version="${1:-${CI_COMMIT_TAG:-${CI_COMMIT_SHORT_SHA:-dev}}}"
63 pv="$(pkg_version "$version")"
64 for p in $PACKAGES; do
65 for arch in amd64 arm64; do
66 [[ -x "dist/$p-linux-$arch" ]] || { echo "dist/$p-linux-$arch ontbreekt (job binaries)" >&2; return 1; }
67 # nfpm vult geen variabelen in src in; het recept leest dist/.stage/<naam>.
68 mkdir -p dist/.stage
69 install -m 0755 "dist/$p-linux-$arch" "dist/.stage/$p"
70 VERSION="$pv" ARCH="$arch" "$NFPM" package -f "packaging/nfpm/$p.yaml" -p deb -t "dist/${p}_${arch}.deb"
71 case "$arch" in amd64) nfarch=x86_64 ;; arm64) nfarch=aarch64 ;; esac
72 VERSION="$pv" ARCH="$arch" "$NFPM" package -f "packaging/nfpm/$p.yaml" -p rpm -t "dist/$p.$nfarch.rpm"
73 VERSION="$pv" ARCH="$arch" "$NFPM" package -f "packaging/nfpm/$p.yaml" -p archlinux -t "dist/$p-$nfarch.pkg.tar.zst"
74 done
75 done
76 rm -rf dist/.stage
77 local files=()
78 mapfile -t files < <(release_files)
79 (cd dist && sha256sum "${files[@]#dist/}" > SHA256SUMS)
80 echo "pakketversie $pv"
81 cat dist/SHA256SUMS
82 }
83
84 case "${1:-}" in
85 --version-of) pkg_version "${2:?versie}" ;;
86 --files) release_files ;;
87 --json) release_json "${2:?tag}" "${3:?commit}" "${4:?titel}" ;;
88 *) build "$@" ;;
89 esac
@@ -0,0 +1,89 @@
1#!/usr/bin/env bash
2# Bouwt .deb, .rpm en .pkg.tar.zst voor amd64 en arm64 uit de binaries in
3# dist/ (job binaries) en schrijft dist/SHA256SUMS over alles wat in een
4# release komt. Draait vanuit de root van de repository.
5#
6# scripts/build-packages.sh [versie] standaard CI_COMMIT_TAG of de korte sha
7# PACKAGES="bluegit bluegit-runner bluegit-backup" welke nfpm-recepten (packaging/nfpm/<naam>.yaml)
8# NFPM=nfpm het nfpm-programma
9#
10# Bestandsnamen zonder versie, zodat de artifact-paden vast zijn:
11# dist/<naam>_amd64.deb dist/<naam>.x86_64.rpm dist/<naam>-x86_64.pkg.tar.zst
12# dist/<naam>_arm64.deb dist/<naam>.aarch64.rpm dist/<naam>-aarch64.pkg.tar.zst
13set -euo pipefail
14
15: "${PACKAGES:=bluegit bluegit-runner bluegit-backup}"
16: "${NFPM:=nfpm}"
17
18# pkg_version zet een tag om naar een pakketversie: v1.2.3 -> 1.2.3. Een tag
19# met een achtervoegsel (v1.0.0-rc1) wordt 1.0.0.rc1: archlinux staat geen -
20# in pkgver toe en deb leest - als revisie. Geen tag (een sha) wordt
21# 0.0.0.git<sha>.
22pkg_version() {
23 local v="$1"
24 if [[ "$v" =~ ^v[0-9] ]]; then
25 v="${v#v}"
26 printf '%s\n' "${v//[^0-9A-Za-z.]/.}"
27 return
28 fi
29 printf '0.0.0.git%s\n' "${v//[^0-9A-Za-z.]/.}"
30}
31
32# release_files: alle bestanden die in de release komen, in vaste volgorde.
33release_files() {
34 local p
35 for p in $PACKAGES; do
36 printf 'dist/%s-linux-amd64\n' "$p"
37 printf 'dist/%s-linux-arm64\n' "$p"
38 printf 'dist/%s_amd64.deb\n' "$p"
39 printf 'dist/%s_arm64.deb\n' "$p"
40 printf 'dist/%s.x86_64.rpm\n' "$p"
41 printf 'dist/%s.aarch64.rpm\n' "$p"
42 printf 'dist/%s-x86_64.pkg.tar.zst\n' "$p"
43 printf 'dist/%s-aarch64.pkg.tar.zst\n' "$p"
44 done
45}
46
47# release_json TAG COMMIT TITEL: body voor POST .../releases/TAG/assets.
48# Alle assets komen uit job package (die ook de binaries doorgeeft).
49release_json() {
50 local tag="$1" commit="$2" title="$3" f first=1
51 printf '{"commit":"%s","name":"%s","body":"%s %s","assets":[' "$commit" "$tag" "$title" "$tag"
52 for f in $(release_files) dist/SHA256SUMS; do
53 [[ $first == 1 ]] || printf ','
54 first=0
55 printf '{"job":"package","path":"%s","name":"%s"}' "$f" "${f#dist/}"
56 done
57 printf ']}\n'
58}
59
60build() {
61 local version pv p arch nfarch
62 version="${1:-${CI_COMMIT_TAG:-${CI_COMMIT_SHORT_SHA:-dev}}}"
63 pv="$(pkg_version "$version")"
64 for p in $PACKAGES; do
65 for arch in amd64 arm64; do
66 [[ -x "dist/$p-linux-$arch" ]] || { echo "dist/$p-linux-$arch ontbreekt (job binaries)" >&2; return 1; }
67 # nfpm vult geen variabelen in src in; het recept leest dist/.stage/<naam>.
68 mkdir -p dist/.stage
69 install -m 0755 "dist/$p-linux-$arch" "dist/.stage/$p"
70 VERSION="$pv" ARCH="$arch" "$NFPM" package -f "packaging/nfpm/$p.yaml" -p deb -t "dist/${p}_${arch}.deb"
71 case "$arch" in amd64) nfarch=x86_64 ;; arm64) nfarch=aarch64 ;; esac
72 VERSION="$pv" ARCH="$arch" "$NFPM" package -f "packaging/nfpm/$p.yaml" -p rpm -t "dist/$p.$nfarch.rpm"
73 VERSION="$pv" ARCH="$arch" "$NFPM" package -f "packaging/nfpm/$p.yaml" -p archlinux -t "dist/$p-$nfarch.pkg.tar.zst"
74 done
75 done
76 rm -rf dist/.stage
77 local files=()
78 mapfile -t files < <(release_files)
79 (cd dist && sha256sum "${files[@]#dist/}" > SHA256SUMS)
80 echo "pakketversie $pv"
81 cat dist/SHA256SUMS
82}
83
84case "${1:-}" in
85 --version-of) pkg_version "${2:?versie}" ;;
86 --files) release_files ;;
87 --json) release_json "${2:?tag}" "${3:?commit}" "${4:?titel}" ;;
88 *) build "$@" ;;
89esac
scripts/packages_test.go added +139 −0
@@ -0,0 +1,139 @@
1 package scripts
2
3 import (
4 "os"
5 "os/exec"
6 "path/filepath"
7 "regexp"
8 "strings"
9 "testing"
10 )
11
12 // Elk pad dat een PKGBUILD installeert, staat in de repository. Zo breekt
13 // een verhuizing (zoals bluegit-backup naar packaging/backup) de AUR niet.
14 func TestPkgbuildSourcesExist(t *testing.T) {
15 root := ".."
16 re := regexp.MustCompile(`install -D\S* (packaging/\S+|docs/\S+|LICENSE) `)
17 for _, dir := range []string{"aur", "aur-runner", "aur-backup"} {
18 b, err := os.ReadFile(filepath.Join(root, "packaging", dir, "PKGBUILD"))
19 if err != nil {
20 t.Fatal(err)
21 }
22 text := string(b)
23 if !strings.Contains(text, "https://git.timfalken.com/timfa/bluegit/-/archive/${_commit}/bluegit-${_commit}.tar.gz") {
24 t.Errorf("%s: bron is niet het archief van timfa/bluegit", dir)
25 }
26 if !strings.Contains(text, `cd "$srcdir/bluegit-${_commit}"`) {
27 t.Errorf("%s: bouwmap is niet bluegit-<commit>", dir)
28 }
29 for _, m := range re.FindAllStringSubmatch(text, -1) {
30 if _, err := os.Stat(filepath.Join(root, m[1])); err != nil {
31 t.Errorf("%s: %s ontbreekt", dir, m[1])
32 }
33 }
34 }
35 }
36
37 func TestBackupPkgbuildRewrite(t *testing.T) {
38 root := ".."
39 src, err := os.ReadFile(filepath.Join(root, "packaging", "aur-backup", "PKGBUILD"))
40 if err != nil {
41 t.Fatal(err)
42 }
43 dest := filepath.Join(t.TempDir(), "PKGBUILD")
44 if err := os.WriteFile(dest, src, 0o644); err != nil {
45 t.Fatal(err)
46 }
47 version, commit, sum := "20261116020000", "0123456789abcdef0123456789abcdef01234567", strings.Repeat("b", 64)
48 cmd := exec.Command("bash", filepath.Join(root, "scripts", "publish-aur.sh"), "--rewrite-only", version, commit, sum, dest)
49 if out, err := cmd.CombinedOutput(); err != nil {
50 t.Fatalf("rewrite: %v %s", err, out)
51 }
52 got, _ := os.ReadFile(dest)
53 for _, want := range []string{
54 "pkgname=bluegit-backup",
55 "pkgver=" + version,
56 "_commit=" + commit,
57 "sha256sums=('" + sum + "')",
58 "backup=('etc/bluegit-backup/config.yml')",
59 "install=bluegit-backup.install",
60 "-X gitlab.com/Timfa/bluegit/internal/backupserver/server.Version=${pkgver}",
61 "./cmd/bluegit-backup",
62 } {
63 if !strings.Contains(string(got), want) {
64 t.Errorf("mist %q", want)
65 }
66 }
67 if _, err := os.Stat(filepath.Join(root, "packaging", "aur-backup", "bluegit-backup.install")); err != nil {
68 t.Fatal(err)
69 }
70 // De ldflag moet naar een bestaande variabele wijzen.
71 srv, err := os.ReadFile(filepath.Join(root, "internal", "backupserver", "server", "server.go"))
72 if err != nil || !strings.Contains(string(srv), `var Version = "dev"`) {
73 t.Fatal("internal/backupserver/server.Version ontbreekt")
74 }
75 pub, _ := os.ReadFile(filepath.Join(root, "scripts", "publish-aur.sh"))
76 if !strings.Contains(string(pub), `bluegit-backup) PKGDIR="$ROOT/packaging/aur-backup"`) {
77 t.Fatal("publish-aur.sh kent AUR_PKG=bluegit-backup niet")
78 }
79 }
80
81 // nfpm-recepten: elk bronbestand en script bestaat en de scripts zijn geldige sh.
82 func TestNfpmRecipes(t *testing.T) {
83 root := ".."
84 re := regexp.MustCompile(`(?m)^\s*(?:- src|postinstall|preremove|postremove|postupgrade): (\S+)`)
85 for _, name := range []string{"bluegit", "bluegit-runner", "bluegit-backup"} {
86 b, err := os.ReadFile(filepath.Join(root, "packaging", "nfpm", name+".yaml"))
87 if err != nil {
88 t.Fatal(err)
89 }
90 text := string(b)
91 if !strings.Contains(text, "src: dist/.stage/"+name+"\n") || !strings.Contains(text, "dst: /usr/bin/"+name+"\n") {
92 t.Errorf("%s: binary niet uit dist/.stage naar /usr/bin", name)
93 }
94 if !strings.Contains(text, "dst: /usr/lib/systemd/system/"+name+".service") {
95 t.Errorf("%s: systemd-unit ontbreekt", name)
96 }
97 for _, m := range re.FindAllStringSubmatch(text, -1) {
98 p := m[1]
99 if strings.HasPrefix(p, "dist/") {
100 continue
101 }
102 if _, err := os.Stat(filepath.Join(root, p)); err != nil {
103 t.Errorf("%s: %s ontbreekt", name, p)
104 continue
105 }
106 if strings.HasSuffix(p, ".sh") {
107 if out, err := exec.Command("sh", "-n", filepath.Join(root, p)).CombinedOutput(); err != nil {
108 t.Errorf("%s: %v %s", p, err, out)
109 }
110 }
111 }
112 }
113 }
114
115 func TestReleaseAssets(t *testing.T) {
116 root := ".."
117 script := filepath.Join(root, "scripts", "build-packages.sh")
118 for in, want := range map[string]string{"v0.1.0": "0.1.0", "v1.0.0-rc1": "1.0.0.rc1", "1a2b3c4": "0.0.0.git1a2b3c4"} {
119 out, err := exec.Command("bash", script, "--version-of", in).Output()
120 if err != nil || strings.TrimSpace(string(out)) != want {
121 t.Errorf("versie van %s = %q, wil %s (%v)", in, out, want, err)
122 }
123 }
124 cmd := exec.Command("bash", script, "--json", "v0.1.0", "abc", "BlueGit")
125 cmd.Env = append(os.Environ(), "PACKAGES=bluegit bluegit-runner bluegit-backup")
126 out, err := cmd.Output()
127 if err != nil {
128 t.Fatal(err)
129 }
130 text := string(out)
131 if n := strings.Count(text, `"job":"package"`); n != 25 {
132 t.Fatalf("%d assets, wil 25 (3 programma's x 8 + SHA256SUMS)\n%s", n, text)
133 }
134 for _, want := range []string{`"name":"v0.1.0"`, `"commit":"abc"`, `"name":"bluegit-backup_arm64.deb"`, `"name":"bluegit-runner.x86_64.rpm"`, `"name":"bluegit-aarch64.pkg.tar.zst"`, `"name":"SHA256SUMS"`} {
135 if !strings.Contains(text, want) {
136 t.Errorf("mist %s", want)
137 }
138 }
139 }
@@ -0,0 +1,139 @@
1package scripts
2
3import (
4 "os"
5 "os/exec"
6 "path/filepath"
7 "regexp"
8 "strings"
9 "testing"
10)
11
12// Elk pad dat een PKGBUILD installeert, staat in de repository. Zo breekt
13// een verhuizing (zoals bluegit-backup naar packaging/backup) de AUR niet.
14func TestPkgbuildSourcesExist(t *testing.T) {
15 root := ".."
16 re := regexp.MustCompile(`install -D\S* (packaging/\S+|docs/\S+|LICENSE) `)
17 for _, dir := range []string{"aur", "aur-runner", "aur-backup"} {
18 b, err := os.ReadFile(filepath.Join(root, "packaging", dir, "PKGBUILD"))
19 if err != nil {
20 t.Fatal(err)
21 }
22 text := string(b)
23 if !strings.Contains(text, "https://git.timfalken.com/timfa/bluegit/-/archive/${_commit}/bluegit-${_commit}.tar.gz") {
24 t.Errorf("%s: bron is niet het archief van timfa/bluegit", dir)
25 }
26 if !strings.Contains(text, `cd "$srcdir/bluegit-${_commit}"`) {
27 t.Errorf("%s: bouwmap is niet bluegit-<commit>", dir)
28 }
29 for _, m := range re.FindAllStringSubmatch(text, -1) {
30 if _, err := os.Stat(filepath.Join(root, m[1])); err != nil {
31 t.Errorf("%s: %s ontbreekt", dir, m[1])
32 }
33 }
34 }
35}
36
37func TestBackupPkgbuildRewrite(t *testing.T) {
38 root := ".."
39 src, err := os.ReadFile(filepath.Join(root, "packaging", "aur-backup", "PKGBUILD"))
40 if err != nil {
41 t.Fatal(err)
42 }
43 dest := filepath.Join(t.TempDir(), "PKGBUILD")
44 if err := os.WriteFile(dest, src, 0o644); err != nil {
45 t.Fatal(err)
46 }
47 version, commit, sum := "20261116020000", "0123456789abcdef0123456789abcdef01234567", strings.Repeat("b", 64)
48 cmd := exec.Command("bash", filepath.Join(root, "scripts", "publish-aur.sh"), "--rewrite-only", version, commit, sum, dest)
49 if out, err := cmd.CombinedOutput(); err != nil {
50 t.Fatalf("rewrite: %v %s", err, out)
51 }
52 got, _ := os.ReadFile(dest)
53 for _, want := range []string{
54 "pkgname=bluegit-backup",
55 "pkgver=" + version,
56 "_commit=" + commit,
57 "sha256sums=('" + sum + "')",
58 "backup=('etc/bluegit-backup/config.yml')",
59 "install=bluegit-backup.install",
60 "-X gitlab.com/Timfa/bluegit/internal/backupserver/server.Version=${pkgver}",
61 "./cmd/bluegit-backup",
62 } {
63 if !strings.Contains(string(got), want) {
64 t.Errorf("mist %q", want)
65 }
66 }
67 if _, err := os.Stat(filepath.Join(root, "packaging", "aur-backup", "bluegit-backup.install")); err != nil {
68 t.Fatal(err)
69 }
70 // De ldflag moet naar een bestaande variabele wijzen.
71 srv, err := os.ReadFile(filepath.Join(root, "internal", "backupserver", "server", "server.go"))
72 if err != nil || !strings.Contains(string(srv), `var Version = "dev"`) {
73 t.Fatal("internal/backupserver/server.Version ontbreekt")
74 }
75 pub, _ := os.ReadFile(filepath.Join(root, "scripts", "publish-aur.sh"))
76 if !strings.Contains(string(pub), `bluegit-backup) PKGDIR="$ROOT/packaging/aur-backup"`) {
77 t.Fatal("publish-aur.sh kent AUR_PKG=bluegit-backup niet")
78 }
79}
80
81// nfpm-recepten: elk bronbestand en script bestaat en de scripts zijn geldige sh.
82func TestNfpmRecipes(t *testing.T) {
83 root := ".."
84 re := regexp.MustCompile(`(?m)^\s*(?:- src|postinstall|preremove|postremove|postupgrade): (\S+)`)
85 for _, name := range []string{"bluegit", "bluegit-runner", "bluegit-backup"} {
86 b, err := os.ReadFile(filepath.Join(root, "packaging", "nfpm", name+".yaml"))
87 if err != nil {
88 t.Fatal(err)
89 }
90 text := string(b)
91 if !strings.Contains(text, "src: dist/.stage/"+name+"\n") || !strings.Contains(text, "dst: /usr/bin/"+name+"\n") {
92 t.Errorf("%s: binary niet uit dist/.stage naar /usr/bin", name)
93 }
94 if !strings.Contains(text, "dst: /usr/lib/systemd/system/"+name+".service") {
95 t.Errorf("%s: systemd-unit ontbreekt", name)
96 }
97 for _, m := range re.FindAllStringSubmatch(text, -1) {
98 p := m[1]
99 if strings.HasPrefix(p, "dist/") {
100 continue
101 }
102 if _, err := os.Stat(filepath.Join(root, p)); err != nil {
103 t.Errorf("%s: %s ontbreekt", name, p)
104 continue
105 }
106 if strings.HasSuffix(p, ".sh") {
107 if out, err := exec.Command("sh", "-n", filepath.Join(root, p)).CombinedOutput(); err != nil {
108 t.Errorf("%s: %v %s", p, err, out)
109 }
110 }
111 }
112 }
113}
114
115func TestReleaseAssets(t *testing.T) {
116 root := ".."
117 script := filepath.Join(root, "scripts", "build-packages.sh")
118 for in, want := range map[string]string{"v0.1.0": "0.1.0", "v1.0.0-rc1": "1.0.0.rc1", "1a2b3c4": "0.0.0.git1a2b3c4"} {
119 out, err := exec.Command("bash", script, "--version-of", in).Output()
120 if err != nil || strings.TrimSpace(string(out)) != want {
121 t.Errorf("versie van %s = %q, wil %s (%v)", in, out, want, err)
122 }
123 }
124 cmd := exec.Command("bash", script, "--json", "v0.1.0", "abc", "BlueGit")
125 cmd.Env = append(os.Environ(), "PACKAGES=bluegit bluegit-runner bluegit-backup")
126 out, err := cmd.Output()
127 if err != nil {
128 t.Fatal(err)
129 }
130 text := string(out)
131 if n := strings.Count(text, `"job":"package"`); n != 25 {
132 t.Fatalf("%d assets, wil 25 (3 programma's x 8 + SHA256SUMS)\n%s", n, text)
133 }
134 for _, want := range []string{`"name":"v0.1.0"`, `"commit":"abc"`, `"name":"bluegit-backup_arm64.deb"`, `"name":"bluegit-runner.x86_64.rpm"`, `"name":"bluegit-aarch64.pkg.tar.zst"`, `"name":"SHA256SUMS"`} {
135 if !strings.Contains(text, want) {
136 t.Errorf("mist %s", want)
137 }
138 }
139}
scripts/test-package.sh added +77 −0
@@ -0,0 +1,77 @@
1 #!/usr/bin/env bash
2 # Installeert de pakketten uit dist/ (job package) in een container van de
3 # doeldistro en controleert ze. Draait als root vanuit de root van de
4 # repository, in ubuntu, debian, rockylinux, fedora of archlinux.
5 #
6 # scripts/test-package.sh [verwachte versie] standaard CI_COMMIT_TAG of de korte sha
7 # PACKAGES="bluegit bluegit-runner bluegit-backup"
8 #
9 # Per pakket: --version geeft de verwachte versie, de systemd-unit,
10 # sysusers.d en tmpfiles.d staan er, de gebruiker en /var/lib/<naam>
11 # bestaan. Daarna verwijderen: binary en unit zijn weg.
12 set -euo pipefail
13
14 : "${PACKAGES:=bluegit bluegit-runner bluegit-backup}"
15 want="${1:-${CI_COMMIT_TAG:-${CI_COMMIT_SHORT_SHA:-dev}}}"
16 fail() { echo "FOUT: $*" >&2; exit 1; }
17
18 files=()
19 if command -v apt-get >/dev/null 2>&1; then
20 kind=deb
21 for p in $PACKAGES; do files+=("./dist/${p}_amd64.deb"); done
22 elif command -v dnf >/dev/null 2>&1; then
23 kind=rpm
24 for p in $PACKAGES; do files+=("./dist/$p.x86_64.rpm"); done
25 elif command -v pacman >/dev/null 2>&1; then
26 kind=arch
27 for p in $PACKAGES; do files+=("./dist/$p-x86_64.pkg.tar.zst"); done
28 else
29 fail "onbekende distro"
30 fi
31 for f in "${files[@]}"; do [[ -f "$f" ]] || fail "$f ontbreekt (job package)"; done
32 . /etc/os-release
33 echo "== $PRETTY_NAME: $kind ${files[*]}"
34
35 case "$kind" in
36 deb)
37 export DEBIAN_FRONTEND=noninteractive
38 apt-get update -qq
39 apt-get install -y -qq --no-install-recommends "${files[@]}"
40 ;;
41 rpm) dnf install -y -q --setopt=install_weak_deps=False "${files[@]}" ;;
42 arch)
43 pacman -Sy --noconfirm --noprogressbar >/dev/null
44 pacman -U --noconfirm --noprogressbar "${files[@]}"
45 ;;
46 esac
47
48 for p in $PACKAGES; do
49 got="$("/usr/bin/$p" --version)" || fail "$p --version"
50 [[ "$got" == "$want" ]] || fail "$p --version gaf '$got', verwacht '$want'"
51 for f in "/usr/lib/systemd/system/$p.service" "/usr/lib/sysusers.d/$p.conf" "/usr/lib/tmpfiles.d/$p.conf" "/usr/share/licenses/$p/LICENSE"; do
52 [[ -f "$f" ]] || fail "$f ontbreekt"
53 done
54 grep -q "^User=$p$" "/usr/lib/systemd/system/$p.service" || fail "$p.service draait niet als $p"
55 getent passwd "$p" >/dev/null || fail "gebruiker $p ontbreekt"
56 [[ "$(stat -c %U "/var/lib/$p")" == "$p" ]] || fail "/var/lib/$p is niet van $p"
57 case "$p" in
58 bluegit) [[ -f /etc/bluegit/config.yml ]] || fail "/etc/bluegit/config.yml ontbreekt" ;;
59 bluegit-backup) [[ -f /etc/bluegit-backup/config.yml ]] || fail "/etc/bluegit-backup/config.yml ontbreekt" ;;
60 bluegit-runner)
61 id -nG bluegit-runner | tr ' ' '\n' | grep -qx docker || fail "bluegit-runner is geen lid van docker"
62 [[ -d /etc/bluegit-runner ]] || fail "/etc/bluegit-runner ontbreekt"
63 ;;
64 esac
65 echo "ok: $p $got"
66 done
67
68 case "$kind" in
69 deb) apt-get remove -y -qq $PACKAGES ;;
70 rpm) dnf remove -y -q $PACKAGES ;;
71 arch) pacman -R --noconfirm $PACKAGES ;;
72 esac
73 for p in $PACKAGES; do
74 [[ ! -e "/usr/bin/$p" ]] || fail "/usr/bin/$p staat er na verwijderen nog"
75 [[ ! -e "/usr/lib/systemd/system/$p.service" ]] || fail "$p.service staat er na verwijderen nog"
76 done
77 echo "== $PRETTY_NAME: installeren, --version, units en verwijderen ok"
@@ -0,0 +1,77 @@
1#!/usr/bin/env bash
2# Installeert de pakketten uit dist/ (job package) in een container van de
3# doeldistro en controleert ze. Draait als root vanuit de root van de
4# repository, in ubuntu, debian, rockylinux, fedora of archlinux.
5#
6# scripts/test-package.sh [verwachte versie] standaard CI_COMMIT_TAG of de korte sha
7# PACKAGES="bluegit bluegit-runner bluegit-backup"
8#
9# Per pakket: --version geeft de verwachte versie, de systemd-unit,
10# sysusers.d en tmpfiles.d staan er, de gebruiker en /var/lib/<naam>
11# bestaan. Daarna verwijderen: binary en unit zijn weg.
12set -euo pipefail
13
14: "${PACKAGES:=bluegit bluegit-runner bluegit-backup}"
15want="${1:-${CI_COMMIT_TAG:-${CI_COMMIT_SHORT_SHA:-dev}}}"
16fail() { echo "FOUT: $*" >&2; exit 1; }
17
18files=()
19if command -v apt-get >/dev/null 2>&1; then
20 kind=deb
21 for p in $PACKAGES; do files+=("./dist/${p}_amd64.deb"); done
22elif command -v dnf >/dev/null 2>&1; then
23 kind=rpm
24 for p in $PACKAGES; do files+=("./dist/$p.x86_64.rpm"); done
25elif command -v pacman >/dev/null 2>&1; then
26 kind=arch
27 for p in $PACKAGES; do files+=("./dist/$p-x86_64.pkg.tar.zst"); done
28else
29 fail "onbekende distro"
30fi
31for f in "${files[@]}"; do [[ -f "$f" ]] || fail "$f ontbreekt (job package)"; done
32. /etc/os-release
33echo "== $PRETTY_NAME: $kind ${files[*]}"
34
35case "$kind" in
36 deb)
37 export DEBIAN_FRONTEND=noninteractive
38 apt-get update -qq
39 apt-get install -y -qq --no-install-recommends "${files[@]}"
40 ;;
41 rpm) dnf install -y -q --setopt=install_weak_deps=False "${files[@]}" ;;
42 arch)
43 pacman -Sy --noconfirm --noprogressbar >/dev/null
44 pacman -U --noconfirm --noprogressbar "${files[@]}"
45 ;;
46esac
47
48for p in $PACKAGES; do
49 got="$("/usr/bin/$p" --version)" || fail "$p --version"
50 [[ "$got" == "$want" ]] || fail "$p --version gaf '$got', verwacht '$want'"
51 for f in "/usr/lib/systemd/system/$p.service" "/usr/lib/sysusers.d/$p.conf" "/usr/lib/tmpfiles.d/$p.conf" "/usr/share/licenses/$p/LICENSE"; do
52 [[ -f "$f" ]] || fail "$f ontbreekt"
53 done
54 grep -q "^User=$p$" "/usr/lib/systemd/system/$p.service" || fail "$p.service draait niet als $p"
55 getent passwd "$p" >/dev/null || fail "gebruiker $p ontbreekt"
56 [[ "$(stat -c %U "/var/lib/$p")" == "$p" ]] || fail "/var/lib/$p is niet van $p"
57 case "$p" in
58 bluegit) [[ -f /etc/bluegit/config.yml ]] || fail "/etc/bluegit/config.yml ontbreekt" ;;
59 bluegit-backup) [[ -f /etc/bluegit-backup/config.yml ]] || fail "/etc/bluegit-backup/config.yml ontbreekt" ;;
60 bluegit-runner)
61 id -nG bluegit-runner | tr ' ' '\n' | grep -qx docker || fail "bluegit-runner is geen lid van docker"
62 [[ -d /etc/bluegit-runner ]] || fail "/etc/bluegit-runner ontbreekt"
63 ;;
64 esac
65 echo "ok: $p $got"
66done
67
68case "$kind" in
69 deb) apt-get remove -y -qq $PACKAGES ;;
70 rpm) dnf remove -y -q $PACKAGES ;;
71 arch) pacman -R --noconfirm $PACKAGES ;;
72esac
73for p in $PACKAGES; do
74 [[ ! -e "/usr/bin/$p" ]] || fail "/usr/bin/$p staat er na verwijderen nog"
75 [[ ! -e "/usr/lib/systemd/system/$p.service" ]] || fail "$p.service staat er na verwijderen nog"
76done
77echo "== $PRETTY_NAME: installeren, --version, units en verwijderen ok"