Files
mtusi2026lab6/QUESTIONS.md
T
2026-11-11 04:56:23 +03:00

7.1 KiB
Raw Blame History

Вопросы и решения лабы 6

Решения, принятые без пользователя, и вопросы, которые не блокируют работу. Раздел на каждый change: ## <change>, внутри «Решения» и «Вопросы». Вопросы преподавателю дублируются в REPORT.md. План изменений лабы — PLAN.md.

Ответы пользователя перед прогоном (2026-11-11)

  • Оценка — 5, трек 1 «Цена наблюдаемости».
  • Хранилища — Prometheus (метрики), Loki (логи), Tempo (трассы), отдельными сервисами; интерфейс — Grafana.
  • Уровень 4 — два change: job-trace-propagation, затем slo-alerts.
  • Без пользователя можно (как в лабе 5): коммиты на ветках feat/<change>, ff-merge в solution/bvt2301-safronov, архивация, установка зависимостей и образов, запуск стенда и замеров, в конце git push ветки решения в свой fork. PR не открывать. Разрешения — .claude/settings.local.json.
  • Длинные замеры исключений (make bench_uploads, make bench_queue) — в последнем шаге, на коде лабы 6 с телеметрией.

Перенос из лабы 5

Источник: mtusi2026lab5-safronov, ветка solution/bvt2301-safronov, commit 046ec9e. Перенос — 2026-11-11.

Решения

  • Перенесены отслеживаемые файлы по AGENTS.md, «Переход в следующую лабу», git archive 046ec9e: src/, student-tests/, service-tests/, migrations/, alembic.ini, Dockerfile, docker-compose.yml, infra/valkey/, infra/haproxy/, infra/s3/, infra/rabbitmq/, infra/rollback/ (на него ссылаются balancer.md и откат реплик; в списке переноса его не было — список дополнен), свои scripts/restart.sh, scripts/stop-one.sh, scripts/rolling-update.sh, pyproject.toml, uv.lock, .python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/, openspec/, .graphifyignore, bench/, KNOWN_ISSUES.md, .github/workflows/application.yml, .github/ci/.
  • Не перенесены: README.md, COURSE.md, tests/, contracts/, lab.json, REPORT.md, evidence/, graphify-out/, QUESTIONS.md (этот файл — новый), .env, config.toml, .venv.
  • Makefile, .gitignore, .dockerignore skeleton лаб 5 и 6 совпадают побайтно, поэтому взяты целиком из лабы 5 (skeleton + свои секции).
  • .env.example — свой файл лабы 5 без правок. Новые имена skeleton (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_RESOURCE_ATTRIBUTES) сопоставляет первый change лабы (PLAN.md), как BROKER_URL_FILE и др. в лабе 5.
  • Контракт API лабы 6 не изменился: contracts/openapi.json отличается только info (заголовок, версия 1.6.0), contracts/README.md и tests/ совпадают с лабой 5. Новое — contracts/observability.md, три роли в contracts/infrastructure.json (otel_collector, telemetry_storage с persistent volume, grafana с provisioning в git), infra/otel/README.md. tests/client.py для лабы 6 ведёт себя как для лабы 5 (загрузка — 202).
  • Имя проекта compose и образ — mtusi-lab6, mtusi-messenger:lab6 (docker-compose.yml, спеки container-run и container-image, правила docker.md и balancer.md, драйвер и SKILL.md, комментарии override CI и стенда отказов), префикс проектов CI — mtusi-lab6-safronov-ci-. Иначе стенд лабы 6 подключился бы к volumes лабы 5.
  • .claude/settings.local.json (не в git) — только запреты: удаление volumes лаб 5 и 6, make wipe_data, down -v, force push. Разрешения прогона лабы 5 (commit, merge, push) не перенесены: для лабы 6 их даёт пользователь перед прогоном (PLAN.md, «Что решает пользователь»).
  • Commit «до» профилей rollout, uploads, reconcile стенда bench/ (Profile.rollout_from, uploads_before, reconcile_before) указывали на commit лабы 5 (7f38948, 04f8592), которых в истории лабы 6 нет: профили отказали бы с кодом 2 до стенда. Они переведены на commit переноса 9cc6c0c отдельным коммитом, как cc33a03 в лабе 5. Там же код успеха варианта «до» профиля uploads — 202 вместо 201 (uploads_success_codes): «до» теперь код лабы 5, его загрузка отвечает 202; с 201 вариант насчитал бы ноль успешных.
  • Проверено на рабочем дереве после переноса: make check — PASS; ruff check и ruff format --check — чисто (545 файлов); make service_test — 215 passed; make run_docker на новом проекте mtusi-lab6 — см. дефект ниже, после повторного docker compose up -d --wait все сервисы healthy / running; make test — PASS («lab6 public API scenario»); make student_test — 223 passed, 1 failed: test_exclusion_evidence_exists (ожидаемо, evidence не переносится). Нет 10 файлов: evidence/attachments/failover.md, evidence/attachments/storage.md, evidence/auth/passwords-and-tokens.md, evidence/broker/isolated.md, evidence/broker/stand.md, evidence/cache/hits.md, evidence/idempotency/replay-after-restart.md, evidence/queue/baseline4/summary.md, evidence/replicas/test-persistence.md, evidence/uploads/baseline/summary.md. Сверка становится зелёной, когда они сняты заново на стенде лабы 6 (PLAN.md, шаг 0 и последний шаг).
  • Найден дефект первого старта RabbitMQ на пустом volume (eacces на .erlang.cookie из-за healthcheck от root): make run_docker из чистого clone падает на «dependency failed to start». Записан в KNOWN_ISSUES.md с предложением правки, не исправлен: правка входит в первый change (PLAN.md).

Вопросы

Пока нет: решения пользователя — раздел «Ответы пользователя перед прогоном».