Установка приложения для пользователя¶
Область установки пользователя позволяет запускать приложение без прав root: на
тестовом стенде, на машине разработчика или на хосте, где tt не установлен в
масштабе всей системы. Его корневой каталог в Linux находится в
~/.local/share/tarantool или задаётся через TT_USER_ROOT. Те же шаги
подходят и для области установки системы с флагом --scope system, запущенным
от root.
Для работы понадобится архив приложения, собранный командой tt package pack
(см. Ваш первый пакет).
Установка¶
$ tt package install --scope user kv-api-1.0.0-linux-amd64.tt
installed kv-api 1.0.0 into user scope
$ tt package list --scope user
NAME ACTIVE VERSIONS DESCRIPTION
kv-api 1.0.0 1.0.0
Архив становится версией versions/kv-api/kv-api_1.0.0/ области установки, а
ссылка apps/kv-api указывает на неё. Tarantool и tt, входящие в состав архива,
попадают в каталог versions/ области установки; доступ к сети не требуется.
Запуск¶
Проект не требуется: команды можно выполнять из любого каталога.
$ tt instance start kv-api:* --scope user
$ tt instance status kv-api:* --scope user
$ tt instance logs kv-api:kv-1 --scope user --follow
$ tt connect kv-api:kv-1 --scope user
Экземпляры запускаются по шаблону default этой версии и хранят свои данные в
каталоге var/lib/kv-api/ области установки.
Описание этого хоста¶
Шаблоны версии входят в состав пакета; обновление заменяет их. Чтобы задать, что
именно работает на этом хосте - какие экземпляры, какие порты и какие пароли, -
в каталог etc/<app>/ области установки записывают пару хоста. Она имеет
приоритет над шаблонами:
$ mkdir -p ~/.local/share/tarantool/etc/kv-api
$ cd ~/.local/share/tarantool/etc/kv-api
$ $EDITOR config.yaml # кластерная конфигурация этого хоста
$ $EDITOR instances.yaml # что здесь работает, например: kv-1: {restart: on-failure}
$ tt instance start kv-api:* --scope user
Для пары хоста обязателен файл instances.yaml: в нём указано, какие именно
экземпляры кластера работают на этом хосте. См.
Экземпляры.
Обновление¶
$ tt package install --scope user --upgrade kv-api-1.1.0-linux-amd64.tt
$ tt package list --scope user
NAME ACTIVE VERSIONS DESCRIPTION
kv-api 1.1.0 1.0.0, 1.1.0
$ tt instance restart kv-api:* --scope user --yes
Флаг --upgrade устанавливает только версию новее всех уже установленных. Новая
версия становится активной сразу, но работающий экземпляр продолжает выполнять
ту версию, с которой был запущен, в том числе при перезапуске
процессом-наблюдателем после падения; команда tt instance restart переводит
его на новую версию.
Откат¶
Отдельной команды отката нет. Повторная установка уже установленной версии
требует флага --force, который отклоняется при работающих экземплярах
приложения, поэтому для отката экземпляры останавливают:
$ tt instance stop kv-api:* --scope user --yes
$ tt package install --scope user --force kv-api-1.0.0-linux-amd64.tt
$ tt instance start kv-api:* --scope user
Удаление¶
$ tt instance stop kv-api:* --scope user --yes
$ tt package uninstall kv-api --scope user --yes
removed kv-api from user scope: versions 1.0.0, 1.1.0
Команда uninstall отклоняется, пока работает хотя бы один экземпляр. Она
удаляет все версии и ссылку apps/, сохраняя данные в var/, пару хоста в
etc/kv-api/ и среды выполнения в versions/, которые могут использоваться
другими приложениями.