Files
mtusi2026lab4/openspec/changes/archive/2026-09-29-container-runtime/tasks.md
T
ricoromaandClaude Opus 5.5 5d5d8f9d2a chore: carry lab 3 over
- 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>
2026-10-20 17:32:33 +03:00

7.8 KiB
Raw Blame History

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 проходят.