BlueGit

timfa bluegit

docs: verhuis de datadisk naar /srv/bluegit

ProtectHome maakt ReadWritePaths onder /home zinloos, en de gebruiker
bluegit kan /home/timfa niet in. De migratie kopieert met rsync -aHAX
naar /srv/bluegit, werkt storage_path bij en zet linger uit.

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

timfa tim · pushed by timfa

Authored 2026-10-22 · 3 weeks ago

Hash
67d7d3bd9aa738dfdce68dade4bd9bd333df3dce
Parent
02cab899
Pipeline
Failed
4 files changed +38 −8
docs/AUR.md +1 −1
@@ -20,7 +20,7 @@ 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.
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 verhuist naar `/srv/bluegit`; een pad onder `/home` blijft met `ProtectHome=true` onbereikbaar.
24 24
25 25 ## Geheimen
26 26
@@ -20,7 +20,7 @@ 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.
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 verhuist naar `/srv/bluegit`; een pad onder `/home` blijft met `ProtectHome=true` onbereikbaar.
24
24
25## Geheimen
25## Geheimen
26
26
docs/MIGRATIE.md +34 −7
@@ -1,6 +1,8 @@
1 1 # Van de user-unit naar de system-service
2 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.
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`.
4
5 Die datadisk kan niet op die plek blijven. `ProtectHome=true` maakt `/home` ontoegankelijk voor de service, en `ReadWritePaths` opent daar geen gat in. De gebruiker `bluegit` kan `/home/timfa` bovendien niet in. Verhuis de datadisk naar `/srv/bluegit`. Daar wordt straks de 4 TB-schijf gemount. Het pad in `storage_path` blijft dan hetzelfde.
4 6
5 7 Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.
6 8
@@ -13,7 +15,7 @@ Staat de unit onder een andere naam, stop dan de unit waarvan `ExecStart` `blueg
13 15
14 16 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 17
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.
18 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 nog naar `/home/timfa/temp-bluegit`; dat pad wordt hieronder vervangen.
17 19
18 20 ```shell
19 21 install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit
@@ -27,17 +29,36 @@ Zet de config op de system-plek en verander alleen `state_path`:
27 29 install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml
28 30 ```
29 31
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.
32 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.
33
34 Verhuis de datadisk terwijl beide services uit staan. `rsync -aHAX` houdt hardlinks, permissies, xattrs en ACLs. De kopie erft de eigenaar `timfa`; `chown` zet ze daarna op `bluegit`. Hangt de 4 TB-schijf er al, mount die dan eerst op `/srv/bluegit`, zodat de kopie op die schijf landt.
35
36 ```shell
37 install -d -o bluegit -g bluegit -m 750 /srv/bluegit
38 rsync -aHAX /home/timfa/temp-bluegit/ /srv/bluegit/
39 chown -R bluegit:bluegit /srv/bluegit
40 printf '%s\n' /srv/bluegit > /var/lib/bluegit/storage_path
41 chown bluegit:bluegit /var/lib/bluegit/storage_path
42 chmod 640 /var/lib/bluegit/storage_path
43 ```
31 44
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:
45 `ProtectSystem=strict` schrijft alleen naar `/var/lib/bluegit`. Een drop-in zet `/srv/bluegit` open. Een pad onder `/home` hoort hier niet.
33 46
34 47 ```shell
35 48 install -d /etc/systemd/system/bluegit.service.d
36 49 cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
37 50 [Service]
38 ReadWritePaths=/home/timfa/temp-bluegit
51 ReadWritePaths=/srv/bluegit
52 EOF
53 ```
54
55 De runner Steve start Docker. De socket hoort bij de groep `docker`. De unit in het package zet daarom `SupplementaryGroups=docker`; de gebruiker `bluegit` hoeft zelf niet in die groep. Zonder die regel kan Steve geen job draaien. `systemctl cat bluegit` hoort de regel te tonen. Ontbreekt hij op een oudere unit, zet hem dan in een drop-in:
56
57 ```shell
58 cat > /etc/systemd/system/bluegit.service.d/docker.conf <<'EOF'
59 [Service]
60 SupplementaryGroups=docker
39 61 EOF
40 chown -R bluegit:bluegit /home/timfa/temp-bluegit
41 62 ```
42 63
43 64 Daarna:
@@ -48,4 +69,10 @@ systemctl enable --now bluegit
48 69 systemctl status bluegit
49 70 ```
50 71
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.
72 Controleer dat de site de bestaande repositories toont en dat een clone van een repo op `/srv/bluegit` slaagt. Laat `/home/timfa/bluegit` en `/home/timfa/temp-bluegit` staan tot dat klopt. De user-unit blijft uit.
73
74 Linger stond aan zodat die user-unit bleef draaien na het uitloggen. De system-service heeft dat niet nodig. Zet linger uit zodra er geen andere user-service van timfa meer moet blijven draaien:
75
76 ```shell
77 loginctl disable-linger timfa
78 ```
@@ -1,6 +1,8 @@
1# Van de user-unit naar de system-service
1# Van de user-unit naar de system-service
2
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.
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`.
4
5Die datadisk kan niet op die plek blijven. `ProtectHome=true` maakt `/home` ontoegankelijk voor de service, en `ReadWritePaths` opent daar geen gat in. De gebruiker `bluegit` kan `/home/timfa` bovendien niet in. Verhuis de datadisk naar `/srv/bluegit`. Daar wordt straks de 4 TB-schijf gemount. Het pad in `storage_path` blijft dan hetzelfde.
4
6
5Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.
7Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.
6
8
@@ -13,7 +15,7 @@ Staat de unit onder een andere naam, stop dan de unit waarvan `ExecStart` `blueg
13
15
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.
16Installeer 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
17
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.
18Kopieer 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 nog naar `/home/timfa/temp-bluegit`; dat pad wordt hieronder vervangen.
17
19
18```shell
20```shell
19install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit
21install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit
@@ -27,17 +29,36 @@ Zet de config op de system-plek en verander alleen `state_path`:
27install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml
29install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml
28```
30```
29
31
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.
32In `/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.
33
34Verhuis de datadisk terwijl beide services uit staan. `rsync -aHAX` houdt hardlinks, permissies, xattrs en ACLs. De kopie erft de eigenaar `timfa`; `chown` zet ze daarna op `bluegit`. Hangt de 4 TB-schijf er al, mount die dan eerst op `/srv/bluegit`, zodat de kopie op die schijf landt.
35
36```shell
37install -d -o bluegit -g bluegit -m 750 /srv/bluegit
38rsync -aHAX /home/timfa/temp-bluegit/ /srv/bluegit/
39chown -R bluegit:bluegit /srv/bluegit
40printf '%s\n' /srv/bluegit > /var/lib/bluegit/storage_path
41chown bluegit:bluegit /var/lib/bluegit/storage_path
42chmod 640 /var/lib/bluegit/storage_path
43```
31
44
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:
45`ProtectSystem=strict` schrijft alleen naar `/var/lib/bluegit`. Een drop-in zet `/srv/bluegit` open. Een pad onder `/home` hoort hier niet.
33
46
34```shell
47```shell
35install -d /etc/systemd/system/bluegit.service.d
48install -d /etc/systemd/system/bluegit.service.d
36cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
49cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
37[Service]
50[Service]
38ReadWritePaths=/home/timfa/temp-bluegit
51ReadWritePaths=/srv/bluegit
52EOF
53```
54
55De runner Steve start Docker. De socket hoort bij de groep `docker`. De unit in het package zet daarom `SupplementaryGroups=docker`; de gebruiker `bluegit` hoeft zelf niet in die groep. Zonder die regel kan Steve geen job draaien. `systemctl cat bluegit` hoort de regel te tonen. Ontbreekt hij op een oudere unit, zet hem dan in een drop-in:
56
57```shell
58cat > /etc/systemd/system/bluegit.service.d/docker.conf <<'EOF'
59[Service]
60SupplementaryGroups=docker
39EOF
61EOF
40chown -R bluegit:bluegit /home/timfa/temp-bluegit
41```
62```
42
63
43Daarna:
64Daarna:
@@ -48,4 +69,10 @@ systemctl enable --now bluegit
48systemctl status bluegit
69systemctl status bluegit
49```
70```
50
71
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.
72Controleer dat de site de bestaande repositories toont en dat een clone van een repo op `/srv/bluegit` slaagt. Laat `/home/timfa/bluegit` en `/home/timfa/temp-bluegit` staan tot dat klopt. De user-unit blijft uit.
73
74Linger stond aan zodat die user-unit bleef draaien na het uitloggen. De system-service heeft dat niet nodig. Zet linger uit zodra er geen andere user-service van timfa meer moet blijven draaien:
75
76```shell
77loginctl disable-linger timfa
78```
packaging/bluegit.service +1 −0
@@ -7,6 +7,7 @@ Wants=network-online.target
7 7 Type=simple
8 8 User=bluegit
9 9 Group=bluegit
10 # Steve praat met de Docker-socket (root:docker). Zonder deze groep start geen job.
10 11 SupplementaryGroups=docker
11 12 EnvironmentFile=-/etc/bluegit/secret.env
12 13 ExecStart=/usr/bin/bluegit serve --config /etc/bluegit/config.yml
@@ -7,6 +7,7 @@ Wants=network-online.target
7Type=simple
7Type=simple
8User=bluegit
8User=bluegit
9Group=bluegit
9Group=bluegit
10# Steve praat met de Docker-socket (root:docker). Zonder deze groep start geen job.
10SupplementaryGroups=docker
11SupplementaryGroups=docker
11EnvironmentFile=-/etc/bluegit/secret.env
12EnvironmentFile=-/etc/bluegit/secret.env
12ExecStart=/usr/bin/bluegit serve --config /etc/bluegit/config.yml
13ExecStart=/usr/bin/bluegit serve --config /etc/bluegit/config.yml
packaging/storage.conf +2 −0
@@ -1,6 +1,8 @@
1 1 # Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf
2 2 # vóórdat de beheerder het pad in de webinterface opslaat.
3 3 # Vervang het pad door de datadisk. Er is geen standaardpad.
4 # Geen pad onder /home of /root: ProtectHome=true houdt die bomen dicht,
5 # en ReadWritePaths zet ze niet terug. /srv/bluegit is een bruikbaar pad.
4 6 # Daarna: systemctl daemon-reload && systemctl restart bluegit
5 7 [Service]
6 8 ReadWritePaths=/pad/van/de/datadisk
@@ -1,6 +1,8 @@
1# Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf
1# Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf
2# vóórdat de beheerder het pad in de webinterface opslaat.
2# vóórdat de beheerder het pad in de webinterface opslaat.
3# Vervang het pad door de datadisk. Er is geen standaardpad.
3# Vervang het pad door de datadisk. Er is geen standaardpad.
4# Geen pad onder /home of /root: ProtectHome=true houdt die bomen dicht,
5# en ReadWritePaths zet ze niet terug. /srv/bluegit is een bruikbaar pad.
4# Daarna: systemctl daemon-reload && systemctl restart bluegit
6# Daarna: systemctl daemon-reload && systemctl restart bluegit
5[Service]
7[Service]
6ReadWritePaths=/pad/van/de/datadisk
8ReadWritePaths=/pad/van/de/datadisk