TCF 0.11.0

Дата релиза: 20.01.2026.

В релизе 0.11.0 представлены улучшения надёжности и масштабируемости репликации, расширены возможности мониторинга, добавлены новые параметры конфигурации для Gateway и Destination, а также реализована поддержка отзывов токенов авторизации.

В рамках задачи по горизонтальному масштабированию добавлены:

• новое поле конфигурации destination.gateway_clusters;
• параметр destination.shards;
• параметр gateway.destination_connect_timeout.

Цели изменений:

• распределение нагрузки по шард-группам;
• возможность назначения отдельных Gateway и Destination на подмножество шардов;
• сохранение отказоустойчивости в группах Gateway/Destination.

Добавлен параметр gateway.read_snapshot_from_file (boolean). Значение по умолчанию: false. Назначение – продолжение холодной загрузки данных после сбоев.

Поведение при значениях true/false:

• true – для холодной загрузки данных используется последний файл .snap, что позволяет продолжать чтение снимка данных при неполадках без повторной инициализации;
• false – для холодной загрузки данных на стороне Tarantool создаётся виртуальное представление для чтения (read view). При возникновении неполадок требуется перезапустить процесс холодной загрузки с повторной инициализацией (rebootstrap).

Добавлен параметр gateway.heartbeat_interval.

Назначение:

• предотвращение появления разрывов в журналах репликации (XlogGap);
• обновление vclock даже при отсутствии пользовательских изменений;
• корректный выбор точки репликации после рестартов.

Добавлены параметры:

• gateway.batch_size
• gateway.batch_timeout
• destination.batch_size
• destination.batch_size

Возможности пакетной обработки:

• объединение сообщений в одну транзакцию при вставке на Tarantool;
• снижение накладных расходов и повышение производительности.

Добавлена поддержка пользовательских лейблов для метрик Prometheus:

• gateway.metrics_labels
• destination.metrics_labels

Это позволяет расширять метрики под конкретные сценарии эксплуатации и визуализировать их на специализированных панелях мониторинга. Подробнее о параметрах в разделе Конфигурация репликаторов данных.

Для получения значений метрик используйте адрес обработчика запроса /metrics. Подробнее в справочнике.

Введена поддержка проверки отзывов токенов Keycloak. Теперь при наличии настроенного сервис-клиента выполняется онлайн-проверка токена с использованием пары client_id/client_secret.

Поведение:

• при отзывe токена запрос завершается ошибкой 401 Unauthorized;
• токены, формально валидные для TCF 0.9.0, но отозванные в Keycloak, больше не принимаются.

Проверка отзыва работает только при наличии корректно настроенного клиента сервиса. Подробнее о настройке клиента сервиса для:

• кластеров Tarantool Cartridge

• TCF-worker

• Gateway

• Destination

Начиная с версии 0.11.0, направление репликации зависит от параметра gateway.one_way_replication. Если параметр задан, включается односторонняя репликация. При отсутствии параметра репликация происходит в обе стороны. Включение односторонней репликации через задание адресов в конфигурации репликаторов считается устаревшим способом.

Подробнее о репликации в разделе Архитектура.

Добавлена поддержка конфигурации репликатора Gateway, необходимой для совместного использования:

• горизонтального масштабирования;
• отказоустойчивых групп Gateway.

Подробнее о секциях storage и storage_params в справочнике.