Автор / группа: Екатерина Александровна Гончаревская, БВТ2304
Целевая оценка: 3
Что реализовано и что перенесено:
Реализован API-сервис с двумя репликами за балансировщиком HAProxy. Настроены PostgreSQL для хранения данных и Valkey для хранения сессий. Реализованы проверка доступности реплик, распределение запросов, продолжение работы при остановке одной реплики, сохранение данных после перезапуска и защита от повторного выполнения запросов с помощью Idempotency-Key. Добавлены миграции базы данных, Dockerfile и скрипты управления репликами и перезапуска инфраструктуры.
Исходные файлы задания, контракты и тесты преподавателя сохранены без изменений. В форк добавлены только файлы реализации.
Команды запуска из чистого clone:
Клонировать репозиторий.
Создать файл .env на основе .env.example.
Подготовить секреты в соответствии с инструкцией проекта.
Запустить инфраструктуру:
docker compose up -d --scale api=2
Проверить доступность API:
http://localhost:8080/health/ready
Результаты проверок и ссылка на REPORT.md:
Проверка публичного API: PASS (tests/smoke.py).
Проверка структуры контракта и синтаксиса: PASS (scripts/check_contract.py).
Проверка OpenAPI 3.1 и JSON Schema: PASS (scripts/validate_openapi.py).
Проверка сохранения данных и сессий после перезапуска: PASS (tests/resilience.py --mode persistence).
Проверка отказоустойчивости при остановке одной реплики: PASS (tests/resilience.py --mode failover). В ходе проверки выполнено 119 успешных записей, время восстановления составило около 2,43 секунды.
REPORT.md: REPORT.md в корне репозитория.
Ограничения / известные ошибки:
Решение обеспечивает отказоустойчивость на уровне API-реплик. Отказ балансировщика нагрузки или базы данных не входит в область реализации. Производительность системы при экстремальных нагрузках отдельно не оценивалась.
Источники и использование ИИ:
В качестве основы использованы материалы лабораторной работы, исходный репозиторий задания и документация используемых технологий: Docker, PostgreSQL, Valkey, HAProxy, FastAPI. ChatGPT использовался для помощи оформлении документации.
Лабораторная 3
Автор / группа: Екатерина Александровна Гончаревская, БВТ2304
Целевая оценка: 3
Что реализовано и что перенесено:
Реализован API-сервис с двумя репликами за балансировщиком HAProxy. Настроены PostgreSQL для хранения данных и Valkey для хранения сессий. Реализованы проверка доступности реплик, распределение запросов, продолжение работы при остановке одной реплики, сохранение данных после перезапуска и защита от повторного выполнения запросов с помощью Idempotency-Key. Добавлены миграции базы данных, Dockerfile и скрипты управления репликами и перезапуска инфраструктуры.
Исходные файлы задания, контракты и тесты преподавателя сохранены без изменений. В форк добавлены только файлы реализации.
Команды запуска из чистого clone:
1. Клонировать репозиторий.
2. Создать файл `.env` на основе `.env.example`.
3. Подготовить секреты в соответствии с инструкцией проекта.
4. Запустить инфраструктуру:
`docker compose up -d --scale api=2`
5. Проверить доступность API:
`http://localhost:8080/health/ready`
Результаты проверок и ссылка на REPORT.md:
Проверка публичного API: PASS (`tests/smoke.py`).
Проверка структуры контракта и синтаксиса: PASS (`scripts/check_contract.py`).
Проверка OpenAPI 3.1 и JSON Schema: PASS (`scripts/validate_openapi.py`).
Проверка сохранения данных и сессий после перезапуска: PASS (`tests/resilience.py --mode persistence`).
Проверка отказоустойчивости при остановке одной реплики: PASS (`tests/resilience.py --mode failover`). В ходе проверки выполнено 119 успешных записей, время восстановления составило около 2,43 секунды.
REPORT.md: `REPORT.md` в корне репозитория.
Ограничения / известные ошибки:
Решение обеспечивает отказоустойчивость на уровне API-реплик. Отказ балансировщика нагрузки или базы данных не входит в область реализации. Производительность системы при экстремальных нагрузках отдельно не оценивалась.
Источники и использование ИИ:
В качестве основы использованы материалы лабораторной работы, исходный репозиторий задания и документация используемых технологий: Docker, PostgreSQL, Valkey, HAProxy, FastAPI. ChatGPT использовался для помощи оформлении документации.
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.
Лабораторная 3
Автор / группа: Екатерина Александровна Гончаревская, БВТ2304
Целевая оценка: 3
Что реализовано и что перенесено:
Реализован API-сервис с двумя репликами за балансировщиком HAProxy. Настроены PostgreSQL для хранения данных и Valkey для хранения сессий. Реализованы проверка доступности реплик, распределение запросов, продолжение работы при остановке одной реплики, сохранение данных после перезапуска и защита от повторного выполнения запросов с помощью Idempotency-Key. Добавлены миграции базы данных, Dockerfile и скрипты управления репликами и перезапуска инфраструктуры.
Исходные файлы задания, контракты и тесты преподавателя сохранены без изменений. В форк добавлены только файлы реализации.
Команды запуска из чистого clone:
.envна основе.env.example.docker compose up -d --scale api=2http://localhost:8080/health/readyРезультаты проверок и ссылка на REPORT.md:
Проверка публичного API: PASS (
tests/smoke.py).Проверка структуры контракта и синтаксиса: PASS (
scripts/check_contract.py).Проверка OpenAPI 3.1 и JSON Schema: PASS (
scripts/validate_openapi.py).Проверка сохранения данных и сессий после перезапуска: PASS (
tests/resilience.py --mode persistence).Проверка отказоустойчивости при остановке одной реплики: PASS (
tests/resilience.py --mode failover). В ходе проверки выполнено 119 успешных записей, время восстановления составило около 2,43 секунды.REPORT.md:
REPORT.mdв корне репозитория.Ограничения / известные ошибки:
Решение обеспечивает отказоустойчивость на уровне API-реплик. Отказ балансировщика нагрузки или базы данных не входит в область реализации. Производительность системы при экстремальных нагрузках отдельно не оценивалась.
Источники и использование ИИ:
В качестве основы использованы материалы лабораторной работы, исходный репозиторий задания и документация используемых технологий: Docker, PostgreSQL, Valkey, HAProxy, FastAPI. ChatGPT использовался для помощи оформлении документации.
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.