BlueGit

timfa bluegit

Files

bluegit / docs / MIGRATIE.md

MIGRATIE.md

docs: beschrijf de overstap van de user-unit naar de system-service
timfa project_87923614_bot_3aff574f6f98414b945a8799374f9092 · pushed by timfa · 3 weeks ago
f64ec713 History
MIGRATIE.md 2.6 KiB Download Raw

Van de user-unit naar de system-service

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.

Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.

systemctl --user stop bluegit
systemctl --user disable bluegit

Staat de unit onder een andere naam, stop dan de unit waarvan ExecStart bluegit serve --config /home/timfa/bluegit/config.yml is.

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.

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.

install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit
cp -a /home/timfa/bluegit/state/. /var/lib/bluegit/
chown -R bluegit:bluegit /var/lib/bluegit

Zet de config op de system-plek en verander alleen state_path:

install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml

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.

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:

install -d /etc/systemd/system/bluegit.service.d
cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
[Service]
ReadWritePaths=/home/timfa/temp-bluegit
EOF
chown -R bluegit:bluegit /home/timfa/temp-bluegit

Daarna:

systemctl daemon-reload
systemctl enable --now bluegit
systemctl status bluegit

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.

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