Запуск приложения на box.cfg¶
Приложение, настраивающее Tarantool через box.cfg в собственном скрипте,
как это делали приложения init.lua и <instance>.init.lua в tt 2.x,
запускается записями со script: это экземпляры Tarantool, которые
настраиваются своим скриптом, а не конфигурацией кластера. Такому
приложению не нужен config.yaml.
Описание экземпляров¶
.templates/default/instances.yaml:
legacy-001:
script: init.lua # относительно каталога приложения
env: {TT_MEMTX_MEMORY: "268435456"}
init.lua:
box.cfg{}
box.schema.space.create('kv', {if_not_exists = true})
$ tt instance start
$ tt instance status
INSTANCE STATUS PID MODE CONFIG BOX UPSTREAM
legacy:legacy-001 RUNNING 1330686 RW -- running --
$ echo "return box.cfg.memtx_memory" | tt connect legacy:legacy-001 -f-
---
- 268435456
...
Где экземпляр хранит файлы¶
Tarantool запускает скрипт в каталоге приложения. Параметры, которые скрипт
не передаёт сам, box.cfg берёт из окружения, а tt выставляет там
переменные структуры каталогов:
TT_WAL_DIR,TT_MEMTX_DIRиTT_VINYL_DIR: каталог данных,<root>/var/lib/<app>/<instance>/;TT_LISTEN: unix-сокетtarantool.sockв каталоге запуска, если толькоTT_LISTENне задана в окружении tt.
Сокет консоли - tarantool.control в каталоге запуска, а вывод идёт в tt.log.
Поле env записи идёт поверх и может переместить данные теми же переменными; в
областях установки пользователя и системы относительный путь в нём отклоняется.
Относительный путь, который скрипт передаёт в box.cfg сам, tt проверить не
может. В областях установки пользователя и системы он отсчитывается от
установленной версии, так что экземпляр пишет в каталог версии, который
заменяется при обновлении: пусть скрипт берёт пути из окружения.
Что с ними работает¶
tt connect,tt data play,tt instance statusиtt instance logrotateработают как с любым экземпляром Tarantool.tt instance checkпроверяет синтаксис скрипта.tt instance cleanудаляет его данные и журнал.tt cluster showиtt cluster publishотклоняют его: кластерная конфигурация им не управляет.- Цели уровня приложения в
tt replicasetпропускают его, когда в приложении есть и экземпляры конфигурации кластера. Приложение только из скриптовых экземпляров сохраняет их, иtt replicasetдействует на него с custom оркестратором без--custom;--configи--customпо-прежнему задают оркестратор принудительно.
См. также Переход с tt 2.x.