6.4 KiB
Лабораторная 3
Агапов Владислав, БПИ2303. База: текущая lab2 (8173f70), отдельный базовый коммит lab3 a57cbcf. Требования и статус: SPEC, PLAN.
Запуск
Основной стенд: 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 используется только публичными тестами преподавателя. В кластере нужны Traefik, cert-manager, default StorageClass и metrics-server. Образы PostgreSQL 17.6-alpine, Valkey 8.1.3-alpine, k6 1.3.0 закреплены в chart.
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.
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 без раскрытия внутренних деталей.
Архитектура описывает readiness, graceful shutdown и HPA. Подготовлены scrape и dashboard; импорт в Grafana не заявляется.
Проверки
Актуальные результаты обновления release сохраняются в evidence/shared-*. Старые файлы без этого префикса, кроме заново полученного coverage, относятся к прежнему экспериментальному стенду и не доказывают текущую конфигурацию.
make coverage выполняется с изолированными PostgreSQL/Valkey (переменные в CI): race, интеграционные проверки, реальный процесс, SIGTERM и порог 90% на каждый файл. scripts/test-faults.sh создаёт одноразовые Docker-зависимости, останавливает и замораживает БД/Valkey, проверяет 503 и отсутствие анонимного доступа.
Исследование и ограничения
Трек 5.1: scripts/experiment.sh сравнивает 1/2/4 API при фиксированном суммарном бюджете 1000m CPU / 512Mi и растущем бюджете по 250m / 128Mi на реплику. HPA временно отключается и восстанавливается. Профиль: 16 пользователей, 32 VU, 5 с прогрева, 30 с измерения; запись, чтение и повтор ключа. Сохраняются raw k6 и ресурсы. Полный трек требует матрицы, анализа насыщения и подтверждённого улучшения; наличие сценария не заменяет измерения.
Задание перечисляет Compose/Swarm; принятие Kubernetes как замены преподавателем не подтверждено. PostgreSQL и Valkey не реплицированы: потеря узла с локальным диском не покрывается. Оценка не заявляется как полученная.
Источники: README, COURSE, contracts этого репозитория; собственная lab2. Codex использован для реализации, проверки и документации.
Свежий прогон 16.10.2026: Go test/vet/lint прошли; race/integration/coverage — 59 файлов, минимум 90%. Публичный HTTPS smoke прошёл. Первый failover: 48 записей, 0 неудачных попыток, восстановление 0.801 с. Повторный запуск получил внешний connection/TLS timeout до остановки pod; сохранён отдельно, не считается PASS.
Конкурентная идемпотентность через HTTPS: 8 VU / 32 операции, 34/34 checks, ровно одно сообщение, другой body — конфликт. В процессе были 5 транзиентных неуспешных HTTP из 41; повторы выполнялись с исходным ключом. Полный рестарт API/PostgreSQL/Valkey прошёл: исходная сессия и сообщение сохранились, PVC неизменны. Реальные stop/pause PostgreSQL и Valkey на одноразовом стенде прошли: 503, отсутствие анонимного доступа, восстановление прежней сессии и сообщения.