docs: record bootstrap verification and measurement conditions
This commit is contained in:
@@ -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 +
|
||||
|
||||
@@ -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`, конфигурации, не поместившиеся в ВМ).
|
||||
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -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 прошёл, один токен обслуживают обе реплики.
|
||||
Reference in New Issue
Block a user