BlueGit

timfa bluegit

Files

bluegit / docs / MIGRATIE.md

MIGRATIE.md

MIGRATIE.md 4.0 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 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.

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 nog naar /home/timfa/temp-bluegit; dat pad wordt hieronder vervangen.

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.

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.

install -d -o bluegit -g bluegit -m 750 /srv/bluegit
rsync -aHAX /home/timfa/temp-bluegit/ /srv/bluegit/
chown -R bluegit:bluegit /srv/bluegit
printf '%s\n' /srv/bluegit > /var/lib/bluegit/storage_path
chown bluegit:bluegit /var/lib/bluegit/storage_path
chmod 640 /var/lib/bluegit/storage_path

ProtectSystem=strict schrijft alleen naar /var/lib/bluegit. Een drop-in zet /srv/bluegit open. Een pad onder /home hoort hier niet.

install -d /etc/systemd/system/bluegit.service.d
cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
[Service]
ReadWritePaths=/srv/bluegit
EOF

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:

cat > /etc/systemd/system/bluegit.service.d/docker.conf <<'EOF'
[Service]
SupplementaryGroups=docker
EOF

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 /srv/bluegit slaagt. Laat /home/timfa/bluegit en /home/timfa/temp-bluegit staan tot dat klopt. De user-unit blijft uit.

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:

loginctl disable-linger timfa
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`.
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.
6
7Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.
8
9```shell
10systemctl --user stop bluegit
11systemctl --user disable bluegit
12```
13
14Staat de unit onder een andere naam, stop dan de unit waarvan `ExecStart` `bluegit serve --config /home/timfa/bluegit/config.yml` is.
15
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.
17
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.
19
20```shell
21install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit
22cp -a /home/timfa/bluegit/state/. /var/lib/bluegit/
23chown -R bluegit:bluegit /var/lib/bluegit
24```
25
26Zet de config op de system-plek en verander alleen `state_path`:
27
28```shell
29install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml
30```
31
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```
44
45`ProtectSystem=strict` schrijft alleen naar `/var/lib/bluegit`. Een drop-in zet `/srv/bluegit` open. Een pad onder `/home` hoort hier niet.
46
47```shell
48install -d /etc/systemd/system/bluegit.service.d
49cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'
50[Service]
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
61EOF
62```
63
64Daarna:
65
66```shell
67systemctl daemon-reload
68systemctl enable --now bluegit
69systemctl status bluegit
70```
71
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```