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>
@@ -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/blueg20
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
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
## Geheimen25
## Geheimen24
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
| 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.ym37
39
38
## Archief moet leesbaar zijn40
## Archief moet leesbaar zijn39
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.@@ -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-service2
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
```shell8
systemctl --user stop bluegit9
systemctl --user disable bluegit10
```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
```shell19
install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit20
cp -a /home/timfa/bluegit/state/. /var/lib/bluegit/21
chown -R bluegit:bluegit /var/lib/bluegit22
```23
24
Zet de config op de system-plek en verander alleen `state_path`:25
26
```shell27
install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml28
```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
```shell35
install -d /etc/systemd/system/bluegit.service.d36
cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'37
[Service]38
ReadWritePaths=/home/timfa/temp-bluegit39
EOF40
chown -R bluegit:bluegit /home/timfa/temp-bluegit41
```42
43
Daarna:44
45
```shell46
systemctl daemon-reload47
systemctl enable --now bluegit48
systemctl status bluegit49
```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.