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

Запуск приложений Tarantool

$ tt start [APPLICATION[:APP_INSTANCE]]

Команда tt start запускает приложения Tarantool. Файлы приложения должны находиться в каталоге instances_enabled, указанном в файле конфигурации tt. Подробные инструкции по подготовке и запуску приложений Tarantool см. в статьях Окружение и структура приложения и и Запуск и остановка экземпляров.

См. также описания команд tt stop, tt restart, tt status.

Чтобы запустить все экземпляры приложения, хранящегося в каталоге app внутри instances_enabled, в соответствии с его файлом instances.yaml:

$ tt start app

Чтобы запустить все экземпляры приложения app с выводом их журналов в stdout (в интерактивном режиме):

$ tt start -i app

Чтобы запустить экземпляр router приложения app:

$ tt start app:router

При вызове без аргументов запускает все включенные приложения в текущем окружении:

$ tt start

Структура приложения

Команда tt start может запускать целые кластеры Tarantool на основе их YAML-конфигураций. Каталог кластерного приложения внутри instances_enabled должен содержать следующие файлы:

  • config.yamlYAML-конфигурация, определяющая топологию и настройки кластера. Она может содержать как явную конфигурацию в формате YAML, так и ссылку на централизованное хранилище конфигураций (для Enterprise Edition).
  • instances.yaml – файл, определяющий список экземпляров кластера для запуска в текущем окружении.
  • (Опционально) файлы *.lua с кодом для загрузки и выполнения в кластере.

Подробнее о структуре приложений Tarantool см. в разделе Окружение и структура приложения.

Фоновый запуск

Команда tt start запускает приложения Tarantool в фоновом режиме и использует собственный процесс-наблюдатель (watchdog) для проверки статуса и остановки приложения.

Проверка целостности

Команда tt start может выполнять начальную и периодическую проверку целостности окружения, приложения и централизованной конфигурации.

Чтобы включить проверку целостности файлов окружения и приложения, упакуйте приложение с помощью tt pack с параметром --with-integrity-check. Этот параметр генерирует и подписывает контрольные суммы исполняемых файлов и файлов конфигурации в текущем окружении tt. Подробнее см. в разделе Формирование файлов для проверки целостности.

Чтобы включить проверку целостности конфигурации в централизованном хранилище, опубликуйте конфигурацию в этом хранилище с помощью tt cluster publish с параметром --with-integrity-check. Этот параметр генерирует и подписывает контрольные суммы конфигурации и сохраняет их в хранилище. Подробнее см. в разделе Публикация конфигураций с проверкой целостности.

Чтобы выполнять проверку целостности при запуске приложения, запустите его с глобальным параметром --integrity-check. Его аргументом должен быть открытый ключ, соответствующий закрытому ключу, который использовался для генерирования контрольных сумм.

$ tt --integrity-check public.pem start myapp

После такого вызова tt проверяет целостность окружения, приложения и конфигурации с помощью контрольных сумм и в случае успеха запускает приложение. Затем проверки целостности выполняются периодически во время работы приложения. По умолчанию они выполняются раз в 24 часа. Период проверки целостности можно настроить с помощью параметра --integrity-check-period:

$ tt --integrity-check public.pem start myapp --integrity-check-period 60

Кроме того, Tarantool проверяет целостность модулей, используемых приложением, во время загрузки, то есть при вызове require('module').

Если проверка целостности завершается неудачей, tt останавливает приложение.

Параметры

-i, --interactive

Запуск приложения или экземпляра в интерактивном режиме. В этом режиме журналы экземпляра выводятся в стандартный вывод в реальном времени.

Для остановки tt и его дочерних процессов Tarantool в интерактивном режиме можно использовать сигнал SIGINT (CTRL+C). Процессы-наблюдатели при этом не создаются.

--integrity-check-interval NUMBER

Интервал проверки целостности в секундах. По умолчанию: 86400 (24 часа). Установите значение 0 для этого параметра, чтобы отключить периодические проверки.

См. также раздел Проверка целостности