# Лабораторная 3 Агапов Владислав, БПИ2303. База: текущая lab2 (8173f70), отдельный базовый коммит lab3 a57cbcf. Требования и статус: [SPEC](docs/SPEC.md), [PLAN](docs/PLAN.md). ## Запуск Основной стенд: Kubernetes dev, namespace highload-applications, существующий release lab2. Публичная точка входа: https://hl.agapov.space через установленный Traefik. TLS: cert-manager ClusterIssuer letsencrypt-prod. PostgreSQL и три Valkey сохраняют прежние PVC. Новый release lab3 не требуется. Нужны Helm, kubectl, Docker buildx, jq, OpenSSL, curl. Для проверки: Go 1.26.1+, golangci-lint; Python 3 используется публичными тестами и построением графиков (matplotlib); управление стендом — shell/Helm. В кластере нужны Traefik, cert-manager, default StorageClass и metrics-server. Образы PostgreSQL 17.6-alpine, Valkey 8.1.3-alpine, k6 1.3.0 закреплены в chart. ```sh make init make chart-check make deploy make ready make test make test-idempotency make test-failover ACTION_SCRIPT=scripts/stop-one.sh make test-persistence ACTION_SCRIPT=scripts/restart.sh ``` make init читает ~/.secrets/twc-registry-token, обновляет registry-pull и сохраняет пароль messenger-secrets. При отсутствии добавляет общий cursor-key. При bootstrap создаёт пароль БД. Chart описывает API, PostgreSQL, Valkey, миграции, HPA, NetworkPolicy и Ingress. ```sh make build-push make deploy IMAGE_DIGEST="$(jq -r '."containerimage.digest"' evidence/image-build.json)" ``` Для повторяемого запуска новой версии записать digest в charts/messenger/values.yaml. Не удалять PVC и не создавать параллельный release для обновления. ## Поведение Две и более взаимозаменяемые API-реплики, X-Instance-Id равен имени pod. Общие сессии PostgreSQL и ключ cursor позволяют переключать реплики без повторного входа. POST сообщения требует Idempotency-Key; повтор возвращает исходное сообщение, другой текст — 409. Запись и ключ фиксируются атомарно. Миграции выполняет отдельный Job, API проверяет схему. Отказ БД возвращает 503 без раскрытия внутренних деталей. [Архитектура](ARCHITECTURE.md) описывает readiness, graceful shutdown и HPA. Подготовлены [scrape](infra/monitoring/prometheus-scrape.yaml) и [dashboard](infra/monitoring/grafana-dashboard.json); импорт в Grafana не заявляется. ## Проверки исправлений 29.10.2026 - 413 при превышении BodyLimit содержит X-Instance-Id и согласованный X-Request-Id. Проверены настоящий TCP listener и публичный HTTPS: [результаты](evidence/review-20261029/README.md). - Последовательно остановлены обе исходные API: восстановление 0.190 с и 2.547 с, подтверждённые сообщения и прежние сессии сохранены. Краткие ошибки операций (5 и 7) измерены, а не скрыты. Имена/UID целей, события записи и Kubernetes delete сохранены. - После восстановления публичный smoke прошёл. Race, интеграционные PostgreSQL/Valkey и настоящий процесс/SIGTERM прошли; каждый из 59 исполняемых Go-файлов имеет не менее 90% покрытия. Lint, vet и контракт проверены. - Исследование масштабирования, насыщение и повторные A/B описаны в [RESEARCH](docs/RESEARCH.md). Таблицы и графики получены из raw k6, фактические replicas проверены по Deployment. Несостоявшиеся и некорректные прогоны исключены с сохранением причин. Ранее подтверждённые конкурентная идемпотентность, persistence и stop/pause PostgreSQL/Valkey находятся в evidence/shared-*. Это исторические проверки 16.10.2026, а не новые прогоны. Файлы старых экспериментальных стендов не заменяют свежие доказательства. ## Ограничения Используется Kubernetes вместо перечисленных в задании Compose/Swarm; принятие этой замены преподавателем отдельно не подтверждено. PostgreSQL и Valkey не реплицированы: отказ узла с локальным PVC не покрывается. Метрики и подготовленный dashboard не означают, что Grafana настроена. Результаты получены на общем dev-кластере с неоднородными нодами и сетевыми сбоями. Пределы и исключённые точки указаны в исследовании; оценку определяет преподаватель. Источники: README, COURSE, contracts текущей лабораторной, собственная lab2. Codex использован для реализации, проверки и документации. Финальная проверка после всех экспериментов: rollout завершился, но два внешних smoke получили connection/TLS failure. Их логи сохранены в evidence/review-20261029/final-smoke*.txt. Успешный smoke-after относится к более раннему состоянию после проверки обоих отказов; текущая стабильность внешнего доступа не подтверждена.