Кластер на ноутбуке¶
В этом руководстве мы создадим проект из встроенного шаблона 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 удаляет данные и журналы неработающих экземпляров.
Что дальше¶
- Первый пакет: пишем собственное приложение с зависимостями и тестами.
- Экземпляры: как tt определяет, что запускать.
tt instance: полный список флагов.