Перейти к содержанию

Tarantool CLI

tt — утилита командной строки для разработки, упаковки, развёртывания и эксплуатации приложений на Tarantool.

Предварительная версия. Это документация tt 3, который ещё не вышел; она собрана из ветки v3. Документация tt 2.x — в документации Tarantool.

Что делает tt

  • Разработка. Приложение оформляется как пакет: app.manifest.toml описывает его зависимости и компоненты, tt package build собирает их, а tt run и tt test запускают код и тесты под Tarantool проекта.
  • Запуск. tt запускает экземпляры приложения на хосте: экземпляры Tarantool, настроенные конфигурацией кластера, экземпляры Tarantool со своим собственным скриптом и внешние процессы. Все они работают под процессом-наблюдателем (watchdog) tt — в фоне, на переднем плане или под systemd.
  • Упаковка и установка. tt package pack собирает архив приложения вместе с зависимостями и Tarantool, на котором оно работает, а tt package install устанавливает его для пользователя или для всей системы, без доступа к сети.
  • Управление бинарными файлами, на которых работает приложение: Tarantool Community и Enterprise, tt, TCM и Enterprise SDK — для проекта, для пользователя или для всей системы.
  • Эксплуатация кластера: его конфигурация, наборы реплик и failover, резервные копии и восстановление на момент времени (PITR).
  • Компоненты WebAssembly в Tarantool (экспериментально): код на Python, Go, Rust, C, JavaScript или C#, собранный в пакет и вызываемый из Lua; см. Run WebAssembly components и An HTTP API in a WebAssembly component.

Попробовать

$ tt create cluster --name myapp
$ cd myapp
$ tt binary install tarantool
$ tt instance start
$ tt instance status

Подробный разбор — в разделе Кластер на ноутбуке.

Что читать дальше

  • Что нового в tt 3: что умеет tt 3 и чего не умел tt 2.x.
  • Начало работы: установка tt, запуск кластера, создание пакета.
  • Концепции: проекты и области установки, пакеты, экземпляры — модель, общая для всех команд.
  • Пишем приложение: целое приложение, шаг за шагом.
  • Руководства: развёртывание, запуск под systemd, подпись пакетов, расширение tt, сборка модуля на Rust, запуск компонентов WebAssembly.
  • Справочник: все команды, файлы, которые читает tt, переменные окружения.
  • Переход с tt 2.x.