Версия:

Справочники / Справочник по сторонним библиотекам / Интерфейс командной строки Cartridge
Справочники / Справочник по сторонним библиотекам / Интерфейс командной строки Cartridge

Интерфейс командной строки Cartridge

Интерфейс командной строки Cartridge

Установка

tarantoolctl rocks install cartridge-cli

При желании можно добавить .rocks/bin к путь к исполняемому файлу:

export PATH=$PWD/.rocks/bin/:$PATH

Использование

Чтобы получить более подробную информацию, выполните:

cartridge --help

Жизненный цикл приложений

Создайте приложение из шаблона:

cartridge create --name myapp

Упакуйте приложение:

cartridge pack rpm myapp

Управление экземплярами

cartridge start [ИМЯ_ПРИЛОЖЕНИЯ[.ИМЯ_ЭКЗЕМПЛЯРА]] [параметры]

Параметры
    --script FILE       Точка входа в приложение.
                        По умолчанию TARANTOOL_SCRIPT,
                        или ./init.lua, если запуск идет из директории приложения,
                        или :путь_к_приложениям/:имя_приложения/init.lua в среде с несколькими приложениями.

    --apps_path PATH    Путь к директории с приложениями при запуске из среды с несколькими приложениями.
                        По умолчанию /usr/share/tarantool

    --run_dir DIR       Директория с файлами pid и sock
                        По умолчанию TARANTOOL_RUN_DIR or /var/run/tarantool

    --cfg FILE          Конфигурационный файл для экземпляров Cartridge.
                        По умолчанию TARANTOOL_CFG или ./instances.yml

    --foreground        Не в фоне

Это запустит экземпляр Tarantool’а в фоновом режиме с принудительным использованием переменных окружения и будет ожидать выполнения основного скрипта приложения.

TARANTOOL_INSTANCE_NAME
TARANTOOL_CFG
TARANTOOL_PID_FILE - %run_dir%/%instance_name%.pid
TARANTOOL_CONSOLE_SOCK - %run_dir%/%instance_name%.pid

cartridge.cfg() использует ИМЯ_ЭКЗЕМПЛЯРА_TARANTOOL'А, чтобы считать настройки экземпляра из файла, который находится в TARANTOOL_CFG.

Параметры по умолчанию для cartridge можно изменить в файле ./.cartridge.yml или ~/.cartridge.yml:

run_dir: tmp/run
cfg: cartrifge.yml
apps_path: /usr/local/share/tarantool

Если ИМЯ_ПРИЛОЖЕНИЯ не указано, оно выделяется из имени файла ./*.rockspec. Если ИМЯ_ЭКЗЕМПЛЯРА не указывается, cartridge прочитает файл cfg и запустит все указанные экземпляры:

# в директории приложения
cartridge start # запускает все экземпляры
cartridge start .router_1 # запускает отдельный экземпляр

# в среде с несколькими приложениями
cartridge start app_1 # запускает все экземпляры app_1
cartridge start app_1.router_1 # запускает отдельный экземпляр

Чтобы остановить один или несколько работающих экземпляров, используйте:

cartridge stop [ИМЯ_ПРИЛОЖЕНИЯ[.ИМЯ_ЭКЗЕМПЛЯРА]] [параметры]

Поддерживаются следующие параметры из команды `start`
    --run_dir DIR
    --cfg FILE

Разное

Выполнение сквозного тестирования

vagrant up
vagrant ssh 1_10 < test/end-to-end.sh
vagrant halt