Files
mtusi2026lab3/RUN.md
T

98 lines
7.2 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 на 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 выбран автором как альтернативный стенд, и принятие этого варианта преподавателем не заявляется.