Федерация библиотеки между экземплярами

Федерация библиотеки позволяет экземпляру Seatmap получать содержимое библиотеки из другого экземпляра Seatmap по HTTP. Используйте её, когда вы запускаете self-hosted развёртывание и хотите потреблять библиотеку схем, опубликованную из другого экземпляра, без репликации базы данных издателя.

Эта страница — обзор для пользователей. Для технических шагов настройки обратитесь к команде Seatmap или к вашему оператору.

Роли

Исходный экземпляр публикует содержимое библиотеки. Он выдаёт доступ к федерации для экземпляров-потребителей.
Экземпляр-потребитель настраивается с URL источника и учётными данными доступа. Он получает содержимое библиотеки по требованию и отображает его рядом со своими внутренними записями библиотеки.

Один экземпляр может быть источником, потребителем или и тем, и другим.

Как это работает

Глобальный администратор на исходном экземпляре выдаёт доступ к федерации для потребителя.
Оператор потребителя сохраняет учётные данные и настраивает URL источника.
Когда пользователи на экземпляре-потребителе просматривают библиотеку, федеративные записи появляются в той же сетке, что и внутренние записи.
Когда пользователь копирует федеративную площадку, экземпляр-потребитель получает схему и ресурсы из источника по HTTPS, материализует их в базу данных и хранилище ресурсов потребителя и фиксирует происхождение.

Что обеспечивается

Аутентификация: каждый федеративный запрос несёт учётные данные. Источник проверяет их перед выдачей содержимого.
Ограничение частоты: исходный экземпляр применяет ограничение частоты на учётные данные (по умолчанию 60 запросов в минуту, настраивается).
Аудит: каждая успешная и неуспешная выгрузка фиксируется для проверки на стороне источника.
Семантика снимков: федеративные копии фиксируются в момент копирования. Потребитель владеет копией с этого момента — обновления на стороне источника никогда не распространяются.

Что не федерируется

Идентичность пользователя — федерация работает только с данными. Пользователи не входят в систему между экземплярами.
Цены, события, бронирования — то же, что и для внутренней библиотеки. Только макеты.
Выгрузка из нескольких источников — экземпляр-потребитель имеет максимум один настроенный источник в этом релизе.

Заметки по эксплуатации

Учётные данные можно отозвать, но нельзя ротировать. Чтобы ротировать, отзовите старые учётные данные и выдайте новые — потребитель должен обновить свою конфигурацию.
Если источник недоступен, федеративные записи просто не появляются на стороне потребителя. Внутренние записи библиотеки продолжают работать.
Происхождение всегда указывает на исходный источник — даже если федеративная копия позже снова копируется внутри экземпляра-потребителя, копия второго порядка всё равно ссылается на исходный экземпляр.