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

93 lines
7.1 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.
# Вопросы и решения лабы 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`).
### Вопросы
Пока нет: решения пользователя — раздел «Ответы пользователя перед прогоном».