Files
mtusi2026lab4/RUN.md

7.7 KiB
Raw Permalink Blame History

Запуск лабораторной 4 на 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-lab4-medvedev, собирает API, проверяет и импортирует образы, создаёт Secrets и PVC, ждёт реального SQL-запроса, выполняет миграции отдельным Job и проверяет HTTP через Pingap. На первом запуске отсутствующие публичные образы скачиваются по закреплённым digest; имеющийся кеш используется повторно. При импорте выбирается linux/amd64, чтобы не переносить отсутствующие части многоплатформенного image index.

API доступен по http://127.0.0.1:28204. Кластер не меняет глобальный kubeconfig. Его приватный kubeconfig и синтетические credentials находятся в .local/, исключённом из git и Docker context. Повторный запуск сохраняет PVC и данные. В обычных API-подах нет root-credentials S3.

Проверки

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:28204
BASE_URL=http://127.0.0.1:28204 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:28204 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:28204 ACTION_SCRIPT=scripts/restart.sh

Hook записывает реальные Pod UID до и после рестарта и дожидается API через Pingap. PostgreSQL, Valkey, S3 и Pingap входят в сценарий. Проверки backend выполняются отдельно:

cd backend
go test -race ./...
go tool golangci-lint run
go generate ./...

После них вернитесь в корень лабы. Контракты и публичные тесты сохранены, версия OpenAPI не менялась при переносе.

S3, согласованность и память

Отказ S3 с восстановлением и проверкой сохранённого оригинала:

FAIL_S3=1 BASE_URL=http://127.0.0.1:28204 bun --no-env-file student-tests/acceptance.ts

Частичные отказы, dry-run, apply и повтор проверяются в отдельном случайном кластере с пустой БД и bucket на localhost:28404:

bun --no-env-file student-tests/reconciliation.ts

Runner удаляет свой кластер после завершения. Прямой запуск destructive integration в основном кластере отвергается. Результаты находятся в evidence/k3s/reconciliation/run-*.

Обычная сверка основного стенда по 100 metadata и 100 объектов за batch:

bun --no-env-file scripts/k3s.ts task reconcile
bun --no-env-file scripts/k3s.ts task reconcile -apply

Первая команда — dry-run. Для продолжения передайте NextMetadata и NextObject через -after и -object-after. Default grace равен 10 минутам; минимально 60 секунд. При ошибке повторяется прежняя страница.

Память измеряется только без игры на тестовом host. Сначала создайте fixture из корня лабы:

go run ./student-tests/image-fixtures/main.go
BASE_URL=http://127.0.0.1:28204 bun --no-env-file student-tests/concurrent-images.ts
./student-tests/image-memory.sh

Первый эксперимент начинает десять upload, проверяет bytes каждого успешного оригинала и снимает настоящий cgroup memory.peak API. Второй выполняет экстремальный PNG-тест отдельным Job с hard limit 2 ГиБ. Native CLI тоже проверяет game-running до и после memory Job, поэтому обход shell-скрипта не разрешает измерение во время игры.

Остановка и удаление своего стенда

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