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>
@@ -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/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.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
## Geheimen25
## Geheimen26
26
@@ -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-service1
# Van de user-unit naar de system-service2
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
Stop de user-unit eerst. SQLite en de poorten mogen niet door twee processen gedeeld worden.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` `blueg13
15
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.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
```shell20
```shell19
install -d -o bluegit -g bluegit -m 750 /var/lib/bluegit21
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
install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml29
install -o root -g bluegit -m 640 /home/timfa/bluegit/config.yml /etc/bluegit/config.yml28
```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
```shell37
install -d -o bluegit -g bluegit -m 750 /srv/bluegit38
rsync -aHAX /home/timfa/temp-bluegit/ /srv/bluegit/39
chown -R bluegit:bluegit /srv/bluegit40
printf '%s\n' /srv/bluegit > /var/lib/bluegit/storage_path41
chown bluegit:bluegit /var/lib/bluegit/storage_path42
chmod 640 /var/lib/bluegit/storage_path43
```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
```shell47
```shell35
install -d /etc/systemd/system/bluegit.service.d48
install -d /etc/systemd/system/bluegit.service.d36
cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'49
cat > /etc/systemd/system/bluegit.service.d/storage.conf <<'EOF'37
[Service]50
[Service]38
ReadWritePaths=/home/timfa/temp-bluegit51
ReadWritePaths=/srv/bluegit52
EOF53
```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
```shell58
cat > /etc/systemd/system/bluegit.service.d/docker.conf <<'EOF'59
[Service]60
SupplementaryGroups=docker39
EOF61
EOF40
chown -R bluegit:bluegit /home/timfa/temp-bluegit41
```62
```42
63
43
Daarna:64
Daarna:@@ -48,4 +69,10 @@ systemctl enable --now bluegit48
systemctl status bluegit69
systemctl status bluegit49
```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
```shell77
loginctl disable-linger timfa78
```@@ -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.target7
Type=simple7
Type=simple8
User=bluegit8
User=bluegit9
Group=bluegit9
Group=bluegit10
# Steve praat met de Docker-socket (root:docker). Zonder deze groep start geen job.10
SupplementaryGroups=docker11
SupplementaryGroups=docker11
EnvironmentFile=-/etc/bluegit/secret.env12
EnvironmentFile=-/etc/bluegit/secret.env12
ExecStart=/usr/bin/bluegit serve --config /etc/bluegit/config.yml13
ExecStart=/usr/bin/bluegit serve --config /etc/bluegit/config.yml@@ -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.conf1
# Zet dit neer als /etc/systemd/system/bluegit.service.d/storage.conf2
# 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 bluegit6
# Daarna: systemctl daemon-reload && systemctl restart bluegit5
[Service]7
[Service]6
ReadWritePaths=/pad/van/de/datadisk8
ReadWritePaths=/pad/van/de/datadisk