diff --git a/AGENTS.md b/AGENTS.md index ed34a612..b6f32a73 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -18,6 +18,11 @@ API за HAProxy, PostgreSQL — источник истины (данные, с где идут замеры); в `REPORT.md` их места помечены `TODO (Codex)`. Гипотезы трека 1 записаны в `REPORT.md` до замеров. +Указание пользователя от 15 октября 2026: выполнять замеры и при +питании от батареи. Предупреждение `host on battery power` сохраняется +в паспортах и описывается в отчёте; само по себе оно не требует +остановки этой сессии. Остальные предупреждения проверяются по RUNBOOK. + Стек: Python 3.13, FastAPI + Starlette 1.x, uvicorn, pydantic v2, SQLAlchemy Core 2.1 + asyncpg, alembic, argon2-cffi, redis-py; PostgreSQL 18.6, Valkey 9.1.2, HAProxy 3.4; uv (локально), pip + diff --git a/REPORT.md b/REPORT.md index 29c0b8ec..13a42741 100644 --- a/REPORT.md +++ b/REPORT.md @@ -20,6 +20,13 @@ PostgreSQL 18.6, Valkey 9.1.2, HAProxy 3.4.6. Образы закреплены [compose.yaml](compose.yaml), зависимости — [uv.lock](uv.lock) и `requirements.txt` с хешами. +В `.env.example` добавлены реальные переменные Compose и запуска с хоста: +имена базы и пользователя, пустые строки паролей, порты и таймаут остановки. +`make env` заполняет пароли случайными значениями и сохраняет уже существующий +`.env`. Исправленный bootstrap проверен 15 октября на Apple M4; +[вывод](evidence/stand/bootstrap.txt). Локальный процесс по умолчанию слушает +`127.0.0.1`, контейнер — `0.0.0.0` внутри сети Compose. + ```sh make install # uv sync make env # .env со случайными паролями (в git нет) @@ -418,6 +425,10 @@ R*(2 × 1) ≈ 830/с; на первой нарушившей ступени — - Замеры — на одном ноутбуке, все компоненты делят его CPU; лимиты cgroup не привязаны к производительным ядрам. Числа разных машин рядом не ставятся. +- Сессия 15 октября 2026 выполняется на Apple M4 при питании от батареи + по явному указанию пользователя. Предупреждение `host on battery power` + сохраняется в паспортах; влияние режима питания отдельно не измерялось. + Результаты этих серий не сравниваются с прежней калибровкой на M3 Pro. - TODO (Codex): ограничения, обнаруженные при замерах (хост, `generator_bound`, конфигурации, не поместившиеся в ВМ). diff --git a/bench/RUNBOOK.md b/bench/RUNBOOK.md index 138d99c9..8f87684a 100644 --- a/bench/RUNBOOK.md +++ b/bench/RUNBOOK.md @@ -87,6 +87,11 @@ tail -n 20 /tmp/bench-a.log # раз в несколько минут ## Шаг 0. Подготовка +Условия текущей сессии (15 октября 2026): пользователь явно разрешил +работать при питании от батареи. Для этой сессии требование питания от +сети ниже заменено этим разрешением; предупреждение о батарее остаётся +в результатах и отчёте. Остальные проверки и критерии не меняются. + - [ ] Docker доступен: `docker version`. Из sandbox Codex docker часто недоступен — запроси запуск вне sandbox или попроси пользователя. - [ ] Ресурсы ВМ Docker Desktop: `docker info --format '{{.NCPU}} CPU, diff --git a/evidence/stand/bootstrap.txt b/evidence/stand/bootstrap.txt new file mode 100644 index 00000000..057be82d --- /dev/null +++ b/evidence/stand/bootstrap.txt @@ -0,0 +1,71 @@ +# Что доказывает: исправленный .env.example позволяет создать окружение +# из чистой копии и поднять рабочий стенд документированными командами. +# Дата UTC: 2026-10-15 (проверки выполнены в этой сессии). +# Окружение: macOS 26.6.2, Apple M4; Docker 28.0.4; +# Compose 2.34.0-desktop.1; Python хоста 3.13.7. +# Стенд: vladimirceva-lab3, HAProxy 127.0.0.1:8080, две API-реплики. +# Код: src_sha256 0349e9a2701784673391c0ba4bc2eedba7013098d6ff7f871261aab36f78354a. +# Исправление и исходники зафиксированы локальным коммитом 84dd7fe. +# Пароли и токен не печатались. Как повторить: make env; make up; +# make test; make instances. Проверка чистого шаблона ниже выполнялась +# во временном каталоге: копия .env.example и make -f <репозиторий>/Makefile env; +# затем config --quiet с получившимся --env-file и compose.yaml проекта. + +$ python3 - <<'PY' +from pathlib import Path +import shutil +import subprocess +import tempfile +root=Path.cwd() +with tempfile.TemporaryDirectory(prefix='lab3-bootstrap-fixed-') as temp: + folder=Path(temp) + shutil.copyfile(root/'.env.example',folder/'.env.example') + subprocess.run(['make','-f',str(root/'Makefile'),'env'],cwd=folder,check=True) + env=folder/'.env' + before=env.read_bytes() + subprocess.run(['make','-f',str(root/'Makefile'),'env'],cwd=folder,check=True) + print('Repeated make env preserves existing file:',before==env.read_bytes()) + values=dict(line.split('=',1) for line in env.read_text().splitlines() if line and not line.startswith('#') and '=' in line) + print('Both generated passwords have 32 hex characters:',all(len(values[k])==32 and all(c in '0123456789abcdef' for c in values[k]) for k in ['POSTGRES_PASSWORD','VALKEY_PASSWORD'])) + subprocess.run(['docker','compose','--env-file',str(env),'-f',str(root/'compose.yaml'),'config','--quiet'],cwd=root,check=True) + print('PASS: clean bootstrap environment and compose configuration') +PY +.env ready +.env ready +Repeated make env preserves existing file: True +Both generated passwords have 32 hex characters: True +PASS: clean bootstrap environment and compose configuration + +$ make up +... (сборка, создание и запуск контейнеров опущены) + Container vladimirceva-lab3-postgres-1 Healthy + Container vladimirceva-lab3-valkey-1 Healthy + Container vladimirceva-lab3-migrate-1 Exited + Container vladimirceva-lab3-haproxy-1 Healthy + Container vladimirceva-lab3-api-1 Healthy + Container vladimirceva-lab3-api-2 Healthy + +$ make test +python3 tests/smoke.py --base-url "http://localhost:8080" +PASS: lab3 public API scenario; infrastructure and grading evidence remain separate. + +$ make instances +python3 scripts/lab3.py instances --base-url "http://localhost:8080" +one session, 12 x GET /api/v1/users/me via http://localhost:8080 + 1: 200 X-Instance-Id=bc629f87fa96 + 2: 200 X-Instance-Id=554216a23f5a + 3: 200 X-Instance-Id=bc629f87fa96 + 4: 200 X-Instance-Id=554216a23f5a + 5: 200 X-Instance-Id=bc629f87fa96 + 6: 200 X-Instance-Id=554216a23f5a + 7: 200 X-Instance-Id=bc629f87fa96 + 8: 200 X-Instance-Id=554216a23f5a + 9: 200 X-Instance-Id=bc629f87fa96 + 10: 200 X-Instance-Id=554216a23f5a + 11: 200 X-Instance-Id=bc629f87fa96 + 12: 200 X-Instance-Id=554216a23f5a +replicas seen: 2 {'bc629f87fa96': 6, '554216a23f5a': 6} + +# Итог: make env создаёт оба пароля и сохраняет существующий файл; +# compose принимает окружение; миграции завершились, обе API-реплики и +# LB готовы, smoke прошёл, один токен обслуживают обе реплики.