forked from mtusi2026/mtusi2026lab3
98 lines
7.2 KiB
Markdown
98 lines
7.2 KiB
Markdown
# Запуск лабораторной 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 выбран автором как альтернативный стенд, и принятие этого варианта преподавателем не заявляется.
|