Update README with systemd and deb package docs
This commit is contained in:
parent
ca9912f8de
commit
2da5f293b1
52
README.md
52
README.md
|
|
@ -120,6 +120,36 @@ CREATE TABLE random_data (
|
||||||
);
|
);
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## systemd
|
||||||
|
|
||||||
|
Юнит-файл: `deploy/systemd/cards.service`
|
||||||
|
|
||||||
|
```ini
|
||||||
|
[Unit]
|
||||||
|
Description=Cards web server
|
||||||
|
After=network-online.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
User=cards
|
||||||
|
Group=cards
|
||||||
|
ExecStart=/usr/bin/cards /etc/cards/config.json
|
||||||
|
Restart=on-failure
|
||||||
|
AmbientCapabilities=CAP_NET_BIND_SERVICE
|
||||||
|
NoNewPrivileges=yes
|
||||||
|
ProtectSystem=full
|
||||||
|
ProtectHome=yes
|
||||||
|
PrivateTmp=yes
|
||||||
|
```
|
||||||
|
|
||||||
|
Установка вручную:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo cp deploy/systemd/cards.service /usr/lib/systemd/system/
|
||||||
|
sudo systemctl daemon-reload
|
||||||
|
sudo systemctl enable --now cards
|
||||||
|
```
|
||||||
|
|
||||||
## Сборка deb-пакета
|
## Сборка deb-пакета
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|
@ -130,6 +160,26 @@ cpack
|
||||||
|
|
||||||
Результат: `cards-1.0.0-Linux.deb`
|
Результат: `cards-1.0.0-Linux.deb`
|
||||||
|
|
||||||
|
### Содержимое deb-пакета
|
||||||
|
|
||||||
|
| Путь | Назначение |
|
||||||
|
|---|---|
|
||||||
|
| `/usr/bin/cards` | Исполняемый файл |
|
||||||
|
| `/usr/lib/systemd/system/cards.service` | systemd-юнит |
|
||||||
|
| `/etc/cards/config.json.example` | Пример конфигурации |
|
||||||
|
| `/usr/share/doc/cards/LICENSE` | Лицензия |
|
||||||
|
|
||||||
|
### Управляющие скрипты
|
||||||
|
|
||||||
|
При установке deb-пакета (`postinst`):
|
||||||
|
- Создаётся пользователь и группа `cards`
|
||||||
|
- Копируется `/etc/cards/config.json.example` → `/etc/cards/config.json` (если нет)
|
||||||
|
- Сервис `cards` включается и запускается
|
||||||
|
|
||||||
|
При удалении (`prerm`):
|
||||||
|
- Сервис останавливается и отключается
|
||||||
|
|
||||||
## Завершение работы
|
## Завершение работы
|
||||||
|
|
||||||
Для остановки сервера отправьте сигнал `SIGINT` (Ctrl+C) или `SIGTERM`.
|
- Вручную: `Ctrl+C` или `kill` с сигналом `SIGTERM`
|
||||||
|
- systemd: `systemctl stop cards`
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue