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

Установка приложения для пользователя

Область установки пользователя позволяет запускать приложение без прав 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/, которые могут использоваться другими приложениями.