Tarantool CE/EE Documentation portal logo
Помощь
Обновлена 15 сентября 2026 г. в 08:55

Опции командной строки tarantool

tarantool — это сервер базы данных и приложений Tarantool. Эту команду можно использовать для различных целей, например, для запуска отдельного экземпляра Tarantool или запуска внешнего координатора, используемого для управляемого отказа. Команда tarantool также предоставляет дополнительные опции, которые могут быть полезны в процессе разработки.

Запуск экземпляров с помощью команды tarantool

Ниже приведен синтаксис запуска экземпляра Tarantool, настроенного в файле:

$ tarantool [OPTION ...] --name INSTANCE_NAME --config CONFIG_FILE_PATH

Команда ниже запускает router-a-001, настроенный в файле config.yaml:

$ tarantool --name router-a-001 --config config.yaml

Опции

-h, --help

Вывести аннотированный список всех доступных опций и завершить работу.

--help-env-list

Начиная с: 3.0.0.

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

--failover

Начиная с: 3.1.0.

Запустить внешний координатор, используемый для управляемого отказа.

--force-recovery

Начиная с: 3.0.0.

Попытаться запустить экземпляр при возникновении ошибки чтения поврежденного файла снапшота или журнала упреждающей записи в процессе восстановления:

При включенной опции Tarantool пропускает недействительные записи, считывает как можно больше данных и позволяет процессу завершиться с предупреждением. После запуска экземпляра вызовите box.snapshot(), чтобы создать новый снапшот, чтобы поврежденные снапшоты или журналы упреждающей записи больше не использовались при восстановлении.

Также можно включить принудительное восстановление с помощью переменной окружения TT_FORCE_RECOVERY. Переменная TT_FORCE_RECOVERY имеет более низкий приоритет, чем опция --force-recovery.

Пример на GitHub: force_recovery

-v, -V, --version

Вывести название продукта и версию.

Пример

$ tarantool --versionTarantool Enterprise 3.0.0-beta1-2-gcbb569b4c-r607-gc64Target: Linux-x86_64-RelWithDebInfo...

В этом примере:

  • 3.0.0 — версия Tarantool. Tarantool следует семантическому версионированию, которое описано в разделе Политика выпуска Tarantool.
  • Target — платформа, на которой собран Tarantool. За этой строкой могут следовать специфичные для платформы детали.

-c, --config PATH

Начиная с: 3.0.0.

Задать путь к YAML-файлу конфигурации. Это значение также можно задать с помощью переменной окружения TT_CONFIG.

См. также: configuration_run_instance_tarantool

-n, --name INSTANCE

Начиная с: 3.0.0.

Задать имя запускаемого экземпляра. Это значение также можно задать с помощью переменной окружения TT_INSTANCE_NAME.

См. также: configuration_run_instance_tarantool

-i

Войти в интерактивный режим.

Пример

$ tarantool -i

-e EXPR

Выполнить строку 'EXPR'. См. также: lua man page.

Пример

$ tarantool -e 'print("Hello, world!")'Hello, world!

-l NAME

Подключить библиотеку 'NAME'. См. также: lua man page.

Пример

$ tarantool -l luatest.coverage script.lua

-j cmd

Выполнить управляющую команду LuaJIT. См. также: Command Line Options.

Пример

$ tarantool -j off app.lua

-b ...

Сохранить или вывести список байт-кода. См. также: Command Line Options.

Пример

$ tarantool -b test.lua test.out

-d SCRIPT

Активировать сеанс отладки для 'SCRIPT'. См. также: luadebug.lua.

Пример

$ tarantool -d app.lua

Прекратить обработку опций. См. также: lua man page.

-

Прекратить обработку опций и выполнить стандартный ввод как файл. См. также: lua man page.