Управление бинарными файлами¶
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. Префиксом
становится первое из следующего:
.tarantoolдля Tarantool проекта, затемTT_CLI_TARANTOOL_PREFIX: берутся как есть, независимо от наличия заголовков.- Каталог исполняемого файла, содержащий
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. 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 с такой частью
завершается ошибкой из-за отсутствия заголовков.