BlueGit

timfa bluegit

docs: beschrijf de overstap van de user-unit naar de system-service

De datadisk blijft op /home/timfa/temp-bluegit. Het anonieme archief
is nog niet leesbaar, dus de CI_JOB_TOKEN-fallback blijft.

Co-authored-by: tim <tim@timfalken.com>

timfa project_87923614_bot_3aff574f6f98414b945a8799374f9092 · pushed by timfa

Authored 2026-10-22 · 3 weeks ago

Hash
f64ec713e3a7135ce6d177b15b986e4f7924b6ba
Parent
a47e8c3a
2 files changed +55 −2
docs/AUR.md +4 −2
@@ -20,9 +20,11 @@ De unit is de bestaande system-unit: `User=bluegit`, `ExecStart` met `/etc/blueg
20 20
21 21 `packaging/aur/bluegit.install` draait na installatie en upgrade `systemd-sysusers`, `systemd-tmpfiles --create` en `systemctl daemon-reload`. Hij zet de service niet aan en schrijft `config.yml` niet over. `backup=('etc/bluegit/config.yml')` laat een aangepaste config staan.
22 22
23 De huidige user-unit (`/home/timfa/bluegit/config.yml`, `/home/timfa/bluegit/state`, datadisk `/home/timfa/temp-bluegit`) gaat over naar deze system-service volgens [MIGRATIE.md](MIGRATIE.md). De datadisk blijft waar hij staat.
24
23 25 ## Geheimen
24 26
25 Tim zet deze zelf. De publieke sleutel hoort op aur.archlinux.org, nooit de private sleutel in de repository.
27 De namen zijn 1-op-1 dezelfde als in Posprint. De publieke sleutel hoort op aur.archlinux.org, nooit de private sleutel in de repository.
26 28
27 29 | Naam | Soort | Inhoud |
28 30 | --- | --- | --- |
@@ -37,4 +39,4 @@ De job heet `publish:aur` in `.gitlab-ci.yml` en `publish_aur` in `blue-ci-cd.ym
37 39
38 40 ## Archief moet leesbaar zijn
39 41
40 Een anonieme download van het GitLab-archief gaf 403. De publish-job kan het archief met `CI_JOB_TOKEN` ophalen om de hash te zetten, maar een AUR-gebruiker die `makepkg` draait heeft die token niet. Het project, of in elk geval dat archief-adres, moet publiek leesbaar zijn voordat een installatie vanaf de AUR slaagt.
42 Het project is nog privé. Een anonieme aanvraag van het archief komt uit op de aanmeldpagina, niet op de tarball. De publish-job valt daarom terug op `CI_JOB_TOKEN` om de hash te zetten. Een AUR-gebruiker die `makepkg` draait heeft die token niet. Het project moet publiek zijn voordat een installatie vanaf de AUR slaagt.
@@ -20,9 +20,11 @@ De unit is de bestaande system-unit: `User=bluegit`, `ExecStart` met `/etc/blueg
20
20
21`packaging/aur/bluegit.install` draait na installatie en upgrade `systemd-sysusers`, `systemd-tmpfiles --create` en `systemctl daemon-reload`. Hij zet de service niet aan en schrijft `config.yml` niet over. `backup=('etc/bluegit/config.yml')` laat een aangepaste config staan.
21`packaging/aur/bluegit.install` draait na installatie en upgrade `systemd-sysusers`, `systemd-tmpfiles --create` en `systemctl daemon-reload`. Hij zet de service niet aan en schrijft `config.yml` niet over. `backup=('etc/bluegit/config.yml')` laat een aangepaste config staan.
22
22
23De huidige user-unit (`/home/timfa/bluegit/config.yml`, `/home/timfa/bluegit/state`, datadisk `/home/timfa/temp-bluegit`) gaat over naar deze system-service volgens [MIGRATIE.md](MIGRATIE.md). De datadisk blijft waar hij staat.
24
23## Geheimen
25## Geheimen
24
26
25Tim zet deze zelf. De publieke sleutel hoort op aur.archlinux.org, nooit de private sleutel in de repository.
27De namen zijn 1-op-1 dezelfde als in Posprint. De publieke sleutel hoort op aur.archlinux.org, nooit de private sleutel in de repository.
26
28
27| Naam | Soort | Inhoud |
29| Naam | Soort | Inhoud |
28| --- | --- | --- |
30| --- | --- | --- |
@@ -37,4 +39,4 @@ De job heet `publish:aur` in `.gitlab-ci.yml` en `publish_aur` in `blue-ci-cd.ym
37
39
38## Archief moet leesbaar zijn
40## Archief moet leesbaar zijn
39
41
40Een anonieme download van het GitLab-archief gaf 403. De publish-job kan het archief met `CI_JOB_TOKEN` ophalen om de hash te zetten, maar een AUR-gebruiker die `makepkg` draait heeft die token niet. Het project, of in elk geval dat archief-adres, moet publiek leesbaar zijn voordat een installatie vanaf de AUR slaagt.
42Het project is nog privé. Een anonieme aanvraag van het archief komt uit op de aanmeldpagina, niet op de tarball. De publish-job valt daarom terug op `CI_JOB_TOKEN` om de hash te zetten. Een AUR-gebruiker die `makepkg` draait heeft die token niet. Het project moet publiek zijn voordat een installatie vanaf de AUR slaagt.
docs/MIGRATIE.md added +51 −0
@@ -0,0 +1,51 @@
1 # Van de user-unit naar de system-service
2
3 De AUR-package installeert een system-service: `User=bluegit`, config in `/etc/bluegit/config.yml`, state in `/var/lib/bluegit`. De installatie die nu draait is een user-unit, met config `/home/timfa/bluegit/config.yml`, state `/home/timfa/bluegit/state` en de datadisk `/home/timfa/temp-bluegit`. Die datadisk blijft op die plek. Alleen de service, de config en de state verhuizen.
4
5 Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.
6
7 ```shell
8 systemctl --user stop bluegit
9 systemctl --user disable bluegit
10 ```
11
12 Staat de unit onder een andere naam, stop dan de unit waarvan `ExecStart` `bluegit serve --config /home/timfa/bluegit/config.yml` is.
13
14 Installeer daarna het package. `bluegit.install` maakt de systeemgebruiker `bluegit` en de state-map aan, en herlaadt systemd. Hij zet de service niet aan en overschrijft een bestaande `/etc/bluegit/config.yml` niet.
15
16 Kopieer de state terwijl de user-unit uit staat. `secret.key` hoort bij `bluegit.db`; zonder die sleutel is de database onleesbaar. De SSH-hostkey mee kopiëren houdt `known_hosts` geldig. Het bestand `storage_path` wijst al naar `/home/timfa/temp-bluegit` en blijft zo.
17
18 ```shell
19 install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit
20 cp -a /home/timfa/bluegit/state/. /var/lib/bluegit/
21 chown -R bluegit:bluegit /var/lib/bluegit
22 ```
23
24 Zet de config op de system-plek en verander alleen `state_path`:
25
26 ```shell
27 install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml
28 ```
29
30 In `/etc/bluegit/config.yml` wordt `state_path` `/var/lib/bluegit`. Een `storage_path` in dat bestand is niet nodig: het bestand `/var/lib/bluegit/storage_path` wint. Wijst `client_secret_file` nog naar een bestand onder `/home/timfa`, kopieer dat dan naar `/etc/bluegit/client_secret` (mode `0600`, eigenaar `bluegit`) en pas het pad aan. `ProtectHome=true` verbergt de rest van `/home` voor de service.
31
32 De datadisk blijft `/home/timfa/temp-bluegit`. `ProtectSystem=strict` schrijft alleen naar `/var/lib/bluegit`, en `ProtectHome=true` maakt `/home` onbereikbaar. Een drop-in zet die ene map terug:
33
34 ```shell
35 install -d /etc/systemd/system/bluegit.service.d
36 cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
37 [Service]
38 ReadWritePaths=/home/timfa/temp-bluegit
39 EOF
40 chown -R bluegit:bluegit /home/timfa/temp-bluegit
41 ```
42
43 Daarna:
44
45 ```shell
46 systemctl daemon-reload
47 systemctl enable --now bluegit
48 systemctl status bluegit
49 ```
50
51 Controleer dat de site de bestaande repositories toont en dat een clone van een repo op `/home/timfa/temp-bluegit` slaagt. Laat `/home/timfa/bluegit` staan tot dat klopt. De user-unit blijft uit.
@@ -0,0 +1,51 @@
1# Van de user-unit naar de system-service
2
3De AUR-package installeert een system-service: `User=bluegit`, config in `/etc/bluegit/config.yml`, state in `/var/lib/bluegit`. De installatie die nu draait is een user-unit, met config `/home/timfa/bluegit/config.yml`, state `/home/timfa/bluegit/state` en de datadisk `/home/timfa/temp-bluegit`. Die datadisk blijft op die plek. Alleen de service, de config en de state verhuizen.
4
5Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.
6
7```shell
8systemctl --user stop bluegit
9systemctl --user disable bluegit
10```
11
12Staat de unit onder een andere naam, stop dan de unit waarvan `ExecStart` `bluegit serve --config /home/timfa/bluegit/config.yml` is.
13
14Installeer daarna het package. `bluegit.install` maakt de systeemgebruiker `bluegit` en de state-map aan, en herlaadt systemd. Hij zet de service niet aan en overschrijft een bestaande `/etc/bluegit/config.yml` niet.
15
16Kopieer de state terwijl de user-unit uit staat. `secret.key` hoort bij `bluegit.db`; zonder die sleutel is de database onleesbaar. De SSH-hostkey mee kopiëren houdt `known_hosts` geldig. Het bestand `storage_path` wijst al naar `/home/timfa/temp-bluegit` en blijft zo.
17
18```shell
19install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit
20cp -a /home/timfa/bluegit/state/. /var/lib/bluegit/
21chown -R bluegit:bluegit /var/lib/bluegit
22```
23
24Zet de config op de system-plek en verander alleen `state_path`:
25
26```shell
27install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml
28```
29
30In `/etc/bluegit/config.yml` wordt `state_path` `/var/lib/bluegit`. Een `storage_path` in dat bestand is niet nodig: het bestand `/var/lib/bluegit/storage_path` wint. Wijst `client_secret_file` nog naar een bestand onder `/home/timfa`, kopieer dat dan naar `/etc/bluegit/client_secret` (mode `0600`, eigenaar `bluegit`) en pas het pad aan. `ProtectHome=true` verbergt de rest van `/home` voor de service.
31
32De datadisk blijft `/home/timfa/temp-bluegit`. `ProtectSystem=strict` schrijft alleen naar `/var/lib/bluegit`, en `ProtectHome=true` maakt `/home` onbereikbaar. Een drop-in zet die ene map terug:
33
34```shell
35install -d /etc/systemd/system/bluegit.service.d
36cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
37[Service]
38ReadWritePaths=/home/timfa/temp-bluegit
39EOF
40chown -R bluegit:bluegit /home/timfa/temp-bluegit
41```
42
43Daarna:
44
45```shell
46systemctl daemon-reload
47systemctl enable --now bluegit
48systemctl status bluegit
49```
50
51Controleer dat de site de bestaande repositories toont en dat een clone van een repo op `/home/timfa/temp-bluegit` slaagt. Laat `/home/timfa/bluegit` staan tot dat klopt. De user-unit blijft uit.