bukova_info/content/systemd_service.md

+++ title = "Servis v systemd" description = "Jak vyrobit z binárky systemd daemona" date = 2021-02-04 draft = false slug = "systemd-service"

[taxonomies] categories = ["linux"] tags = ["systemd", "administrace"] +++

Pokud potřebujeme spouštět program jako službu, na distribucích se systemd musíme vytvořit konfigurační soubor s popisem služby. Výhoda je, že lze jako daemona použít i normální binárka, kde se neřeší daemonizace forkem.

Konfigurák vytvoříme v /etc/systmd/system/foo-daemon.service s obsahem:

[Unit]
Description=Foo

[Service]
ExecStart=/usr/sbin/foo-daemon

[Install]
WantedBy=multi-user.target

Až je to hotové, je potřeba přenačíst služby příkazem:

$ sudo systemctl daemon-reload

Pak se dá služba ovládat přes systemctl:

$ sudo systemctl start foo-daemon
$ sudo systemctl stop foo-daemon
$ sudo systemctl restart foo-daemon
$ systemctl status foo-daemon

A vypsat log přes journalctl:

$ journalctl -u foo-daemon

Sekce konfiguráku

[Unit] - popis služby

Parametr	Popis
Description	Krátký popis služby
Documentation	Seznam URI odkazů na dokumentaci
Before, After	Pořadí startu služeb
Requires	Pokud bude aktivována tato služba, aktivují se i služby v tomto seznamu
Wants	Slabší závislosti, než v parametru Requires. Pokud se nezdaří start některé služby z tohoto seznamu, služba se přesto nastartuje
Conflicts	Seznam konfliktních služeb

[Unit] - konfigurace instalace

Parametr	Popis
Alias	Alias služby
RequiredBy, WantedBy	Služba nastartuje, pokud budou nastartovány všechny služby z tohoto seznamu. Viz Requires a Wants v sekci Unit
Also	Seznam služeb, které budou povoleny nebo zakázány zároveň s touto službou (systemctl enable, systemctl disable)

[Service] - konfigurace startu

Parametr	Popis
Type	Způsob spouštění služby
	simple (výchozí)- spustit, jak je definováno v parametru ExecStart
	forking- služba je spuštěná, až dojde k forku a skončí rodičovský proces
	oneshot - podobné jako simple, ale předpokládá se, že proces skončí než se budou startovat následující služby. Lze definovat RemainAfterExit=yes, pak se předpokládá, že je služba aktivní, i když proces už skončil
	dbus- podobné jako simple, ale služba se považuje za spuštěnou, až dostane D-Bus jméno
	notify- podobné jako simple, ale služba se považuje za spuštěnou, až pošle signál systemd
	idle- spuštění služby je odloženo až doběhnou všechny úlohy
ExecStart	Příkaz i s argumenty pro spuštění služby.
ExecStop	Příkaz pro zastavení služby
ExecReload	Příkaz pro přenačtení konfigurace
Restart	Pokud je zadán tento parametr, služba je restartována v případě, že se ukončí nebo spadne. Při ukončení přes systemctl stop k restartu nedojde
RemainAfterExit	Pokud je nastaveno na True, služba je považována za spuštěnou, i když skončí proces

Přiklady konfigurace

[Unit]
Description=The NGINX HTTP and reverse proxy server
After=syslog.target network.target remote-fs.target nss-lookup.target

[Service]
Type=forking
PIDFile=/run/nginx.pid
ExecStartPre=/usr/sbin/nginx -t
ExecStart=/usr/sbin/nginx
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

[Unit]
Description=The Apache HTTP Server
After=network.target remote-fs.target nss-lookup.target

[Service]
Type=notify
EnvironmentFile=/etc/sysconfig/httpd
ExecStart=/usr/sbin/httpd $OPTIONS -DFOREGROUND
ExecReload=/usr/sbin/httpd $OPTIONS -k graceful
ExecStop=/bin/kill -WINCH ${MAINPID}
KillSignal=SIGCONT
PrivateTmp=true

[Install]
WantedBy=multi-user.target

[Unit]
Description=Redis persistent key-value database
After=network.target

[Service]
ExecStart=/usr/bin/redis-server /etc/redis.conf --daemonize no
ExecStop=/usr/bin/redis-shutdown
User=redis
Group=redis

[Install]
WantedBy=multi-user.target