Описание архитектуры Календаря VK WorkSpace
Введение
В настоящем документе приведено описание архитектуры продукта Календарь VK WorkSpace.
Данный документ предназначен для технических специалистов, которые внедряют или поддерживают приведенные технологические решения:
- системные администраторы;
- специалисты по информационной безопасности.
Документ предполагает наличие технических знаний в области проектирования систем, однако будет полезен и специалистам бизнес-подразделений.
Сокращения и определения
| Наименование | Определение |
|---|---|
| БД | База данных |
| Сайдкар | Разделение функций приложения в отдельный процесс |
| CalDAV | Протокол для синхронизации данных календаря и адресной книги между почтовым сервером и клиентом |
| Шардирование | Принцип проектирования базы данных, при котором данные разбиваются на части и размещаются на разных шардах, что способствует масштабируемости приложения |
Верхнеуровневая архитектура
Запросы пользователей поступают на балансировщик, который отвечает за прием и распределение пользовательских запросов на бэкенд Календаря VK WorkSpace, в свою очередь балансировщик отправляет запросы на отдачу динамически генерируемых веб-страниц и статических файлов для передачи в веб-клиент.
Бэкенд Календаря VK WorkSpace состоит из множества различных компонентов (будут рассмотрены ниже), которые отвечают за определенную часть бизнес-логики: межсистемное взаимодействие, миграции, отправка уведомлений и т.д.
Примечание
Авторизация и аутентификация пользователей выполняется группой сервисов swa на стороне продукта Почта VK WorkSpace.
Сервисы системы
Сервисы обработки входящих запросов
Все входящие запросы поступают на сервис балансировки и проксирования calendar-nginx, который, в свою очередь, перенаправляет запрос на необходимый сервис.
Сервис calendar-nginx взаимодействует с :
- caldavapi — для синхронизации календаря с внешними клиентами по протоколу CalDav;
- calendarapi — для обработки входящих запросов и перенаправления на необходимый сервис.
Сервисы бэкенда
Сервисы для синхронизации по CalDAV
Для реализации протокола CalDAV реализован микросервис caldavapi, на который приходят запросы клиентов для синхронизации данных, сaldavapi взаимодействует с сервисами:
- icser — при необходимости парсинга ics от клиента;
- calendarapi-internal — для выполнения любых действий над данными в БД (calendarpg);
- zubr — для авторизации в cube (входит в группу сервисов аутентификации и аторизации swa).
Общая схема сервисов приведена на рисунке ниже:
Описание сервисов приведено в таблице ниже:
| Наименование сервиса | Назначение |
|---|---|
| caldavapi | Сервис, реализующий сетевой протокол CalDAV. Используется для синхронизации календаря с внешними клиентами |
| calendarapi-internal | Основной API для межсерверного общения |
| zubr | Cайдкар для работы с профилями пользователей |
| icser | Cервис для разбора .ics файлов |
Сервисы уведомлений
Общая схема сервисов приведена на рисунке ниже:
Описание сервисов приведено в таблице ниже:
| Наименование сервиса | Назначение |
|---|---|
| calendarapi | Основной API для межсерверного общения |
| calendar-notifyapi | Сервис уведомлений. Получает информацию о создании и изменении настроек оповещений событий. Складывает их в очередь |
| calendar-notifier-zubr | Прокси-сервис для доступа к Tarantool. Содержит в себе логику работы с шардированием |
| calendar-notify-tnt-queue | Очередь рассылки уведомлений Календаря |
| calendar-notifyd | Демон, разбирающий очередь уведомлений. Получает актуальные на текущий момент оповещения и передает в почтовую и push-системы |
Сервисы переговорных комнат
Общая схема сервисов приведена на рисунке ниже:
Описание сервисов приведено в таблице ниже:
| Наименование сервиса | Назначение |
|---|---|
| confroom | Сервис переговорных комнат (проверка занятости и доступности переговорных комнат) |
| confroompg | База данных переговорных комнат календаря |
Сервисы обработки .ics запросов
Общая схема сервисов приведена на рисунке ниже:
Описание сервисов приведено в таблице ниже:
| Наименование сервиса | Назначение |
|---|---|
| icser | Cервис для разбора .ics файлов |
| ics-router | Балансировщик нагрузки между сервисами icser |
| calendarapi-internal | Основной API для межсерверного общения |
| calendarpg | БД Календаря |