TDB Documentation portal logo
Помощь
Обновлена 30 июля 2026 г. в 16:49

Запуск Tarantool DB вручную

В этом руководстве показано, как развернуть Tarantool DB локально, используя утилиту TT CLI (tt).

Содержание:

Пререквизиты

Для выполнения примера требуются:

  • архив для развёртывания Tarantool DB. Архив можно скачать в личном кабинете tarantool.io, в разделе tarantooldb/release/for_deploy/;

  • утилита TT CLI;

  • исходные файлы примера up_with_tt.

Используемые файлы

В примере up_with_tt для конфигурации кластера используются файлы из директории ./tarantooldb/:

  • tt.yamlконфигурация TT CLI. Чтобы сгенерировать этот файл, используется команда tt init;

  • instances.yml — список узлов кластера для запуска в текущем окружении;

  • replicasets.yml — описание наборов реплик и их ролей.

Запуск стенда

Перейдите в директорию с примером up_with_tt:

cd ./docs/docs/ru/assets/examples/up_with_tt/

Загрузите в эту директорию архив для развёртывания Tarantool DB и распакуйте его:

tar -xzvf tarantooldb-<VERSION>.<OS>.<ARCH>.tar.gz

Здесь:

  • VERSION — версия продукта;
  • OS — поддерживаемая операционная система;
  • ARCH — архитектура процессора.

Пример: tarantooldb-1.0.0.linux.x86_64.tar.gz.

При распаковке будет создана директория tarantooldb. Переименовывать её нельзя. Скопируйте в эту директорию файлы instances.yml, replicasets.yml и tt.yml из директории up_with_tt:

cp *.yml tarantooldb/

После копирования перейдите в директорию tarantooldb:

cd tarantooldb

Запустите экземпляры Tarantool DB с помощью команды tt start:

tt start tarantooldb

Проверить состояние узлов можно, используя команду tt status:

tt status tarantooldb

Ответ выглядит так:

INSTANCE                      STATUS      PIDtarantooldb:router-msk        RUNNING     118242tarantooldb:router-spb        RUNNING     118243tarantooldb:storage-1-msk     RUNNING     118244tarantooldb:storage-1-spb     RUNNING     118245tarantooldb:storage-2-msk     RUNNING     118246tarantooldb:storage-2-spb     RUNNING     118247tarantooldb:stateboard        RUNNING     118249

Соберите кластер из узлов Tarantool DB:

tt cartridge replicasets setup --bootstrap-vshard --name tarantooldb

Теперь кластер доступен по адресу одного из узлов (кроме stateboard), например http://localhost:8081.

Остановка кластера

Остановить кластер можно с помощью команды tt stop:

tt stop tarantooldb