docs: record bootstrap verification and measurement conditions

This commit is contained in:
2026-10-15 13:48:55 +03:00
parent 84dd7fec0a
commit 006ec24d20
4 changed files with 92 additions and 0 deletions
+5
View File
@@ -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 +
+11
View File
@@ -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`, конфигурации, не поместившиеся в ВМ).
+5
View File
@@ -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,
+71
View File
@@ -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 прошёл, один токен обслуживают обе реплики.