- carry the lab 3 solution over from mtusi2026lab3-safronov (solution/bvt2301-safronov, ce89eba): src, migrations, student-tests, bench, openspec, .claude, infra/haproxy and infra/valkey, own scripts, Dockerfile, compose, pyproject and uv lock - merge Makefile, .gitignore and .dockerignore (the lab 3 versions only add lines to the skeleton, which is the same in lab 4) and .env.example (lab 4 skeleton names listed in the header) - rename the compose project to mtusi-lab4 and the image to :lab4 so the stand does not reuse the lab 3 containers and volumes - update AGENTS.md for lab 4: current lab, origin commit, contract and test files of the new skeleton Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.8 KiB
7.8 KiB
Tasks
Перед правкой Dockerfile, docker-compose.yml, .dockerignore и
Makefile прочитать .claude/rules/docker.md и run-modes.md. Как
строить — design.md, что должно получиться — specs/. Перед
проверками освободить порт 8080: остановить make run_dev или взять
другой APP_OUT_PORT.
1. Файлы контейнера
- 1.1
Dockerfileпо design, решение 1. Перед записью сверить digest индексов из design, решение 2 (docker buildx imagetools inspect <тег>): если тег перепубликован, взять новый digest. Проверка:grep -nE '^(FROM|COPY --from)' Dockerfile— у каждой ссылки на образ есть патч-версия и@sha256:;- сборка из tar-контекста (design, решение 8) проходит.
- 1.2 Дополнить
.dockerignore(design, решение 3). Проверка: в образе/appсодержит только.venvиsrc, а размер контекста в выводе сборки — десятки килобайт, а не мегабайты. - 1.3 Переписать
.env.example(design, решение 5):APP__PORTиAPP_OUT_PORT, комментарии отдельными строками. Изconfig_example.tomlубратьport, пример в шапке —APP__LOG_LEVEL. Проверка:docker compose configподставляет порты из.env;make run_devслушаетAPP__PORTиз.env. Локальный.env, созданный раньше из старого шаблона,make env_setupне трогает — обновить его руками и сказать об этом пользователю. - 1.4
docker-compose.yml(design, решение 4). Проверка:docker compose configбез ошибок, порт публикуется на127.0.0.1. - 1.5 Секция
Docker targetsвMakefile:run_no_compose,run_docker,stop,down,logs(design, решение 6). Проверка:- с
.envиз шаблонаmake -n run_no_composeпечатаетdocker buildиdocker runиз README (тот же тег, имя,127.0.0.1:8080:8080,--env-file .env); сAPP_OUT_PORT=8090иAPP__PORT=9090в.env—127.0.0.1:8090:9090; без.env—8080:8080; make -n run_dockerпечатаетdocker compose buildиup -d;make helpиmake checkработают как раньше.
- с
2. Проверка образа (спека container-image)
- 2.1 Сборка из чистого контекста (design, решение 8) проходит.
Негативная проверка lock: временно добавить зависимость в
pyproject.tomlбезuv lock, убедиться, что сборка падает на проверке lock, и вернуть файл. - 2.2 Non-root и код только на чтение:
docker run --rm mtusi-messenger:lab1 id -uдаёт 10001, а запись в/app/srcотклоняется с ошибкой доступа. - 2.3 Состав образа: в
/appтолько.venvиsrc;config.toml,.envиuvотсутствуют. - 2.4 PID 1 —
python -m src(/proc/1/cmdlineв работающем контейнере). - 2.5 Healthcheck:
docker inspectпоказываетhealthyдо окончанияstart_period, а в журнале нет итоговых записей о запросах к health.
3. Запуск (спека container-run)
- 3.1 Без compose:
make run_no_compose(те же команды README), в другом терминалеmake test—PASS;docker portпоказывает127.0.0.1:8080. Ctrl+C в терминале цели: в журналеShutting downиFinished server process, контейнера нет вdocker ps -a. - 3.2 compose:
make env_setup,make run_docker,make test—PASS. Порты (спека, «Порты из .env») для обоих способов: сAPP_OUT_PORT=8090иAPP__PORT=9090в.envконтейнерhealthy, аmake test BASE_URL=http://localhost:8090—PASS. Потом вернуть значения.make logs: каждая строка — JSON, строк лаунчера нет. - 3.3 Без
config.toml(временно убрать файл черезmv):make run_dockerсоздаёт его из шаблона и поднимает сервис, аdocker compose up -dбез make падает с ошибкой источника монтирования, и каталогconfig.toml/не появляется; затем вернуть файл. - 3.4 Правка
config.tomlбез пересборки: временно поставитьlog_level = "WARNING"(вызововdebugв коде нет, поэтомуDEBUGничего бы не показал), перезапустить контейнер — записиinfo(Started API,HTTP request completed) исчезают; вернутьINFO,docker compose restart— тот же контейнер и образ, записи снова есть. - 3.5 Жизненный цикл для защиты: создать двух пользователей, чат,
сообщение, прочитать историю, перезапустить контейнер тем же
образом — прежний
X-User-Idполучает 401. Вывод сохранить вevidence/container/.
4. Остановка по SIGTERM (спека graceful-shutdown)
- 4.1 Прогон по design, решение 7:
tests/load.pyв фоне иtime docker stop. Зафиксировать время остановки (меньше 10 с), код выхода (не 137, фактическое значение записать), последовательность и метки времениShutting down→Stopped API→Finished server process, а также ошибки соединения у запросов после сигнала. Вывод сохранить вevidence/container/.
5. Документация и финальные проверки
- 5.1
evidence/container/: выводы задач 2–4 без секретов и без текстов сообщений, с датой, commit и окружением (Docker, архитектура). - 5.2
REPORT.md(design, решение 9): раздел «Запуск из чистого clone» с обоими способами —make run_no_composeиmake run_docker, часть «Архитектура и решения» (процессы и хранилище, соответствие.env.example, согласования с преподавателем, права наconfig.toml), строки критериев контейнера со ссылками наevidence/. - 5.3
AGENTS.md: целиrun_no_compose,run_docker,stop,down,logsв таблице команд без пометки «появится»..claude/rules/docker.md: уточнения из реализации — digest индекса, один базовый образ в обоих stage,--no-install-project, UID 10001, healthcheck только в образе, проверка через tar-контекст. - 5.4
make lint,make check,make testпротив контейнера иopenspec validate container-runtime --strictпроходят.