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

Управление бинарными файлами

tt binary устанавливает, показывает, переключает и удаляет программы, на которых работают приложения:

Продукт Что это
tarantool Tarantool Community Edition, 3.0 и новее; Enterprise с версией ee
tarantool-ee Tarantool Enterprise Edition
tt tt; tt Enterprise с версией ee
tt-ee tt Enterprise
tcm Tarantool Cluster Manager
tarantool-sdk (sdk) Enterprise SDK: Tarantool Enterprise, tt Enterprise, TCM и заголовочные файлы

Каждая команда действует в одной области установки: --scope project (по умолчанию), user или system, и никогда не переходит в другой.

Установка и переключение

$ tt binary install tarantool                 # самый свежий релиз Community, в проект
$ tt binary install tarantool 3.8 --scope user
$ tt binary list
$ tt binary switch tarantool 3.8.1
$ tt binary uninstall tarantool 3.9.0

Установленная последней версия становится активной: <root>/bin/tarantool указывает на неё, а <root>/include/tarantool - на её заголовочные файлы. Каждая версия хранится в <root>/versions/<product>/<product>_<version>/, с заголовочными файлами в своём каталоге include/tarantool/. Tarantool Community и Enterprise делят общую активную ссылку tarantool, а tt и tt Enterprise - ссылку tt.

Чтобы использовать активные бинарные файлы, путь <root>/bin добавляют в PATH для областей установки пользователя и системы, а в проекте выполняют source .env/activate.sh. Первый вызов tt binary install в проекте создаёт .env/activate.sh и .env/deactivate.sh; существующие скрипты не перезаписываются. Командам управления экземплярами проекта эти скрипты не нужны: они запускают Tarantool проекта сами. Не нужны они и сборке его компонентов: backend сборки и hook находят программы из .tarantool/bin раньше, чем в PATH.

Релизы Community ставятся из готовых бинарных файлов там, где они есть, - Tarantool на Linux amd64 и arm64 с glibc, из статических RPM-пакетов rws.tarantool.org, tt на Linux amd64 и arm64, tt 3 на macOS arm64 и tt 2 на macOS amd64, из релизов tt на GitHub, - а на остальных платформах собираются из исходного кода. У дистрибутива tt могут быть другие источники или ни одного (bundle_sources в tt.manifest.toml): без источника Tarantool или tt каждая его версия собирается из исходного кода. Коммит, master, pull request (pr/<number>) и --local-repo собираются из исходного кода всегда; --source-build тоже собирает релиз из исходного кода. Поиск и установка Enterprise-сборок tt доступны только на Linux amd64.

Удаление активной версии делает активной самую свежую из оставшихся в той же области установки; вызов uninstall без указания версии удаляет единственную установленную.

Выбор версии

  • Community Edition: 3, 3.8 или 3.8.1 выбирают самый свежий подходящий релиз; вызов без версии выбирает самый свежий релиз.
  • Enterprise Edition: добавление ee - 3ee, 3.8ee, 3.8.1ee - к tt binary install tarantool или tt binary install tt. Так выбирается самая свежая подходящая стабильная сборка; для Tarantool Enterprise по умолчанию берётся сборка с gc64. Полное имя архива, например gc64-3.8.0-0-r94, архив nogc64 или release candidate выбирают именно эту сборку.
  • TCM: 1, 1.3 или 1.3.1 выбирают самую свежую подходящую стабильную сборку.
  • SDK: как и для Enterprise - без версии, X, X.Y или X.Y.Z выбирают самый свежий стабильный SDK с gc64, а полное имя архива - точную сборку.

Отдельный релиз Tarantool Enterprise устанавливается под своей версией Tarantool, 3.8.1, без префикса gc64, номера ревизии и хеша: gc64-3.8.1-0-r93 и gc64-3.8.1-0-r94 ставятся в versions/tarantool-ee/tarantool-ee_3.8.1/, и установка другой ревизии не трогает уже установленную, пока не передан флаг --reinstall. Пре-релизы и отладочные сборки лежат отдельно: 3.8.1-rc1, debug-3.8.1.

Команды tt binary switch и tt binary uninstall принимают X.Y.Z для Enterprise, tt Enterprise и TCM, сопоставляя версии, установленные в области установки; значения X и X.Y не раскрываются. Точное совпадение с установленным именем имеет приоритет; в противном случае должно совпасть ровно одно установленное имя, а при неоднозначном запросе ничего не меняется.

Сборки разработки

--dev устанавливает сборки разработки Tarantool Enterprise, SDK или TCM. Они сохраняют полную версию архива с префиксом dev_ и лежат рядом с релизами:

$ tt binary install tarantool 3.8.1ee --dev
$ tt binary switch tarantool dev_gc64-3.8.1-0-r94

Команды list, switch и search --dev выводят dev_<full-version>; селекторы без dev_ находят только релизы.

Учётные данные Enterprise

Для поиска и скачивания Enterprise, TCM и SDK нужны учётные данные customer-zone. Флаг --credentials-file читает их из файла (логин на первой строке, пароль на второй), к которому закрыт доступ для группы и остальных пользователей:

$ chmod 0600 ./credentials
$ tt binary search tarantool-ee --credentials-file ./credentials
$ tt binary install tcm 1.3.1-0-g074b5ffa --credentials-file ./credentials

Без этого флага учётные данные берутся из TT_CLI_EE_USERNAME и TT_CLI_EE_PASSWORD либо запрашиваются интерактивно.

Enterprise SDK

tt binary install tarantool-sdk устанавливает Tarantool Enterprise, tt Enterprise, TCM и заголовочные файлы из одного архива SDK. Его компоненты устанавливаются под именами вида sdk-<bundle-version>, отдельно от автономных версий: versions/tarantool-ee/tarantool_sdk_<bundle-version>/, versions/tcm/tcm_sdk_<bundle-version>/, versions/tt-ee/tt_sdk_<bundle-version>/, а запись в versions/tarantool-sdk/ хранит соответствие компонентов друг другу.

$ tt binary search sdk
$ tt binary install tarantool-sdk 3.7
$ tt binary switch sdk 3.7.1                # все компоненты и заголовочные файлы
$ tt binary switch tcm sdk-3.7.1            # один компонент
$ tt binary switch tt-ee sdk-3.7.1          # tt Enterprise из SDK
$ tt binary switch tt 3.0.0                 # возврат к обычному tt

Удаление SDK удаляет его компоненты и сохраняет версии, выбранные отдельно от него. Переключение или удаление SDK требует однозначно определённой установленной версии.

Установка из локальных файлов

Команда Что принимает
tt binary install tt --local-repo DIR клон Git-репозитория tt в DIR/tt
tt binary install tarantool --local-repo DIR клон Git-репозитория Tarantool в DIR/tarantool
tt binary install tarantool 3ee --local-dir DIR архивы SDK tarantool-enterprise-sdk-*.tar.gz в DIR
tt binary install tt 2ee --local-dir DIR архивы tt Enterprise tt-ee-*.tar.gz в DIR
tt binary install tarantool-sdk --local-dir DIR архивы SDK, со всеми компонентами
tt binary install tcm --local-dir DIR архивы TCM tcm-*.tar.gz в DIR

tt binary search <product> принимает те же флаги. Флаг указывается после имени продукта; относительный путь DIR отсчитывается от текущего каталога.

$ tt binary search tarantool
$ tt binary search tarantool-ee --credentials-file ./credentials
$ tt binary search sdk

search отмечает установленные и активные версии в выбранной области установки; сама область установки не влияет на то, откуда берутся доступные версии. SDK отображается как активный, когда активны все его компоненты.

Заголовки для rock-модулей с частью на C

tt rocks и tt package build, install и pack собирают rock с частью на C и компонент c или lua-c с заголовочными файлами того Tarantool, под которым они работают, <prefix>/include/tarantool. Префиксом становится первое из следующего:

  1. .tarantool для Tarantool проекта, затем TT_CLI_TARANTOOL_PREFIX: берутся как есть, независимо от наличия заголовков.
  2. Каталог исполняемого файла, содержащий include/tarantool/module.h: сначала по его реальному пути (с разрешением символических ссылок), затем по пути, по которому он был найден. В каждом случае сначала проверяется каталог уровнем выше исполняемого файла (<prefix>/bin/tarantool), затем сам каталог исполняемого файла (Enterprise SDK или <root>/versions/tarantool/tarantool_<version>/ команды tt binary install). Исполняемый файл tarantool области установки пользователя или системы, найденный в PATH как <root>/bin/tarantool, получает заголовки своей версии, а если у неё их нет - активные заголовки области установки из его <root>/include/tarantool.
  3. CMAKE_INSTALL_PREFIX, о котором сообщает tarantool --version, затем /usr, если там есть include/tarantool/module.h. Этот префикс указывает, куда предполагалась установка сборки, где перемещённая или статическая сборка не находится.

Заголовки версии, отличной от версии tarantool, вызывают предупреждение с указанием обеих версий и каталога заголовков: модуль, собранный с ними, может не загрузиться.

Если заголовки не найдены, то, что не содержит части на C, собирается как обычно, а компонент c или lua-c завершается с ошибкой до начала сборки с перечислением проверенных каталогов:

   ⨯ building component "ipc": tarantool development headers not found: cannot compile c/lua-c component: none found for /opt/bin/tarantool, no module.h in /opt/include/tarantool, /opt/bin/include/tarantool, /tarantool/static-build/tarantool-prefix/include/tarantool, /usr/include/tarantool: set TT_CLI_TARANTOOL_PREFIX to the install prefix of Tarantool, the directory holding include/tarantool

Команда tt rocks, собирающая rock, добавляет то же самое к своей ошибке. Если Tarantool не найден вовсе, tt package build, fetch и pack собирают то, в чём нет части на C, а rock или компонент c или lua-c с такой частью завершается ошибкой из-за отсутствия заголовков.