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

Кластер на ноутбуке

В этом руководстве мы создадим проект из встроенного шаблона cluster, запустим четыре его экземпляра на localhost, подключимся к одному из них и наведём порядок. Это займёт пару минут и не требует прав root.

Создание проекта

$ tt create cluster --name myapp
$ cd myapp

tt create запрашивает число наборов реплик, число реплик в каждом из них, а также пользователя и пароль кластера; достаточно нажать Enter, чтобы оставить значения по умолчанию: два набора реплик по два экземпляра в каждом, пользователь client с паролем secret. Флаг -s позволяет применить их без лишних вопросов.

Проект представляет собой каталог с кодом приложения и шаблоном экземпляров, из которого оно запускается:

myapp/
├── .templates
│   └── default
│       ├── config.yaml      # конфигурация кластера: пользователи, наборы реплик, порты
│       └── instances.yaml   # что запускается на этом хосте
└── app.lua

instances.yaml содержит одну запись "*": {}, которая обозначает каждый экземпляр топологии из config.yaml. См. Экземпляры.

Установка Tarantool в проект

$ tt binary install tarantool

Команда устанавливает свежий релиз Tarantool Community в каталог .tarantool/ проекта. Команды управления экземплярами этого проекта будут использовать именно его, независимо от того, какой tarantool находится в PATH. Чтобы запустить его самостоятельно, команда source .env/activate.sh помещает его первым в PATH.

Запуск экземпляров

$ tt instance start
   • Starting an instance [myapp:replicaset-001-a]...
   • Starting an instance [myapp:replicaset-001-b]...
   • Starting an instance [myapp:replicaset-002-a]...
   • Starting an instance [myapp:replicaset-002-b]...
$ tt instance status
 INSTANCE                STATUS   PID      MODE  CONFIG  BOX      UPSTREAM
 myapp:replicaset-001-a  RUNNING  1303991  RW    ready   running  --
 myapp:replicaset-001-b  RUNNING  1303992  RO    ready   running  --
 myapp:replicaset-002-a  RUNNING  1303993  RW    ready   running  --
 myapp:replicaset-002-b  RUNNING  1303994  RO    ready   running  --

Каждый экземпляр работает в фоне под процессом-наблюдателем (watchdog) tt. Внутри проекта команды действуют на его экземпляры; имя экземпляра формируется как <application>:<instance>, а само приложение называется по имени каталога проекта.

Экземпляры хранят свои данные, журналы и сокеты в каталоге .tarantool/var/:

.tarantool/var/
├── lib/myapp/replicaset-001-a/   # *.snap, *.xlog
├── log/myapp/replicaset-001-a/   # tt.log
└── run/myapp/replicaset-001-a/   # tt.pid, tarantool.pid, tarantool.control

Подключение

Команда tt connect myapp:replicaset-001-a открывает интерактивную консоль к экземпляру через его сокет управления. С флагом -f- она вместо этого выполняет Lua-код, прочитанный со стандартного ввода:

$ echo "box.info.ro" | tt connect myapp:replicaset-001-a -f-
---
- false
...

К экземпляру можно подключиться и по сети, указав пользователя из конфигурации кластера:

$ echo "return box.space._space:count()" | tt connect client:secret@127.0.0.1:3301 -f-

Просмотр журналов

$ tt instance logs myapp:replicaset-001-a -n 3
$ tt instance logs myapp:replicaset-001-a --follow

Остановка и очистка

$ tt instance stop --yes
$ tt instance clean --yes

Команды stop и clean просят подтверждения, которое пропускает флаг --yes. clean удаляет данные и журналы неработающих экземпляров.

Что дальше