7.2 KiB
Запуск лабораторной 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.
Запуск с нуля
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 и данные.
Проверки
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.
Остановка обслужившей реплики и её восстановление:
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.
Полный рестарт компонентов с прежним токеном и данными:
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 выполняются отдельно:
cd backend
go test -race ./...
go tool golangci-lint run
go generate ./...
После них вернитесь в корень лабы. Контракты и публичные тесты сохранены, версия OpenAPI не менялась при переносе.
Исследование трека 1
Запуск на тестовом host с установленным game-running, только без игры:
bun --no-env-file student-tests/research.ts
Runner создаёт отдельный случайный кластер на localhost:28303, проверяет реальные лимиты API и размер SQL-пула, выполняет серии 1/2/4 при постоянном и растущем бюджете, ABBA пула и rollout под непрерывной нагрузкой. Между прогонами очищается только БД этого исследовательского кластера. После проверки кластер удаляется до публикации PASS.
Отдельный повтор четырёх запусков пула:
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.
Повторное построение графиков из приложенных измерений:
.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:
bun --no-env-file scripts/k3s.ts stop
Повторный up возвращает сохранённые данные. Полное удаление кластера вместе с его учебными данными выполняется явно из работающего стенда:
bun --no-env-file scripts/k3s.ts destroy
Если кластер был остановлен, сначала выполните up. Runtime проверяет собственный claim, immutable ID server-контейнера и Namespace UID; чужой кластер или заменённый namespace автоматически не принимаются. Оригинальное задание предлагает Compose/Swarm; k3s выбран автором как альтернативный стенд, и принятие этого варианта преподавателем не заявляется.