Пул PostgreSQL с statement_timeout=5000, is_alive(), reconnect мёртвых соединений
Миграции через pg_advisory_lock (однократно, не гонка)
Lab 3
X-Instance-Id — из INSTANCE_ID → HOSTNAME → 8 hex символов; стабилен в пределах жизни процесса
Idempotency-Key — обязателен для POST /api/v1/chats/{id}/messages, ASCII [A-Za-z0-9._:-]{1,128}
Общая идемпотентность — одна транзакция: INSERT messages + INSERT idempotency_keys ... ON CONFLICT (user_id, chat_id, key) DO NOTHING RETURNING message_id. Retry до 3 итераций при гонке. TTL 86400 с.
Nginx OSS без active health checks — готовность определяется реактивно (502/503/504, обрыв соединения). В период drain (2 с) реплика ещё может ответить 201.
Сессии в Valkey с appendfsync everysec — теоретически последняя секунда записи может не попасть на диск при жёстком kill.
tests/load.py — closed-loop, без retry, процентили только успешных. Серия трека 1 — отдельные окна по 30 с при concurrency 50; абсолютный уровень после долгой сессии плавает.
Поле attachment_ids контракт lab3 запрещает (additionalProperties: false). Для lab4 хеш идемпотентности нужно расширить.
SPOF — единственная PostgreSQL, Valkey, Nginx. Несколько API не делают их высокодоступными.
Источники и использование ИИ
Контракт и публичные тесты курса; PostgreSQL 16, Valkey, Nginx, libpqxx, libsodium, hiredis, nlohmann/json.
Помощь ИИ: DeepSeek, Cursor, GigaCode. Чужой прикладной код не копировался.
Чек-лист
Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; вывод в REPORT.md.
Сценарии отказов/безопасности своего уровня воспроизведены (persistence, failover, parallel idempotency).
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3
**Автор / группа:** Никитин Андрей Александрович, БВТ2301
**Целевая оценка (3/4/5):** 5
**Трек:** 1 — Цена масштабирования
---
## Что реализовано и что перенесено
### Из lab2
- Регистрация (`POST /api/v1/users`) — `username` `[a-z0-9_]{3,32}`, `display_name` 1–100 cps, пароль 12–128 cps
- Basic → Bearer авторизация: `POST /api/v1/auth/sessions` принимает `Authorization: Basic <base64(username:password)>`, возвращает `Bearer`-токен (256 бит энтропии через libsodium `randombytes_buf`)
- Пароли хешируются Argon2id (libsodium `crypto_pwhash_str`)
- Сессии в Valkey (AOF `everysec`, TTL 3600 с)
- Чаты: создание с `member_ids`, список для пользователя, получение по ID
- Keyset-пагинация `(created_at, id)` по возрастанию, `limit` 1–100 (default 50)
- Logout: `DELETE /api/v1/auth/sessions/current` → 204, повтор → 401
- Пул PostgreSQL с `statement_timeout=5000`, `is_alive()`, reconnect мёртвых соединений
- Миграции через `pg_advisory_lock` (однократно, не гонка)
### Lab 3
- **X-Instance-Id** — из `INSTANCE_ID` → `HOSTNAME` → 8 hex символов; стабилен в пределах жизни процесса
- **Idempotency-Key** — обязателен для `POST /api/v1/chats/{id}/messages`, ASCII `[A-Za-z0-9._:-]{1,128}`
- **Общая идемпотентность** — одна транзакция: `INSERT messages` + `INSERT idempotency_keys ... ON CONFLICT (user_id, chat_id, key) DO NOTHING RETURNING message_id`. Retry до 3 итераций при гонке. TTL 86400 с.
- **Graceful shutdown** — SIGTERM → `/health/ready`=503 → `DRAIN_SECONDS=2` → `shutdown(fd)` → `join()` воркеров
- **Инфраструктура** — `compose.yaml`: 2 реплики API, Nginx LB, PostgreSQL 16.15, Valkey 8.1.10. CPU/RAM-лимиты, volumes, healthchecks
### Action scripts
- `scripts/stop-one.sh` — останавливает одну API-реплику по `TARGET_INSTANCE_ID` (через `docker inspect` + `docker stop -t 8`)
- `scripts/restart.sh` — перезапуск db → cache → api → lb с ожиданием healthy
---
## Команды запуска из чистого clone
```sh
cp .env.example .env
# В .env задать POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB, SESSION_STORE=redis
mkdir -p secrets
printf 'postgresql://messenger:change_me_locally@db:5432/messenger\n' > secrets/database_url
printf 'redis://cache:6379/0\n' > secrets/cache_url
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
# Дождаться healthy у lb, затем:
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose --env-file .env stop
```
---
## Результаты проверок
| Команда | Результат | Где |
|---|---|---|
| `make check` | PASS — offline skeleton structure, local refs, Python syntax | вывод команды |
| `make test` | PASS — lab3 smoke (registration, auth, chats, messages, idempotency, pagination) | вывод команды |
| `make test-persistence` | PASS — после restart.sh все 5 контейнеров Up/healthy, volumes на месте | вывод команды |
| `make test-failover` | PASS — два прогона (api-2 и api-1), 0 ошибок, recovery ~3.1–3.4 с | вывод команды |
| `student-tests/idempotency_parallel.py` | PASS — 8 потоков → 1 message id, 2 instance id, другой чат независим, другой body → 409 | вывод команды |
| `evidence/load-rolling.json` | 36 с, concurrency 4, 7398 успехов, 0 ошибок, RPS 205.34, p50 11.8 мс, p99 87.6 мс | `evidence/load-rolling.json` |
| Трек 1 — Серия A (1/2/4 реплики) | RPS 350 → 328 → 320; p99 1115 → 404 → 407 мс | `evidence/track1-A-*.json` |
| Трек 1 — Серия B (CPU базы 1/2/4) | RPS 166 → 332 (+100.3%) → 418 (+25.9%); saturation на 4.0 CPU | `evidence/track1-B-*.json` |
Полный отчёт: [REPORT.md](REPORT.md)
---
## Ограничения и известные ошибки
- **Nginx OSS без active health checks** — готовность определяется реактивно (502/503/504, обрыв соединения). В период drain (2 с) реплика ещё может ответить 201.
- **Сессии в Valkey с `appendfsync everysec`** — теоретически последняя секунда записи может не попасть на диск при жёстком kill.
- **`tests/load.py` — closed-loop**, без retry, процентили только успешных. Серия трека 1 — отдельные окна по 30 с при concurrency 50; абсолютный уровень после долгой сессии плавает.
- **Поле `attachment_ids`** контракт lab3 запрещает (`additionalProperties: false`). Для lab4 хеш идемпотентности нужно расширить.
- **SPOF** — единственная PostgreSQL, Valkey, Nginx. Несколько API не делают их высокодоступными.
---
## Источники и использование ИИ
Контракт и публичные тесты курса; PostgreSQL 16, Valkey, Nginx, libpqxx, libsodium, hiredis, nlohmann/json.
Помощь ИИ: DeepSeek, Cursor, GigaCode. Чужой прикладной код не копировался.
---
## Чек-лист
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] `make check` и `make test` выполнены; вывод в REPORT.md.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены (persistence, failover, parallel idempotency).
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Проблемы исследования:
3. Не воспроизводится фиксированный суммарный бюджет RAM исходной серии A. Запуск 1/2/4 API с опубликованными настройками даёт 256/512/1024 MiB суммарной RAM API. Скрипт меняет CPU, но не распределяет память — scripts/run_track1.py:16, compose.yaml:69. Требуется явная конфигурация с постоянной суммой RAM и её проверка через inspect.
4. Базовая конфигурация отчёта не восстанавливается командами сдачи. После документированного build текущий код содержит пул 32 и HTTP-потоки 32, Nginx — auto. Аргументы POOL и NGINX_WORKERS исследовательского скрипта записываются в JSON, но конфигурацию не переключают — scripts/run_track1.py:207. Нужен явный воспроизводимый профиль для заявленных 8/8/1; текущие значения находятся в src/main.cpp:1221, src/main.cpp:1287 и lb/nginx.conf:1.
Проблемы исследования:
3. Не воспроизводится фиксированный суммарный бюджет RAM исходной серии A. Запуск 1/2/4 API с опубликованными настройками даёт 256/512/1024 MiB суммарной RAM API. Скрипт меняет CPU, но не распределяет память — [scripts/run_track1.py:16](https://gitea.privcloud.tech/AndrewNikkk/mtusi2026lab3/src/commit/30d2babc1444713d944adab1a4e96ec61a15d36a/scripts/run_track1.py#L16), [compose.yaml:69](https://gitea.privcloud.tech/AndrewNikkk/mtusi2026lab3/src/commit/30d2babc1444713d944adab1a4e96ec61a15d36a/compose.yaml#L69). Требуется явная конфигурация с постоянной суммой RAM и её проверка через inspect.
4. Базовая конфигурация отчёта не восстанавливается командами сдачи. После документированного build текущий код содержит пул 32 и HTTP-потоки 32, Nginx — auto. Аргументы POOL и NGINX_WORKERS исследовательского скрипта записываются в JSON, но конфигурацию не переключают — [scripts/run_track1.py:207](https://gitea.privcloud.tech/AndrewNikkk/mtusi2026lab3/src/commit/30d2babc1444713d944adab1a4e96ec61a15d36a/scripts/run_track1.py#L207). Нужен явный воспроизводимый профиль для заявленных 8/8/1; текущие значения находятся в [src/main.cpp:1221](https://gitea.privcloud.tech/AndrewNikkk/mtusi2026lab3/src/commit/30d2babc1444713d944adab1a4e96ec61a15d36a/src/main.cpp#L1221), [src/main.cpp:1287](https://gitea.privcloud.tech/AndrewNikkk/mtusi2026lab3/src/commit/30d2babc1444713d944adab1a4e96ec61a15d36a/src/main.cpp#L1287) и [lb/nginx.conf:1](https://gitea.privcloud.tech/AndrewNikkk/mtusi2026lab3/src/commit/30d2babc1444713d944adab1a4e96ec61a15d36a/lb/nginx.conf#L1).
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 3
Автор / группа: Никитин Андрей Александрович, БВТ2301
Целевая оценка (3/4/5): 5
Трек: 1 — Цена масштабирования
Что реализовано и что перенесено
Из lab2
POST /api/v1/users) —username[a-z0-9_]{3,32},display_name1–100 cps, пароль 12–128 cpsPOST /api/v1/auth/sessionsпринимаетAuthorization: Basic <base64(username:password)>, возвращаетBearer-токен (256 бит энтропии через libsodiumrandombytes_buf)crypto_pwhash_str)everysec, TTL 3600 с)member_ids, список для пользователя, получение по ID(created_at, id)по возрастанию,limit1–100 (default 50)DELETE /api/v1/auth/sessions/current→ 204, повтор → 401statement_timeout=5000,is_alive(), reconnect мёртвых соединенийpg_advisory_lock(однократно, не гонка)Lab 3
INSTANCE_ID→HOSTNAME→ 8 hex символов; стабилен в пределах жизни процессаPOST /api/v1/chats/{id}/messages, ASCII[A-Za-z0-9._:-]{1,128}INSERT messages+INSERT idempotency_keys ... ON CONFLICT (user_id, chat_id, key) DO NOTHING RETURNING message_id. Retry до 3 итераций при гонке. TTL 86400 с./health/ready=503 →DRAIN_SECONDS=2→shutdown(fd)→join()воркеровcompose.yaml: 2 реплики API, Nginx LB, PostgreSQL 16.15, Valkey 8.1.10. CPU/RAM-лимиты, volumes, healthchecksAction scripts
scripts/stop-one.sh— останавливает одну API-реплику поTARGET_INSTANCE_ID(черезdocker inspect+docker stop -t 8)scripts/restart.sh— перезапуск db → cache → api → lb с ожиданием healthyКоманды запуска из чистого clone
Результаты проверок
make checkmake testmake test-persistencemake test-failoverstudent-tests/idempotency_parallel.pyevidence/load-rolling.jsonevidence/load-rolling.jsonevidence/track1-A-*.jsonevidence/track1-B-*.jsonПолный отчёт: REPORT.md
Ограничения и известные ошибки
appendfsync everysec— теоретически последняя секунда записи может не попасть на диск при жёстком kill.tests/load.py— closed-loop, без retry, процентили только успешных. Серия трека 1 — отдельные окна по 30 с при concurrency 50; абсолютный уровень после долгой сессии плавает.attachment_idsконтракт lab3 запрещает (additionalProperties: false). Для lab4 хеш идемпотентности нужно расширить.Источники и использование ИИ
Контракт и публичные тесты курса; PostgreSQL 16, Valkey, Nginx, libpqxx, libsodium, hiredis, nlohmann/json.
Помощь ИИ: DeepSeek, Cursor, GigaCode. Чужой прикладной код не копировался.
Чек-лист
make checkиmake testвыполнены; вывод в REPORT.md.30d2babc14toa7f3ab11a7Проблемы исследования:
3. Не воспроизводится фиксированный суммарный бюджет RAM исходной серии A. Запуск 1/2/4 API с опубликованными настройками даёт 256/512/1024 MiB суммарной RAM API. Скрипт меняет CPU, но не распределяет память — scripts/run_track1.py:16, compose.yaml:69. Требуется явная конфигурация с постоянной суммой RAM и её проверка через inspect.
4. Базовая конфигурация отчёта не восстанавливается командами сдачи. После документированного build текущий код содержит пул 32 и HTTP-потоки 32, Nginx — auto. Аргументы POOL и NGINX_WORKERS исследовательского скрипта записываются в JSON, но конфигурацию не переключают — scripts/run_track1.py:207. Нужен явный воспроизводимый профиль для заявленных 8/8/1; текущие значения находятся в src/main.cpp:1221, src/main.cpp:1287 и lb/nginx.conf:1.
Принято. Закрываю МР.
Pull request closed