# Запуск лабораторной 3 на k3s + Pingap Автор: Медведев Андрей Михайлович, БПИ2303. Все команды выполняются из корня этой лабы. Исходное задание сохранено в README.md, контракт — в contracts/; описание реализации и результаты находятся в REPORT.md. Проверенный host — Linux x86_64 с Docker 29.9.2, k3d 5.9.0, kubectl 1.37.1 и Bun 1.4.4. В кластере используется закреплённый k3s 1.37.1 и Pingap 0.16.0. Для публичных проверок нужен Python 3.9+; для проверок Go и генератора PNG — Go 1.27.2. Большие сборки и эксперименты выполняются на тестовом host, не на Mac. ## Запуск с нуля ```sh bun --no-env-file scripts/k3s.ts up ``` Команда создаёт отдельный одноузловой кластер vp-lab3-medvedev, собирает API, проверяет и импортирует образы, создаёт Secrets и PVC, ждёт реального SQL-запроса, выполняет миграции отдельным Job и проверяет HTTP через Pingap. На первом запуске отсутствующие публичные образы скачиваются по закреплённым digest; имеющийся кеш используется повторно. При импорте выбирается linux/amd64, чтобы не переносить отсутствующие части многоплатформенного image index. API доступен по http://127.0.0.1:28203. Кластер не меняет глобальный kubeconfig. Его приватный kubeconfig и синтетические credentials находятся в .local/, исключённом из git и Docker context. Повторный запуск сохраняет PVC и данные. ## Проверки ```sh python3 -m venv .venv .venv/bin/pip install -r requirements-dev.txt make check PYTHON=.venv/bin/python make validate PYTHON=.venv/bin/python make test BASE_URL=http://127.0.0.1:28203 BASE_URL=http://127.0.0.1:28203 bun --no-env-file student-tests/acceptance.ts bun --no-env-file student-tests/kube-stdin.ts bun test student-tests/k3s-model.test.ts ``` HTTP acceptance удаляет только собственный случайный набор; публичные проверки сохраняют свои синтетические записи для демонстрации. Проверка stdin действительно выполняет SELECT в PostgreSQL, а не ограничивается exit status процесса psql. Остановка обслужившей реплики и её восстановление: ```sh make test-failover BASE_URL=http://127.0.0.1:28203 ACTION_SCRIPT=scripts/stop-one.sh bun --no-env-file scripts/k3s.ts configure ``` Повторите обе команды для следующей реплики. TARGET_INSTANCE_ID задаёт публичный тест. Hook проверяет Pod UID, масштабирует API до одной реплики и аварийно останавливает процесс выбранного пода; нативный CRI inventory подтверждает отсутствие работающего процесса с его UID. Свидетельства сохраняются в evidence/k3s/stop-one-before.json и stop-one-after.json. Для штатной замены используется обычный rollout с readiness и preStop, без аварийного kill. Полный рестарт компонентов с прежним токеном и данными: ```sh make test-persistence BASE_URL=http://127.0.0.1:28203 ACTION_SCRIPT=scripts/restart.sh ``` Hook записывает реальные Pod UID до и после рестарта и дожидается API через Pingap. PostgreSQL, Valkey и Pingap входят в сценарий. Проверки backend выполняются отдельно: ```sh cd backend go test -race ./... go tool golangci-lint run go generate ./... ``` После них вернитесь в корень лабы. Контракты и публичные тесты сохранены, версия OpenAPI не менялась при переносе. ## Исследование трека 1 Запуск на тестовом host с установленным game-running, только без игры: ```sh bun --no-env-file student-tests/research.ts ``` Runner создаёт отдельный случайный кластер на localhost:28303, проверяет реальные лимиты API и размер SQL-пула, выполняет серии 1/2/4 при постоянном и растущем бюджете, ABBA пула и rollout под непрерывной нагрузкой. Между прогонами очищается только БД этого исследовательского кластера. После проверки кластер удаляется до публикации PASS. Отдельный повтор четырёх запусков пула: ```sh bun --no-env-file student-tests/research.ts --pool-only ``` Новые файлы появляются в evidence/k3s/research/run-*. Графики строятся из summary.json завершённого запуска через student-tests/plot_research.py; dependencies указаны в student-tests/requirements-plots.txt. Результаты старого Compose/HAProxy исследования находятся в историческом отчёте docs/archive/compose-report.md и не являются замерами Pingap. Повторное построение графиков из приложенных измерений: ```sh .venv/bin/pip install -r student-tests/requirements-plots.txt .venv/bin/python student-tests/plot_research.py evidence/k3s/research/run-R4F28Q/summary.json ``` ## Остановка и удаление своего стенда Остановка сохраняет кластер и PVC: ```sh bun --no-env-file scripts/k3s.ts stop ``` Повторный up возвращает сохранённые данные. Полное удаление кластера вместе с его учебными данными выполняется явно из работающего стенда: ```sh bun --no-env-file scripts/k3s.ts destroy ``` Если кластер был остановлен, сначала выполните up. Runtime проверяет собственный claim, immutable ID server-контейнера и Namespace UID; чужой кластер или заменённый namespace автоматически не принимаются. Оригинальное задание предлагает Compose/Swarm; k3s выбран автором как альтернативный стенд, и принятие этого варианта преподавателем не заявляется.