Шпаргалка · Архитектура
Микросервисы
Проблема
Книжный интернет-магазин начинается с одного приложения и одной базы. Когда разделение на сервисы помогает, чего стоит каждое разделение и где место API gateway.
Чему вы научитесь
- Почему начинать с монолита и по каким признакам понять, что пора делить
- Что даёт разделение: независимые деплои, команды и масштабирование
- Чего оно стоит: сетевые вызовы, частичные отказы, владение данными, распределённая отладка
- Что делает API gateway на входе
Диаграмма как код
Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).
Mermaid: схема
flowchart LR
n_client(["Покупатель"])
n_app["Приложение магазина"]
n_db[("База магазина")]
n_gw{"API gateway"}
n_search["Сервис поиска"]
n_pay["Сервис платежей"]
n_paydb[("База платежей")]
n_queue[["Журнал событий"]]
n_app --> n_db
n_client --> n_gw
n_gw --> n_app
n_gw --> n_search
n_pay --> n_paydb
n_app --> n_queue
n_queue --> n_payMermaid: последовательность запросов
sequenceDiagram
participant n_app as Приложение магазина
participant n_db as База магазина
participant n_client as Покупатель
participant n_gw as API gateway
participant n_search as Сервис поиска
participant n_pay as Сервис платежей
participant n_queue as Журнал событий
Note over n_app,n_db: Одно приложение, одна база
n_app->>n_db: BEGIN#59;
Note over n_client,n_app: Проблема одной команды — проблема всех
n_client->>n_app: GET /v1/search?q=dune HTTP/1.1
n_app-->>n_client: HTTP/1.1 200 OK
Note over n_gw,n_search: Выносим то, что болит
n_gw->>n_search: GET /v1/search?q=dune HTTP/1.1
n_search-->>n_gw: HTTP/1.1 200 OK
Note over n_client,n_gw: API gateway: одна входная дверь
n_client->>n_gw: GET /api/search?q=dune HTTP/1.1
n_gw-->>n_client: HTTP/1.1 200 OK
Note over n_app,n_pay: У платежей свой сервис и своя база
n_app->>n_pay: POST /internal/payments HTTP/1.1
n_pay-->>n_app: HTTP/1.1 201 Created
Note over n_app,n_pay: Частичный отказ
n_app-xn_pay: POST /internal/payments HTTP/1.1
Note over n_pay,n_db: Чтение чужих таблиц
n_pay->>n_db: SELECT total FROM orders WHERE id = 9001#59;
n_db-->>n_pay: ERROR: column #34;total#34; does not exist
Note over n_app,n_queue: Владейте данными, публикуйте события
n_app->>n_queue: produce topic=orders.events key=9001
Note over n_queue,n_pay: Счёт: отладка через несколько сервисов
n_queue->>n_pay: consume orders.events partition=2 offset=48211D2
direction: right
n_client: "Покупатель" {
shape: rectangle
}
n_app: "Приложение магазина" {
shape: rectangle
}
n_db: "База магазина" {
shape: cylinder
}
n_gw: "API gateway" {
shape: diamond
}
n_search: "Сервис поиска" {
shape: rectangle
}
n_pay: "Сервис платежей" {
shape: rectangle
}
n_paydb: "База платежей" {
shape: cylinder
}
n_queue: "Журнал событий" {
shape: queue
}
n_app -> n_db
n_client -> n_gw
n_gw -> n_app
n_gw -> n_search
n_pay -> n_paydb
n_app -> n_queue
n_queue -> n_payPlantUML: последовательность запросов
@startuml
participant "Приложение магазина" as n_app
database "База магазина" as n_db
participant "Покупатель" as n_client
participant "API gateway" as n_gw
participant "Сервис поиска" as n_search
participant "Сервис платежей" as n_pay
queue "Журнал событий" as n_queue
note over n_app, n_db : Одно приложение, одна база
n_app -> n_db : BEGIN;
note over n_client, n_app : Проблема одной команды — проблема всех
n_client -> n_app : GET /v1/search?q=dune HTTP/1.1
n_app --> n_client : HTTP/1.1 200 OK
note over n_gw, n_search : Выносим то, что болит
n_gw -> n_search : GET /v1/search?q=dune HTTP/1.1
n_search --> n_gw : HTTP/1.1 200 OK
note over n_client, n_gw : API gateway: одна входная дверь
n_client -> n_gw : GET /api/search?q=dune HTTP/1.1
n_gw --> n_client : HTTP/1.1 200 OK
note over n_app, n_pay : У платежей свой сервис и своя база
n_app -> n_pay : POST /internal/payments HTTP/1.1
n_pay --> n_app : HTTP/1.1 201 Created
note over n_app, n_pay : Частичный отказ
n_app ->x n_pay : [потеряно] POST /internal/payments HTTP/1.1
note over n_pay, n_db : Чтение чужих таблиц
n_pay -> n_db : SELECT total FROM orders WHERE id = 9001;
n_db --> n_pay : ERROR: column "total" does not exist
note over n_app, n_queue : Владейте данными, публикуйте события
n_app -> n_queue : produce topic=orders.events key=9001
note over n_queue, n_pay : Счёт: отладка через несколько сервисов
n_queue -> n_pay : consume orders.events partition=2 offset=48211
@endumlPlantUML: компоненты
@startuml
left to right direction
agent "Покупатель" as n_client
component "Приложение магазина" as n_app
database "База магазина" as n_db
node "API gateway" as n_gw
component "Сервис поиска" as n_search
component "Сервис платежей" as n_pay
database "База платежей" as n_paydb
queue "Журнал событий" as n_queue
n_app --> n_db
n_client --> n_gw
n_gw --> n_app
n_gw --> n_search
n_pay --> n_paydb
n_app --> n_queue
n_queue --> n_pay
@endumlИтог
Начинайте с монолита с чистыми модулями. Делите только по причине, которую можете назвать.
1) Хорошие причины: команды блокируют друг друга, у части совсем другая нагрузка, части нужен свой темп релизов или изоляция. 2) Каждое разделение превращает вызов функции в сетевой вызов: таймауты, частичные отказы, нет общей транзакции. 3) Каждый сервис владеет своими данными; остальные ходят через API или события. 4) На входе — gateway для авторизации, лимитов и маршрутизации. 5) Заложите трейсинг и центральные логи до разделения, а не после.
Показатели: в начале и в конце
| Показатель | В начале | В конце |
|---|---|---|
| Деплои | 0,1/день | 6/день |
| Запрос p95 | 140 мс | 280 мс |
| Сервисов на заказ | 1 | 4 |
| Неудачные запросы | 0,3% | 0,4% |
Шаги
- Кейс Одно приложение, одна база
Магазин — это одно приложение с одной базой.
- Проблема Проблема одной команды — проблема всех
Через два года: 40 разработчиков в пяти командах, одна кодовая база.
- Решение Выносим то, что болит
Поиск становится отдельным сервисом со своим индексом, у него одна команда-владелец.
- Кейс API gateway: одна входная дверь
Клиенты видят один хост.
- Решение У платежей свой сервис и своя база
Команда платежей хочет деплоиться каждый день и держать карточные данные подальше от остального.
- Проблема Частичный отказ
Сервис платежей падает.
- Проблема Чтение чужих таблиц
Чтобы показать сумму заказа, команда платежей читает базу магазина напрямую.
- Решение Владейте данными, публикуйте события
Чужого чтения и прямого вызова больше нет.
- Кейс Счёт: отладка через несколько сервисов
Один заказ теперь проходит через gateway, приложение, журнал событий и платежи.
- Итоги Итоги
Начинайте с монолита с чистыми модулями.
Термины
- Микросервис
- Небольшой сервис со своим деплоем и своими данными; остальные обращаются к нему только через API или события. Цена — сетевые вызовы, частичные отказы и отсутствие общей транзакции, поэтому начинают с чистого монолита.
- API gateway
- Единая входная дверь перед всеми сервисами: проверяет токен, применяет rate limit, добавляет request id и маршрутизирует по пути. Скрывает внутреннее устройство от клиентов.