forked from Alexey/DAS_2024_1
58 lines
4.4 KiB
Markdown
58 lines
4.4 KiB
Markdown
# Отчет. Лабораторная работа 3
|
||
|
||
## Описание
|
||
В рамках лабораторной работы № 3 были реализованы два сервиса (Java + Spring), осуществляющие CRUD-операции над сущностями.
|
||
|
||
Модель данных следующая:
|
||
|
||
Сущность "Компания" (сервис company)
|
||
- идентификатор компании
|
||
- название
|
||
- адрес
|
||
|
||
Сущность "Вакансия" (сервис vacancy)
|
||
- идентификатор вакансии
|
||
- название
|
||
- описание
|
||
- нижняя граница зарплаты
|
||
- верхняя граница зарплаты
|
||
- идентификатор компании
|
||
|
||
Компания с вакансией связана как "один ко многим".
|
||
|
||
Каждый из сервисов имеет API с пятью эндпоинтами. При этом в сервисе vacancy при запросе вакансии по id происходит
|
||
дополнительный запрос в сервис company для получения информации по компании, связанной с вакансией.
|
||
Происходит это взаимодействие с помощью библиотеки OpenFeign, которая "под капотом" использует HttpClient.
|
||
|
||
В качестве хранилища данных использовалась СУБД Postgres. У каждого сервиса своя база данных в поднятой СУБД.
|
||
Для создания схемы БД была использована библиотека Flyway, которая применила написанные миграции при старте приложения.
|
||
|
||
Запросы к сервисам проксирует шлюз на основе Nginx. Для этого перед запуском nginx был описан конфигурационный файл nginx.conf,
|
||
в котором описан прослушиваемый порт и название сервера (в блоке server), маршруты до микросервисов и параметры проксирования (в блоке location).
|
||
|
||
Таким образом, с помощью Docker Compose были подняты сервисы:
|
||
- company
|
||
- vacancy
|
||
- postgres
|
||
- nginx
|
||
## Как запустить
|
||
Для того, чтобы запустить сервисы, необходимо выполнить следующие действия:
|
||
1. Установить и запустить Docker Engine или Docker Desktop
|
||
2. Через консоль перейти в папку, в которой расположен файл docker-compose.yml
|
||
3. Выполнить команду:
|
||
```
|
||
docker compose up --build
|
||
```
|
||
В случае успешного запуска всех контейнеров в консоли будет выведено следующее сообщение:
|
||
```
|
||
[+] Running 5/5
|
||
✔ Network borschevskaya_anna_lab_3_default Created 0.0s
|
||
✔ Container postgres Started 0.6s
|
||
✔ Container vacancy Started 1.1s
|
||
✔ Container company Started 0.9s
|
||
✔ Container borschevskaya_anna_lab_3-nginx-1 Started
|
||
```
|
||
Далее можно осуществлять запросы к сервисам по адресу http://localhost/{location}, где часть пути location меняется в зависимости от сервиса и запроса.
|
||
## Видео-отчет
|
||
Работоспособность лабораторной работы можно оценить в следующем [видео](https://disk.yandex.ru/i/KPNBfnlcgl1auw).
|
||
Демонстрация взаимодействия с системой производится с применением сервиса Postman. |