TDB Documentation portal logo
Помощь
Обновлена 30 июля 2026 г. в 16:49

Использование координаторов отказоустойчивости

В этом руководстве показано, как настроить работу внешних координаторов отказоустойчивости (supervised failover coordinators).

Содержание:

Пререквизиты

Для выполнения примера требуются:

  • установленные Docker-образы Tarantool DB, Prometheus и Grafana;

  • приложение Docker Compose;

  • исходные файлы примера failover_coordinator.

Запуск стенда

Перейдите в директорию примера failover_coordinator:

cd ./docs/docs/ru/assets/examples/failover_coordinator/

Запустите кластер Tarantool DB:

make start

Команда последовательно выполняет следующие шаги:

  1. Запускает централизованное хранилище конфигурации — кластер etcd;
  2. Загружает конфигурацию кластера в централизованное хранилище;
  3. Запускает кластер Tarantool DB;
  4. Загружает миграции в кластер и выполняет их.

Запущенный стенд состоит из:

  • кластера Tarantool DB:
    • 2 роутера;
    • 2 набора реплик по 3 хранилища;
    • 2 координатора отказоустойчивости;
    • 1 Tarantool Cluster Manager (TCM);
  • кластера etcd из 3 узлов;
  • средств мониторинга (Prometheus, Grafana).

После запуска должны работать все контейнеры, кроме init_host.

Также после запуска доступны следующие пользовательские интерфейсы:

Для входа в веб-интерфейс TCM откройте в браузере адрес http://localhost:8081. Логин и пароль для входа:

  • Username: admin
  • Password: secret

В TCM откройте вкладку Stateboard. После применения настроек кластер будет выглядеть так:

Использование координаторов отказоустойчивости

На вкладке Stateboard вызовите меню Actions кластера, нажав на кнопку ... справа от строки поиска. В меню выберите пункт Supervised failover. Откроется окно, в котором на вкладке Supervised failover отображаются все работающие координаторы кластера. Активный координатор отмечен в этом списке зелёной галочкой.

Использование координаторов отказоустойчивости

Проверка работы

В TCM перейдите на вкладку Stateboard. Нажмите на набор реплик router-msk. Выберите роутер router-msk и в открывшемся окне перейдите на вкладку Terminal.

Во вкладке Terminal введите следующую команду, чтобы добавить в спейс новый кортеж:

crud.insert_object('bands', {id = 1, band_name = 'Free Flow Flava', year = 2014})

После этого проверьте записанный кортеж с помощью операции crud.select():

crud.select('bands').rows

Теперь нужно остановить мастер-узлы. Чтобы определить мастер-узлы в наборе реплик, в TCM на вкладке Stateboard найдите в каждом наборе реплик экземпляр кластера с иконкой короны. В данном примере это узлы storage-1-brn и storage-2-brn.

Чтобы остановить эти экземпляры кластера, вернитесь в терминал ОС и выполните следующие команды:

cd cluster/docker compose stop tarantool-<имя_первого_мастера>docker compose stop tarantool-<имя_второго_мастера>cd ..

Видно, что мастер-узлы стали недоступны, а их лидерство передано другим экземплярам.

В TCM перейдите на вкладку Stateboard. Нажмите на набор реплик router-msk. Выберите роутер router-msk и в открывшемся окне перейдите на вкладку Terminal. Во вкладке Terminal введите следующую команду, чтобы добавить в спейс новый кортеж:

crud.insert_object('bands', {id = 2, band_name = 'Wax Tailor', year = 2001})

Кластер доступен для записи данных. Проверить кортеж, добавленный в спейс, можно так:

crud.select('bands').rows

Остановка стенда

Остановить стенд можно так:

make stop