Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
38 lines
3.2 KiB
Markdown
38 lines
3.2 KiB
Markdown
# Отчёт — лабораторная 4
|
|
|
|
- Автор, группа: Афанасьев Андрей / БПИ2304
|
|
- Целевая оценка; выбранный трек 5, если нужен: 3; трек не заявлен
|
|
- Commit/PR: TODO после публикации
|
|
- Использованные источники, библиотеки и помощь ИИ: TODO
|
|
|
|
## Запуск из чистого clone
|
|
|
|
Требуется Docker Compose. Запуск: `cp .env.example .env`, затем `docker compose --env-file .env up -d --build --wait`; проверка: `make test`. Для persistence используется `scripts/restart.sh`, для failover — `scripts/stop-one.sh api1`. Остановка без удаления данных: `docker compose down`; volumes удаляются отдельно только намеренно.
|
|
|
|
## Архитектура и решения
|
|
|
|
Перенесены две API-реплики, Nginx, PostgreSQL, Bearer-сессии и идемпотентность lab3. Добавлены MinIO с именованным volume `s3_data`, таблицы `attachments`/`message_attachments` и API загрузки/метаданных/скачивания. PostgreSQL хранит только метаданные, байты — в приватном bucket. Загрузка ограничена 10 MiB и проверяет PNG/JPEG сигнатуру; доступ проверяется членством в чате.
|
|
|
|
## Доказательства критериев
|
|
|
|
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|
|
| --- | --- | --- | --- |
|
|
| Публичный smoke | make test | Проверка API, вложений и checksum | tests/ |
|
|
| Остальные пункты уровня 3 | persistence/failover hooks | Общие PostgreSQL и MinIO volumes | scripts/ |
|
|
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
|
|
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
|
|
|
|
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
|
|
|
|
## Эксперименты и отказы
|
|
|
|
Для целевой оценки 3 отдельный исследовательский трек не заявлялся.
|
|
|
|
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|
|
| --- | --- | --- | --- |
|
|
| TODO | TODO | TODO | TODO |
|
|
|
|
## Ограничения и следующие шаги
|
|
|
|
Стенд рассчитан на отказ одной API-реплики и перезапуск с сохранением volumes. PostgreSQL и MinIO остаются едиными точками отказа. Административная консоль MinIO наружу не публикуется.
|