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