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