mufassall

Шпаргалка · Архитектура

Микросервисы

13 мин · Средний · mufassall.dtwin.uz/ru/l/microservices/

← Открыть урок

Проблема

Книжный интернет-магазин начинается с одного приложения и одной базы. Когда разделение на сервисы помогает, чего стоит каждое разделение и где место API gateway.

Чему вы научитесь

  • Почему начинать с монолита и по каким признакам понять, что пора делить
  • Что даёт разделение: независимые деплои, команды и масштабирование
  • Чего оно стоит: сетевые вызовы, частичные отказы, владение данными, распределённая отладка
  • Что делает API gateway на входе
Итоговая сцена
40%35%50%30%

Диаграмма как код

Итоговая схема урока в виде текста: вставьте её в 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_pay

Mermaid: последовательность запросов

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=48211

D2

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_pay

PlantUML: последовательность запросов

@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
@enduml

PlantUML: компоненты

@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/день
Запрос p95140 мс280 мс
Сервисов на заказ14
Неудачные запросы0,3%0,4%

Шаги

  1. Кейс Одно приложение, одна база

    Магазин — это одно приложение с одной базой.

  2. Проблема Проблема одной команды — проблема всех

    Через два года: 40 разработчиков в пяти командах, одна кодовая база.

  3. Решение Выносим то, что болит

    Поиск становится отдельным сервисом со своим индексом, у него одна команда-владелец.

  4. Кейс API gateway: одна входная дверь

    Клиенты видят один хост.

  5. Решение У платежей свой сервис и своя база

    Команда платежей хочет деплоиться каждый день и держать карточные данные подальше от остального.

  6. Проблема Частичный отказ

    Сервис платежей падает.

  7. Проблема Чтение чужих таблиц

    Чтобы показать сумму заказа, команда платежей читает базу магазина напрямую.

  8. Решение Владейте данными, публикуйте события

    Чужого чтения и прямого вызова больше нет.

  9. Кейс Счёт: отладка через несколько сервисов

    Один заказ теперь проходит через gateway, приложение, журнал событий и платежи.

  10. Итоги Итоги

    Начинайте с монолита с чистыми модулями.

Термины

Микросервис
Небольшой сервис со своим деплоем и своими данными; остальные обращаются к нему только через API или события. Цена — сетевые вызовы, частичные отказы и отсутствие общей транзакции, поэтому начинают с чистого монолита.
API gateway
Единая входная дверь перед всеми сервисами: проверяет токен, применяет rate limit, добавляет request id и маршрутизирует по пути. Скрывает внутреннее устройство от клиентов.