ЛР 3 — БПИ2303 — Мартинес — на 4 #171

Open
Mirariel wants to merge 1 commits from Mirariel/mtusi2026lab3:solution/bpi2303-martines into main
First-time contributor

Лабораторная 3 — отчёт

Мартинес Анастасия, БПИ2303. Целевая оценка: 4. Ветка solution/bpi2303-martines.

Запуск

Нужны Docker Compose v2 и Python 3.9+. Из корня репозитория:

python scripts/bootstrap.py
docker compose up -d --build --wait
python -X utf8 scripts/verify.py

API через LB: http://127.0.0.1:8080. Только LB публикует порт.
Остановка: docker compose down; намеренное удаление всех учебных данных:
docker compose down -v. Secrets генерируются в игнорируемом secrets/, .env.
На Linux hooks restart.sh/stop-one.sh исполняемые; на Windows verify выбирает .cmd.
Команды make check/test/test-persistence/test-failover вызывают те же публичные
Python-проверки; BASE_URL=http://127.0.0.1:8080, ACTION_SCRIPT — соответствующий hook.
Полная OpenAPI validation опциональна: requirements-dev.txt + scripts/validate_openapi.py.

Архитектура

Перенесены src, миграции, Dockerfile и bootstrap собственной lab2; skeleton lab3
и публичные проверки сохранены. Python 3.12.8, PostgreSQL 16.6, Redis 7.4.1,
HAProxy 3.0.6, версии Python-библиотек закреплены requirements.txt.
Две API-службы api1/api2, без container_name и sticky session. Общие PostgreSQL
(данные, sessions, idempotency) и Redis (TTL=60, неизменяемые профили).
API по одному Gunicorn worker/4 threads; X-Instance-Id указывает службу.
Архитектура поддерживает отдельное масштабирование, конфигурация LB явно на две реплики.

Идемпотентность: область user+chat+POST+key. Транзакционный advisory lock по
SHA-256 области сериализует одинаковые ключи. Сохранение сообщения и ответа
в одной транзакции. Повтор в течение 24 ч читает сохранённый JSON, иной текст —
409; сессия и доступ проверяются заново. Ошибки не сохраняются как результат.
Параметризованный SQL, индекс истории (chat_id,created_at,id), keyset без OFFSET.
Миграции — один сервис migrate до старта API, версии/checksum и advisory lock.
Rolling experiment заменяет ту же версию; несовместимые миграции требуют отдельного
expand/contract плана, не заявляется поддержка произвольной смены схемы без простоя.

HAProxy: readiness GET /health/ready каждую 1 с, fall=2/rise=1, timeout check/connect=1 с.
Ожидаемое обнаружение сбоя около 2–4 с, проверено восстановление менее 10 с.
Docker DNS resolver обновляет адреса после recreate, hold valid=1 с.
Нет автоматического retry POST на LB. Gunicorn SIGTERM прекращает приём и
даёт запросам 5 с, stop grace=8 с; принудительный тест stop -t2 допускает
оборванный ответ, который клиент повторяет с тем же ключом.
Пулы/SQL timeout и fallback Redis сохранены из lab2. ready зависит от PostgreSQL.
Лимиты API по 1 CPU/384 MiB, PostgreSQL 1 CPU/512 MiB, Redis и LB по 0.5 CPU/128 MiB.

Реальные результаты

19.11.2026, Windows/Docker Desktop, 16 логических CPU; environment/resources в evidence.

  • smoke и persistence: PASS; StartedAt всех запущенных служб до/после в restart.json.
  • публичный failover: 85 успешных записей, 5 переходных ошибок, восстановление 2.406 с.
  • 24 конкурентных запроса через обе реплики: ровно одно сообщение.
  • отказ api1: 89 записей, 8 ошибок, max success gap=1.125 с.
  • отказ api2: 84 записи, 8 ошибок, max success gap=1.141 с.
  • rolling recreate обеих API: 352 записи, 17 переходных ошибок, gap=1.156 с.
    Во всех случаях подтверждённые сообщения сохранены и логические дубли отсутствуют.
  • 30 с closed-loop POST, concurrency=4: 6542 успешных, 0 ошибок, 216.931 RPS;
    p50=16 мс, p95=32 мс, p99=78 мс. CPU/RAM сняты во время нагрузки.
    Сырые данные: evidence/{smoke,persistence,failover,replication}.txt,
    replication.json, restart.json, load.json, resources.json.
    Один повтор, без отдельного фиксированного прогрева; пулы уже прогреты functional tests.
    Closed-loop и latency только успешных запросов не определяют production SLA.

Ограничения и источники

Единственные LB/DB/host — SPOF; отказ всего узла не выдерживается.
Между страницами истории нет snapshot; поздний COMMIT с ранним timestamp может
оказаться позади cursor. Пароли Argon2id, сессии имеют expiry/logout;
HTTP допустим только на loopback с синтетическими данными.
Источники: контракт курса, Flask/Psycopg/Redis/HAProxy. Codex помог написать код,
тесты, провести измерения и оформить отчёт. Оценка 5 не заявляется.

# Лабораторная 3 — отчёт Мартинес Анастасия, БПИ2303. Целевая оценка: **4**. Ветка solution/bpi2303-martines. ## Запуск Нужны Docker Compose v2 и Python 3.9+. Из корня репозитория: ```sh python scripts/bootstrap.py docker compose up -d --build --wait python -X utf8 scripts/verify.py ``` API через LB: http://127.0.0.1:8080. Только LB публикует порт. Остановка: `docker compose down`; намеренное удаление всех учебных данных: `docker compose down -v`. Secrets генерируются в игнорируемом secrets/, .env. На Linux hooks restart.sh/stop-one.sh исполняемые; на Windows verify выбирает .cmd. Команды make check/test/test-persistence/test-failover вызывают те же публичные Python-проверки; BASE_URL=http://127.0.0.1:8080, ACTION_SCRIPT — соответствующий hook. Полная OpenAPI validation опциональна: requirements-dev.txt + scripts/validate_openapi.py. ## Архитектура Перенесены src, миграции, Dockerfile и bootstrap собственной lab2; skeleton lab3 и публичные проверки сохранены. Python 3.12.8, PostgreSQL 16.6, Redis 7.4.1, HAProxy 3.0.6, версии Python-библиотек закреплены requirements.txt. Две API-службы api1/api2, без container_name и sticky session. Общие PostgreSQL (данные, sessions, idempotency) и Redis (TTL=60, неизменяемые профили). API по одному Gunicorn worker/4 threads; X-Instance-Id указывает службу. Архитектура поддерживает отдельное масштабирование, конфигурация LB явно на две реплики. Идемпотентность: область user+chat+POST+key. Транзакционный advisory lock по SHA-256 области сериализует одинаковые ключи. Сохранение сообщения и ответа в одной транзакции. Повтор в течение 24 ч читает сохранённый JSON, иной текст — 409; сессия и доступ проверяются заново. Ошибки не сохраняются как результат. Параметризованный SQL, индекс истории (chat_id,created_at,id), keyset без OFFSET. Миграции — один сервис migrate до старта API, версии/checksum и advisory lock. Rolling experiment заменяет ту же версию; несовместимые миграции требуют отдельного expand/contract плана, не заявляется поддержка произвольной смены схемы без простоя. HAProxy: readiness GET /health/ready каждую 1 с, fall=2/rise=1, timeout check/connect=1 с. Ожидаемое обнаружение сбоя около 2–4 с, проверено восстановление менее 10 с. Docker DNS resolver обновляет адреса после recreate, hold valid=1 с. Нет автоматического retry POST на LB. Gunicorn SIGTERM прекращает приём и даёт запросам 5 с, stop grace=8 с; принудительный тест stop -t2 допускает оборванный ответ, который клиент повторяет с тем же ключом. Пулы/SQL timeout и fallback Redis сохранены из lab2. ready зависит от PostgreSQL. Лимиты API по 1 CPU/384 MiB, PostgreSQL 1 CPU/512 MiB, Redis и LB по 0.5 CPU/128 MiB. ## Реальные результаты 19.11.2026, Windows/Docker Desktop, 16 логических CPU; environment/resources в evidence. - smoke и persistence: PASS; StartedAt всех запущенных служб до/после в restart.json. - публичный failover: 85 успешных записей, 5 переходных ошибок, восстановление 2.406 с. - 24 конкурентных запроса через обе реплики: ровно одно сообщение. - отказ api1: 89 записей, 8 ошибок, max success gap=1.125 с. - отказ api2: 84 записи, 8 ошибок, max success gap=1.141 с. - rolling recreate обеих API: 352 записи, 17 переходных ошибок, gap=1.156 с. Во всех случаях подтверждённые сообщения сохранены и логические дубли отсутствуют. - 30 с closed-loop POST, concurrency=4: 6542 успешных, 0 ошибок, 216.931 RPS; p50=16 мс, p95=32 мс, p99=78 мс. CPU/RAM сняты во время нагрузки. Сырые данные: evidence/{smoke,persistence,failover,replication}.txt, replication.json, restart.json, load.json, resources.json. Один повтор, без отдельного фиксированного прогрева; пулы уже прогреты functional tests. Closed-loop и latency только успешных запросов не определяют production SLA. ## Ограничения и источники Единственные LB/DB/host — SPOF; отказ всего узла не выдерживается. Между страницами истории нет snapshot; поздний COMMIT с ранним timestamp может оказаться позади cursor. Пароли Argon2id, сессии имеют expiry/logout; HTTP допустим только на loopback с синтетическими данными. Источники: контракт курса, Flask/Psycopg/Redis/HAProxy. Codex помог написать код, тесты, провести измерения и оформить отчёт. Оценка 5 не заявляется.
Mirariel added 1 commit 2026-11-20 18:47:52 +03:00
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/Mirariel/mtusi2026lab3 solution/bpi2303-martines:Mirariel-solution/bpi2303-martines
git checkout Mirariel-solution/bpi2303-martines
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#171