ATE Documentation portal logo
Помощь
Обновлена 30 октября 2026 г. в 12:05

Глобальные переменные

Конфигурация Tarantool

Переменная

Описание

Рекомендуемое значение

В каких ролях используется

tarantool_iproto_ssl_params

Дополнительные настройки iproto.listen.params из документации Tarantool.

{}

Только в динамическом инвентаре

tarantool_migrations_directory

Путь на локальной машине к директории с миграциями, которые будут опубликованы и применены на удаленных хостах. Тип: string.

Нет

tt

tarantool_etcd_additional_prefixes

Список дополнительных префиксов в etcd, данные по которым должны быть включены в резервную копию и восстановлены вместе с основным конфигом кластера. Используется для резервного копирования данных, хранящихся в etcd по отдельным префиксам (например, данные шардирования для TCS). При использовании TCF с etcd-хранилищем (etcd_v2 или etcd_v3) префиксы tcf_gateway_storage_prefix и tcf_destination_storage_prefix добавляются в этот список автоматически. Для кластеров Tarantool 3.0+ в список также автоматически добавляется tt_config_storage_prefix, чтобы включить в резервную копию данные миграций, опубликованные через tt migrations publish. Тип: list. Значение по умолчанию: [].

[]

cartridge (backup/restore)

tarantool_config_key

Ключ для публикации конфигурации кластера в централизованном хранилище конфигурации (etcd или TBCS). Заменяет значение по умолчанию all в пути публикации конфигурации <prefix>/config/<key>. Соответствует аргументу key команды tt cluster publish. Если переменная не задана, конфигурация публикуется по ключу по умолчанию (all). Тип: string. Значение по умолчанию: all.

Нет

etcd, tt

tarantool_tt_connect_username

Имя пользователя для подключения к Tarantool при выполнении команд tt CLI. Тип: string.

Нет

tt

tarantool_tt_connect_password

Пароль для подключения к Tarantool при выполнении команд tt CLI. Тип: string.

Нет

tt

Управление правами доступа

Переменная

Описание

Рекомендуемое значение

В каких ролях используется

tarantool_dir_mode

Права доступа на директории. Тип: string.

0750

Во всех ролях, создающих каталоги

tarantool_file_mode

Права доступа на неисполняемые файлы. Тип: string.

0644

Во всех ролях, создающих файлы конфигурации и неисполняемые файлы

tarantool_exec_file_mode

Права доступа на исполняемые скрипты. Тип: string.

0755

В роли cartridge для установщика

tarantool_secret_file_mode

Права доступа на приватные ключи, токены, SSH-файлы. Тип: string.

0400

os_configure, etcd, logrotate

tarantool_user

Пользователь, от имени которого работают компоненты. Тип: string.

tarantool

Все роли (как owner)

Настройка SSL-соединения с etcd

Переменная

Описание

Рекомендуемое значение

В каких ролях используется

tarantool_etcd_schema_definition

Наименование протокола для передачи данных в etcd. Тип: string.

http

cartridge, etcd, systemd, tt

tarantool_config_etcd_ssl_key_file.

Путь к клиентскому SSL-ключу, используемому для установки соединения с etcd. Тип: string.

{}

etcd, systemd, tt

tarantool_config_etcd_ssl_cert_file.

Путь к клиентскому SSL-сертификату, используемому для установки соединения с etcd. Тип: string.

{}

etcd, systemd, tt

tarantool_config_etcd_ssl_ca_file.

Путь к доверенному CA-сертификату, используемому для установки соединения с etcd. Тип: string.

{}

etcd, systemd, tt

tarantool_config_etcd_ssl_verify_peer.

Наличие проверки peer-сертификата etcd. Тип: string.

False

systemd

tarantool_config_etcd_ssl_verify_host.

Наличие проверки master-сертификата etcd. Тип: string. Пример: '{"tarantool_config_etcd_ssl_verify_host": "False"}'.

False

systemd

Настройка аутентификации etcd

Переменная

Описание

Рекомендуемое значение

В каких ролях используется

tarantool_etcd_username.

Логин для подключения к etcd с включённой аутентификацией. Тип: string. Пример: user.

Нет

cartridge, etcd, tt, systemd

tarantool_etcd_password.

Пароль для подключения к etcd с включённой аутентификацией. Тип: string. Пример: mysecurepassword.

Нет

cartridge, etcd, tt, systemd

Проверка синхронизации репликации

Плейбук playbooks/wait_replication_sync.yml проверяет синхронизацию репликации перед плановыми операциями:

  • в playbooks/continuous_update.yml — перед каждым плановым переключением мастера, если tarantool_replication_sync_check_enabled: true. По умолчанию проверка выключена;
  • в playbooks/relocate_instances.yml — на новых инстансах перед удалением старых. Проверка выполняется всегда и не зависит от tarantool_replication_sync_check_enabled.

На целевых хостах плейбук ждёт, пока каждое существующее upstream-соединение имеет статус follow с известным лагом, модуль которого меньше tarantool_replication_sync_max_lag. RO-инстанс без upstream проверку не проходит: у него нет источника данных. RW-инстанс без upstream проходит проверку: ему не от кого догонять. Если у RW-инстанса есть upstream (например, при replication.failover: off, когда инстансы RW без единого лидера), он проверяется так же, как у RO-инстанса.

Значения по умолчанию переменных заданы в playbooks/group_vars/all/tarantool.yml.

Лаг — временная метрика, зависящая от часов узлов: отрицательное значение возможно при рассинхронизации времени. Проверка использует модуль значения и не доказывает равенство данных или число неприменённых строк. Записи приложения между опросом и переключением не блокируются.

Переменная

Описание

tarantool_replication_sync_check_enabled

Включает проверку синхронизации перед переключением в continuous_update.yml. На relocate_instances.yml не влияет — там проверка выполняется всегда. Тип: boolean. Значение по умолчанию: false.

tarantool_replication_sync_retries

Количество попыток проверки синхронизации репликации. Если синхронизация не достигнута за указанное число попыток, сценарий завершается с ошибкой, и плановая операция (переключение мастера или удаление старых инстансов при переносе) не выполняется. Тип: integer. Значение по умолчанию: 120.

tarantool_replication_sync_delay

Задержка в секундах между попытками проверки синхронизации репликации. Тип: integer. Значение по умолчанию: 5.

tarantool_replication_sync_max_lag

Максимальный допустимый модуль лага репликации (box.info.replication[*].upstream.lag) в секундах. Тип: number. Значение по умолчанию: 1.

Была ли статья полезна?