Установка¶
Скрипт установки¶
install.sh устанавливает tt 3 из релиза на GitHub на Linux (x86_64 и
arm64) и на macOS с процессорами Apple:
$ curl -fsSL https://raw.githubusercontent.com/tarantool/tt/v3/install.sh | sh
Скрипт берёт самый новый стабильный релиз tt 3, а пока такого нет — самый
новый пре-релиз, сверяет архив с checksums.txt этого релиза и кладёт tt
в ~/.local/bin, а при запуске от root — в /usr/local/bin. Если этого
каталога нет в PATH, скрипт подскажет, как его добавить.
wget -qO- <url> | sh тоже работает.
Параметры передаются после sh -s --:
$ curl -fsSL https://raw.githubusercontent.com/tarantool/tt/v3/install.sh | sh -s -- --version 3.0.0-alpha.1 --dir /usr/local/bin
-v,--version <version>— релиз для установки, например3.0.0-alpha.1. Его задаёт иTT_VERSION.-c,--commit <commit>— собрать tt из коммита репозитория вместо установки релиза, см. ниже. Его задаёт иTT_COMMIT. Несовместим с--version.-d,--dir <dir>— каталог, куда положитьtt. Его задаёт иTT_INSTALL_DIR.--openssl— установить сборкуtt-openssl, в которой TLS реализован через OpenSSL системы, а не средствами Go. В релизах она есть только для Linux.-h,--help— вывести список параметров.
Если задан GITHUB_TOKEN, скрипт передаёт его GitHub API, через который
получает список релизов: без авторизации можно упереться в ограничение
частоты запросов. С --version список не запрашивается.
Сборка из коммита¶
--commit собирает tt 3 из коммита с помощью go build, поэтому нужны
git и Go. Коммит задаётся хешем, полным или
сокращённым, веткой или тегом; коммит pull request, которого нет ни в одной
ветке, — полным хешем:
$ curl -fsSL https://raw.githubusercontent.com/tarantool/tt/v3/install.sh | sh -s -- --commit 1508ce93
Бинарный файл собирается так же, как его собирает mage build, и сообщает
версию, которую git describe выдаёт для этого коммита:
$ tt version
Tarantool CLI version 3.0.0-alpha.1, linux/amd64. commit: 1508ce9 (v3.0.0-alpha.1-20-g1508ce9)
Собрать можно везде, где работает Go, включая macOS на Intel, для которой
релизной сборки нет. С --openssl нужны компилятор C и заголовки OpenSSL.
Коммит tt 2 скрипт не принимает: tt 2 собирается с подмодулями и кодом,
который генерирует mage, как описано в
README tt 2.
Сборка из исходного кода¶
Понадобятся Go 1.27.4 или новее, Mage и Git.
$ git clone --branch v3 https://github.com/tarantool/tt
$ cd tt
$ mage build
$ ./tt version
Положите бинарный файл tt в каталог из PATH.
Замечание о предварительной версии.
mage buildпрописывает в tt версию, которую выдаётgit describe, а ближайший тег в веткеv3относится к 2.x, поэтому собранный файл сообщает версию 2.x.tt newзаписывает в манифестtt = ">=3.0.0", иtt package packпосле этого отказывается класть такой tt в архив. Чтобы упаковывать приложение бинарным файлом, собранным из исходного кода, задайте ему версию 3.x:$ go build -ldflags "-X github.com/tarantool/tt/v3/cli/version.gitTag=3.0.0" -o tt ./cli
Реализации TLS¶
По умолчанию tt использует TLS на чистом Go и не требует OpenSSL. Другую
реализацию выбирает переменная TT_CLI_BUILD_SSL:
$ TT_CLI_BUILD_SSL=openssl mage build # OpenSSL, linked dynamically
$ TT_CLI_BUILD_SSL=openssl_static mage build # OpenSSL, linked statically
Для статической сборки нужны статические библиотеки OpenSSL.
Автодополнение в командной оболочке¶
$ . <(tt completion bash)
Поддерживаются также zsh и fish. Автодополнение предлагает команды,
внешние модули и цели команд tt instance: приложения до : и их экземпляры
после.
Tarantool¶
Устанавливать Tarantool заранее не нужно: tt binary install tarantool
ставит его в проект, для пользователя или для всей системы (см.
Manage binaries). Поддерживается Tarantool
Community Edition 3.0 и новее.
Зависимости времени выполнения¶
- Git и Mage — для
tt binary install tt, когда tt собирается из исходного кода, и Git — дляtt binary search tt. - Git, CMake,
makeи компиляторы C и C++ — дляtt binary install tarantool, когда Tarantool собирается из исходного кода: на платформе без готового бинарного файла, для коммита или pull request, а также с--source-build. - Компилятор C — для rock-модулей и компонентов с частью на C.
curlилиwget,zipиunzip— дляtt rocks, который запускает LuaRocks.