186 lines
4.2 KiB
Markdown
186 lines
4.2 KiB
Markdown
# cards
|
||
|
||
Веб-сервер на C++20 с использованием Boost.Beast и PostgreSQL. Отдаёт случайные записи из базы данных по REST API.
|
||
|
||
## Требования
|
||
|
||
- Компилятор с поддержкой C++20 (GCC 10+, Clang 10+)
|
||
- CMake >= 3.14
|
||
- PostgreSQL (runtime) + libpq + libpqxx >= 7.0
|
||
- Boost (system)
|
||
- nlohmann_json 3.x
|
||
|
||
Установка зависимостей (Debian/Ubuntu):
|
||
|
||
```bash
|
||
sudo apt-get install libboost-all-dev libpq-dev libpqxx-dev nlohmann-json3-dev cmake build-essential
|
||
```
|
||
|
||
## Сборка
|
||
|
||
```bash
|
||
./configure.sh
|
||
```
|
||
|
||
Или вручную:
|
||
|
||
```bash
|
||
mkdir -p build && cd build
|
||
cmake ..
|
||
make -j"$(nproc)"
|
||
cd ..
|
||
```
|
||
|
||
Бинарник: `build/bin/cards`
|
||
|
||
## Конфигурация
|
||
|
||
По умолчанию читает `config.json` из рабочей директории. Можно указать путь к другому файлу:
|
||
|
||
```bash
|
||
./build/bin/cards /path/to/config.json
|
||
```
|
||
|
||
### Поля `config.json`
|
||
|
||
**server**
|
||
| Поле | Тип | Значение по умолчанию |
|
||
|---|---|---|
|
||
| address | string | `"0.0.0.0"` |
|
||
| port | int | `8080` |
|
||
| threads | int | `4` |
|
||
|
||
**database**
|
||
| Поле | Тип | Значение по умолчанию |
|
||
|---|---|---|
|
||
| host | string | `"localhost"` |
|
||
| port | int | `5432` |
|
||
| dbname | string | `"testdb"` |
|
||
| user | string | `"postgres"` |
|
||
| password | string | (пусто) |
|
||
|
||
### Переменные окружения
|
||
|
||
Переопределяют соответствующие поля `config.json`:
|
||
|
||
- `DB_HOST`
|
||
- `DB_PORT`
|
||
- `DB_NAME`
|
||
- `DB_USER`
|
||
- `DB_PASSWORD`
|
||
|
||
Пример:
|
||
|
||
```bash
|
||
DB_PASSWORD=secret ./build/bin/cards
|
||
```
|
||
|
||
## API
|
||
|
||
| Метод | Путь | Описание |
|
||
|---|---|---|
|
||
| GET | `/` | Случайная запись из таблицы `random_data` |
|
||
| GET | `/health` | Проверка состояния сервера |
|
||
|
||
### Пример ответа `GET /`
|
||
|
||
```json
|
||
{
|
||
"id": 3,
|
||
"name": "Gamma",
|
||
"value": 300,
|
||
"description": "Third test record",
|
||
"created_at": "2025-01-01 12:00:00",
|
||
"timestamp": 1735732800000000000
|
||
}
|
||
```
|
||
|
||
### Пример ответа `GET /health`
|
||
|
||
```json
|
||
{
|
||
"status": "ok",
|
||
"timestamp": 1735732800000000000
|
||
}
|
||
```
|
||
|
||
## База данных
|
||
|
||
При первом запуске автоматически создаётся таблица `random_data` и заполняется десятью тестовыми записями.
|
||
|
||
Схема таблицы:
|
||
|
||
```sql
|
||
CREATE TABLE random_data (
|
||
id SERIAL PRIMARY KEY,
|
||
name VARCHAR(100) NOT NULL,
|
||
value INTEGER NOT NULL,
|
||
description TEXT,
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||
);
|
||
```
|
||
|
||
## 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-пакета
|
||
|
||
```bash
|
||
cd build
|
||
cmake ..
|
||
cpack
|
||
```
|
||
|
||
Результат: `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`):
|
||
- Сервис останавливается и отключается
|
||
|
||
## Завершение работы
|
||
|
||
- Вручную: `Ctrl+C` или `kill` с сигналом `SIGTERM`
|
||
- systemd: `systemctl stop cards`
|