Files
mtusi2026lab3/docs/SPEC.md
T

37 lines
9.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Спецификация лабораторной 3
Цель: уровни 3 и 4, полный трек 5.1 «Цена масштабирования». Основа — собственное решение lab2, контракт lab3 сохранён. Основной способ развёртывания — Kubernetes по требованию проекта; формальное принятие замены Compose/Swarm преподавателем не подтверждено.
| ID | Требование и приёмка |
| --- | --- |
| L3-01 | Две и более API-реплики за LB; единая сессия, стабильный X-Instance-Id на всех ответах; smoke через LB |
| L3-02 | Идемпотентность сообщения на 24 часа: user/chat/key, валидный ASCII 1–128, 201 того же Message, 409 при другом body; конкурентные повторы и rollback в настоящей PostgreSQL |
| L3-03 | Общий ключ cursor, сессии и limiter; пагинация и повтор работают при смене реплики |
| L3-04 | Миграции отдельной командой/Job с advisory lock; API только проверяет версию схемы; повтор миграций безопасен |
| L3-05 | Readiness, SIGTERM/drain, LB health checks; остановка каждой реплики, восстановление <=10 секунд; rolling update под нагрузкой; сохранность после полного рестарта |
| L3-06 | Helm в dev / highload-applications, существующий release lab2; имена api/postgres/valkey и PVC сохраняются; Traefik Ingress hl.agapov.space, TLS letsencrypt-prod; CPU/RAM requests/limits, закрытые API-порты |
| L3-07 | HPA autoscaling/v2 по CPU metrics-server, min 2/max 4, стабилизация; /metrics и готовые настройки Prometheus/Grafana без установки Grafana |
| L3-08 | Трек 5.1: 1/2/4 реплики при фиксированном общем CPU/RAM и растущих ресурсах, одинаковый профиль, raw RPS/errors/latency/resource data, графики, измеренный предел и подтверждённое улучшение |
| L3-09 | Go conventions, DIP, gofmt/lint/vet/race, >=90% statements в каждом исполняемом файле, CI |
| L3-10 | Timeweb Cloud Registry: токен из локального файла, Docker login через stdin, Kubernetes imagePullSecret; секреты не попадают в Git или Helm values; образ фиксируется digest |
Вне объёма: HA PostgreSQL и Valkey, отказ чужих узлов, развёртывание Grafana, реализация lab4+. Секреты не хранятся в Git. Эксперименты затрагивают учебный release lab2, обновлённый реализацией lab3. HPA отключается на время контролируемого сравнения реплик; после эксперимента возвращается.
## Приёмка исправлений 29.10.2026
- L3-01: ошибки HTTP-парсера до middleware, включая 413, содержат стабильный X-Instance-Id и согласованный X-Request-Id. Проверка настоящим HTTP-запросом с превышением BodyLimit.
- L3-05: сохранить исходные имена/UID двух API; остановить каждую отдельно, восстановив две готовые реплики между отказами. Проверять через Traefik чтение, запись, повтор ключа и сохранность подтверждений; сохранить ошибки и время восстановления.
- L3-08: одинаковый профиль для шести конфигураций, ограниченный прогрев и измерение, отдельные счётчики успешных операций/ошибок/latency, CPU/RAM и ожидания PostgreSQL. Дополнительная серия интенсивности выявляет предел, A/B проверяет одно изменение при равных ресурсах. Нулевые и отрицательные результаты публикуются без подмены прогнозом.
Методика L3-08: 16 синтетических пользователей с отдельными чатами, 32 VU; 5 секунд прогрева, 5 секунд дренирования, 30 секунд измерения без graceful-продления нагрузки. Сравнение fixed1/2/4 и growing1/2/4; затем 8/64 VU на четырёх репликах. Гипотеза улучшения: увеличение ограниченного пула зависимостей 8 → 32 уменьшит ожидание при неизменных CPU/RAM; проверка A/B/A/B, отрицательный результат также сохраняется. Данные каждого профиля — новые отдельные чаты без очистки чужих записей.
Уточнение методики после неуспешного setup fixed4: подготовка допускает до пяти попыток на синтетического участника, каждый раз с новым именем; частично подготовленные участники не используются в нагрузке. Ошибки setup видны в raw log, измеряемые запросы не получают автоматических повторов (кроме предусмотренной проверки Idempotency-Key). Серии интенсивности и A/B пула проводятся на одной API с 1000m/512Mi, чтобы проверить именно ограничение пула 8 против 32; fixed1 служит первым A, далее B/A/B. Шесть основных профилей заново измеряются с одной версией workload.
Контроль A/B: при необходимости повторов BENCHMARK_NODE=dev.asisti.tech фиксирует одну API на той же ноде для всех четырёх прогонов, сохраняя CPU/RAM, workload, БД и Valkey. В обычном развёртывании nodeSelector отсутствует; исходная конфигурация восстанавливается. Это устраняет смену аппаратной платформы как объяснение различия размеров пула.
L3-05 / L3-08: проверка гипотезы readiness. PostgreSQL Ping и Valkey Ping используют отдельные последовательные бюджеты по 2 с, а прежняя readinessProbe имеет timeout 2 с. Сравнение A/B/A/B: 2 с / 2 ошибки против 5 с / 1 ошибка при неизменных 1 API, 1000m/512Mi, pool=8, 32 VU и ноде dev.asisti.tech. Новый вариант допускает завершение ограниченной проверки, сохраняя оценку обнаружения примерно до 7 с (период 2 + timeout 5), плюс распространение EndpointSlice. Выбор штатного варианта зависит от измерения и повторного failover.
Контроль фактической конфигурации: HPA сначала отключается отдельным Helm-обновлением, затем завершается его возможная текущая reconciliation. До старта Job сравниваются ожидаемые replicas из Helm values и реальные spec.replicas Deployment. Несовпадение останавливает опыт. Анализатор также исключает ранее полученные прогоны с несовпадением; заданное значение в команде не считается доказательством фактического числа API.
L3-08: подтверждение ресурсного улучшения проводится отдельным A/B/A/B на одной ноде: две API, pool=8, 32 VU, readiness 2 с / 2 ошибки; A — по 250m/128Mi, B — по 500m/256Mi. Меняется только бюджет API; PostgreSQL, Valkey, Traefik и сценарий одинаковые. Не считать увеличение connection pool или probe timeout улучшением, если успешный RPS вырос ценой большей доли ошибок. Штатные значения pool=8 и readiness 2/2 сохраняются.