106 lines
5.4 KiB
Markdown
106 lines
5.4 KiB
Markdown
|
# Лабораторная работа №3 - REST API, Gateway и синхронный обмен между микросервисами
|
|||
|
|
**Цель**: изучение шаблона проектирования gateway, построения синхронного обмена между микросервисами и архитектурного стиля RESTful API.
|
|||
|
|
|
|||
|
|
**Задачи**:
|
|||
|
|
* Создать 2 микросервиса, реализующих CRUD на связанных сущностях.
|
|||
|
|
* Реализовать механизм синхронного обмена сообщениями между микросервисами.
|
|||
|
|
* Реализовать шлюз на основе прозрачного прокси-сервера nginx.
|
|||
|
|
***
|
|||
|
|
## *Ход работы:*
|
|||
|
|
### Разворачивание сервисов:
|
|||
|
|
Были разработаны два приложения на ЯП Java с использованием средства автоматизации сборки проектов Gradle и с использованием библиотеки spring-boot:
|
|||
|
|
* client - содержит работу с записями по пользователям мобильного приложения для поддержки здоровья.
|
|||
|
|
* training - содержит работу с записями по тренировкам пользователей. Каждая тренировка относится к единственному пользователю, у пользователя может быть много тренировок (связь многие к одному).
|
|||
|
|
### Обмен сообщениями
|
|||
|
|
При чтении (создании, обновлении) записи тренировки при помощи RestTemplate по id клиента мы получаем его данные. Пример с методом создания тренировки:
|
|||
|
|
|
|||
|
|
|
|||
|
|
### Dockerfile
|
|||
|
|
Были созданы идентичные докер-файлы для приложений :
|
|||
|
|
```
|
|||
|
|
FROM openjdk:17 #базовый образ
|
|||
|
|
RUN mkdir -p /usr/src/app/ #создание директории
|
|||
|
|
WORKDIR /usr/src/app/ #установка рабочей директории проекта
|
|||
|
|
COPY . /usr/src/app/ #копирование файлов с хоста в контейнер
|
|||
|
|
RUN ./gradlew clean build #сборка проекта
|
|||
|
|
EXPOSE 8089 #объявление порта
|
|||
|
|
ENTRYPOINT ["java","-jar","build/libs/labIP-0.0.1-SNAPSHOT.jar"] #точка входа для контейнера
|
|||
|
|
```
|
|||
|
|
### nginx.conf
|
|||
|
|
Были созданы идентичные докер-файлы для приложений :
|
|||
|
|
```
|
|||
|
|
http {
|
|||
|
|
server {
|
|||
|
|
listen 80; #запросы по порту 80 для IPv4
|
|||
|
|
listen [::]:80; #запросы по порту 80 для IPv6
|
|||
|
|
server_name localhost; #имя сервера
|
|||
|
|
|
|||
|
|
location /client/ { #настройки для запросов, поступающих по пути /client/
|
|||
|
|
proxy_pass http://client:8089/; #прокси-перенаправление на адрес
|
|||
|
|
proxy_set_header Host $host; #установка дополнительных HTTP-заголовков
|
|||
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|||
|
|
proxy_set_header X-Forwarded-Proto $scheme;
|
|||
|
|
proxy_set_header X-Forwarded-Prefix /client;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
location /training/ { #настройки для запросов, поступающих по пути /training/
|
|||
|
|
proxy_pass http://training:8090/; #прокси-перенаправление на адрес
|
|||
|
|
proxy_set_header Host $host; #установка дополнительных HTTP-заголовков
|
|||
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|||
|
|
proxy_set_header X-Forwarded-Proto $scheme;
|
|||
|
|
proxy_set_header X-Forwarded-Prefix /training;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
events {
|
|||
|
|
worker_connections 1024; #максимальное количество одновременных соединений для каждого рабочего процесса
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
### docker-compose.yml
|
|||
|
|
Был создан файл docker-compose.yml для разворачивания сервисов:
|
|||
|
|
```
|
|||
|
|
version: "3" #формат конфигурации Docker Compose версии 3
|
|||
|
|
services: #определение сервисов
|
|||
|
|
client:
|
|||
|
|
build:
|
|||
|
|
context: /client #путь к контексту сборки
|
|||
|
|
dockerfile: Dockerfile #имя докерфайла
|
|||
|
|
ports:
|
|||
|
|
- "8089:8089" #проброс портов
|
|||
|
|
networks:
|
|||
|
|
- netwrk #сеть
|
|||
|
|
|
|||
|
|
training:
|
|||
|
|
build:
|
|||
|
|
context: /training #путь к контексту сборки
|
|||
|
|
dockerfile: Dockerfile #имя докерфайла
|
|||
|
|
ports:
|
|||
|
|
- "8090:8090" #проброс портов
|
|||
|
|
networks:
|
|||
|
|
- netwrk #сеть
|
|||
|
|
|
|||
|
|
nginx:
|
|||
|
|
image: nginx:latest #образ для контейнера
|
|||
|
|
ports:
|
|||
|
|
- "8091:80" #проброс портов
|
|||
|
|
networks:
|
|||
|
|
- netwrk #сеть
|
|||
|
|
volumes:
|
|||
|
|
- ./nginx.conf:/etc/nginx/nginx.conf #монтирует локальный файл конфигурации
|
|||
|
|
depends_on: #зависимость от сервисов
|
|||
|
|
- client
|
|||
|
|
- training
|
|||
|
|
|
|||
|
|
networks:
|
|||
|
|
netwrk:
|
|||
|
|
driver: bridge #изолированная сеть
|
|||
|
|
```
|
|||
|
|
***
|
|||
|
|
## *Результат:*
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|