Исходный Docker-образ MinIO оказался недоступен для скачивания. Для локального запуска использован S3-совместимый образ docker.io/pgsty/silo:RELEASE.2026-10-26T00-00-00Z.
В обоих успешных тестах Failover останавливалась реплика api-2. Отказ api-1 отдельно не проверялся.
Проверки выполнены в локальном Docker-окружении. Автоматическая проверка CI и оценка преподавателя остаются отдельными этапами.
Доказательства области воздействия скриптов отказоустойчивости требуют отдельного подтверждения оператором.
В качестве основы использованы исходный шаблон лабораторной №4, контракт API и публичные тесты преподавателя.
Инструменты ИИ использовались при подготовке реализации, диагностике ошибок Docker, настройке окружения, выполнении проверок и оформлении отчёта. Результаты тестов приведены на основании фактического вывода локального запуска.
## Лабораторная 4
**Автор / группа:** Соколов Илья Сергеевич, факультет ИТ, БВТ2302
**Целевая оценка (3/4/5):** 3
**Трек 5, если заявлен:** Не заявлен
### Что реализовано и что перенесено
- Реализован HTTP API на Go с поддержкой загрузки и скачивания вложений.
- Сохранена функциональность предыдущих лабораторных: авторизация, сессии, сообщения и идемпотентность запросов.
- Настроены две API-реплики с балансировкой нагрузки через Nginx.
- Используется общая база данных PostgreSQL.
- Реализовано S3-совместимое хранилище изображений с сохранением метаданных в PostgreSQL.
- Добавлены проверки прав доступа к вложениям.
- Реализована корректная обработка недоступности S3: HTTP 503 при загрузке, сохранение работоспособности текстовых сообщений.
- Добавлены четыре SQL-миграции, включая `004_attachments.sql`.
- Настроены Docker Compose, healthcheck и скрипты проверки отказоустойчивости.
- Сохранены исходные контракт и публичные тесты преподавателя.
### Команды запуска из чистого clone
```powershell
powershell -ExecutionPolicy Bypass -File scripts\init-secrets.ps1
```
В локальном `.env` установить `PUBLISHED_PORT=18081`.
```powershell
docker compose up -d --build
docker compose ps
$env:PYTHONUTF8 = "1"
make -f Makefile check PYTHON=python
make -f Makefile test PYTHON=python BASE_URL=http://localhost:18081
```
Для проверки сохранности данных и отказоустойчивости:
```powershell
python -X utf8 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:18081
python -X utf8 tests\resilience.py --mode failover --action-script scripts\stop-one.cmd --base-url http://localhost:18081
docker compose up -d
```
### Результаты проверок и ссылка на REPORT.md
**1. Проверка структуры — PASS**
Команда:
```powershell
make -f Makefile check PYTHON=python
```
Фактический результат:
```text
python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
```
**2. Проверка API — PASS**
Команда:
```powershell
make -f Makefile test PYTHON=python BASE_URL=http://localhost:18081
```
Фактический результат:
```text
python tests/smoke.py --base-url "http://localhost:18081"
PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.
```
**3. Проверка сохранности данных — PASS**
```text
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
```
Подтверждена сохранность данных и существующей сессии после перезапуска компонентов.
**4. Первый тест отказоустойчивости — PASS**
```json
{"observed_instances_before":2,"successful_writes":8,"failed_attempts":0,"first_recovery_seconds":4.157}
```
```text
PASS: failover preserved confirmed data and existing session.
```
**5. Повторный тест отказоустойчивости — PASS**
```json
{"observed_instances_before":2,"successful_writes":8,"failed_attempts":0,"first_recovery_seconds":4.156}
```
```text
PASS: failover preserved confirmed data and existing session.
```
При обоих тестах была остановлена реплика `api-2`. После выполнения тестов контейнеры восстановлены, обе API-реплики получили статус Healthy.
**6. Проверка недоступности S3 — PASS**
S3-хранилище было намеренно остановлено командой `docker compose stop s3`.
Фактические результаты:
```text
PASS: S3 unavailable -> HTTP 503
PASS: text messages work without S3
S3 restored
```
Подтверждено, что при недоступности S3 загрузка вложений возвращает HTTP 503, а отправка текстовых сообщений продолжает работать.
После проверки контейнер S3 восстановлен.
**Отчёт:** [[REPORT.md](https://chatgpt.com/g/g-p-68fd2f9cd69c81918df234cf426fe94d-ilia/c/REPORT.md)](REPORT.md)
### Ограничения / известные ошибки
- Исходный Docker-образ MinIO оказался недоступен для скачивания. Для локального запуска использован S3-совместимый образ `docker.io/pgsty/silo:RELEASE.2026-10-26T00-00-00Z`.
- В обоих успешных тестах Failover останавливалась реплика `api-2`. Отказ `api-1` отдельно не проверялся.
- Проверки выполнены в локальном Docker-окружении. Автоматическая проверка CI и оценка преподавателя остаются отдельными этапами.
- Доказательства области воздействия скриптов отказоустойчивости требуют отдельного подтверждения оператором.
### Источники и использование ИИ
Использованные технологии: Go, PostgreSQL, Nginx, Docker Compose, S3-совместимое хранилище, Python.
В качестве основы использованы исходный шаблон лабораторной №4, контракт API и публичные тесты преподавателя.
Инструменты ИИ использовались при подготовке реализации, диагностике ошибок Docker, настройке окружения, выполнении проверок и оформлении отчёта. Результаты тестов приведены на основании фактического вывода локального запуска.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 4
Автор / группа: Соколов Илья Сергеевич, факультет ИТ, БВТ2302
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: Не заявлен
Что реализовано и что перенесено
004_attachments.sql.Команды запуска из чистого clone
В локальном
.envустановитьPUBLISHED_PORT=18081.Для проверки сохранности данных и отказоустойчивости:
Результаты проверок и ссылка на REPORT.md
1. Проверка структуры — PASS
Команда:
Фактический результат:
2. Проверка API — PASS
Команда:
Фактический результат:
3. Проверка сохранности данных — PASS
Подтверждена сохранность данных и существующей сессии после перезапуска компонентов.
4. Первый тест отказоустойчивости — PASS
5. Повторный тест отказоустойчивости — PASS
При обоих тестах была остановлена реплика
api-2. После выполнения тестов контейнеры восстановлены, обе API-реплики получили статус Healthy.6. Проверка недоступности S3 — PASS
S3-хранилище было намеренно остановлено командой
docker compose stop s3.Фактические результаты:
Подтверждено, что при недоступности S3 загрузка вложений возвращает HTTP 503, а отправка текстовых сообщений продолжает работать.
После проверки контейнер S3 восстановлен.
Отчёт: [REPORT.md](REPORT.md)
Ограничения / известные ошибки
docker.io/pgsty/silo:RELEASE.2026-10-26T00-00-00Z.api-2. Отказapi-1отдельно не проверялся.Источники и использование ИИ
Использованные технологии: Go, PostgreSQL, Nginx, Docker Compose, S3-совместимое хранилище, Python.
В качестве основы использованы исходный шаблон лабораторной №4, контракт API и публичные тесты преподавателя.
Инструменты ИИ использовались при подготовке реализации, диагностике ошибок Docker, настройке окружения, выполнении проверок и оформлении отчёта. Результаты тестов приведены на основании фактического вывода локального запуска.
Pull request closed