Миграция с tarantoolctl на tt

tt – это утилита командной строки для управления приложениями Tarantool, пришедшая на смену tarantoolctl. Начиная с версии 3.0 tarantoolctl больше не поставляется в составе дистрибутива Tarantool; tt – единственный рекомендуемый инструмент для управления приложениями Tarantool из командной строки.

tarantoolctl остается полностью совместимым с версиями Tarantool 2.*. Однако больших обновлений для него больше не выпускается.

Рекомендуется выполнить миграцию с tarantoolctl на tt, чтобы обеспечить полную поддержку, а также своевременное получение обновлений и исправлений.

tt по умолчанию поддерживает настройку общесистемного окружения. Если в таком окружении есть экземпляры Tarantool, управляемые с помощью tarantoolctl, можно перейти на tt без дополнительных шагов миграции или использовать tt совместно с tarantoolctl.

Пример:

 
$ sudo tt instancesList of enabled applications:• example$ tarantoolctl start exampleStarting instance example...Forwarding to 'systemctl start tarantool@example'$ tarantoolctl status exampleForwarding to 'systemctl status tarantool@example'● tarantool@example.service - Tarantool Database Server    Loaded: loaded (/lib/systemd/system/tarantool@.service; enabled; vendor preset: enabled)    Active: active (running)    Docs: man:tarantool(1)    Main PID: 6698 (tarantool). . .$ sudo tt status• example: RUNNING. PID: 6698.$ sudo tt connect example• Connecting to the instance...• Connected to /var/run/tarantool/example.control/var/run/tarantool/example.control>$ sudo tt stop example• The Instance example (PID = 6698) has been terminated.$ tarantoolctl status exampleForwarding to 'systemctl status tarantool@example'○ tarantool@example.service - Tarantool Database Server    Loaded: loaded (/lib/systemd/system/tarantool@.service; enabled; vendor preset: enabled)    Active: inactive (dead)

Если используется локальная конфигурация tarantoolctl, создайте окружение tt на основе существующего файла конфигурации .tarantoolctl. Для этого выполните tt init в каталоге, где находится этот файл.

Пример:

 
$ cat .tarantoolctldefault_cfg = {    pid_file  = "./run/tarantool",    wal_dir   = "./lib/tarantool",    memtx_dir = "./lib/tarantool",    vinyl_dir = "./lib/tarantool",    log       = "./log/tarantool",    language  = "Lua",}instance_dir = "./instances.enabled"$ tt init• Found existing config '.tarantoolctl'• Environment config is written to 'tt.yaml'

После этого можно управлять экземплярами Tarantool в этом окружении с помощью tt:

 
$ tt start app1• Starting an instance [app1]...$ tt status app1• app1: RUNNING. PID: 33837.$ tt stop app1• The Instance app1 (PID = 33837) has been terminated.$ tt check app1• Result of check: syntax of file '/home/user/instances.enabled/app1.lua' is OK

Большинство команд tarantoolctl выглядят так же и в tt: tarantoolctl start и tt start, tarantoolctl play и tt play и так далее. Для миграции таких вызовов обычно достаточно заменить имя утилиты. Возможны незначительные отличия в параметрах команд и формате вывода. Подробности о командах tt см. в справочнике команд tt.

Следующие команды в tt отличаются:

Пример:

 
# tarantoolctl enter > tt connect$ tarantoolctl enter app1connected to unix/:./run/tarantool/app1.controlunix/:./run/tarantool/app1.control>$ tt connect app1• Connecting to the instance...• Connected to /home/user/run/tarantool/app1/app1.control# tarantoolctl eval > tt connect -f$ tarantoolctl eval app1 eval.luaconnected to unix/:./run/tarantool/app1.control---- 42...$ tt connect app1 -f eval.lua---- 42...# tarantoolctl connect > tt connect$ tarantoolctl connect localhost:3301connected to localhost:3301localhost:3301>$ tt connect localhost:3301• Connecting to the instance...• Connected to localhost:3301