Запуск внешнего процесса¶
Приложение может запускать программы помимо Tarantool - шлюз, воркер,
экспортёр - рядом со своими экземплярами Tarantool. Запись с полем binary
в instances.yaml задаёт такой внешний процесс: команды управления
экземплярами запускают, останавливают и показывают его рядом с экземплярами
Tarantool, под тем же процессом-наблюдателем.
Описание процесса¶
storage-001:
gateway:
binary: gateway # a program of .rocks/bin, or on PATH, or a path
args: [--port, "8080"]
env: {GATEWAY_MODE: production}
workdir: ./gateway # <root>/var/lib/<app>/<instance>/ by default
stop_signal: SIGINT # SIGTERM by default
stop_timeout: 10s # 30s by default
logrotate_signal: SIGHUP # none by default
restart: on-failure # no by default
binaryсо слешем задаёт путь относительно каталога приложения. Без слеша поле задаёт имя программы, поиск которой выполняется сначала в.rocks/bin/приложения, куда tt собирает программы пакета, а затем вPATH:binary: python3запускаетpython3с хоста.workdirотсчитывается относительно каталога приложения. Без него процесс работает в своём каталоге данных,<root>/var/lib/<app>/<instance>/, который создаётtt instance start.envнакладывается поверх окружения tt.args,workdirиlogrotate_signalотносятся только к внешним процессам.
tt instance start сообщает о binary, который не удаётся запустить, или о
несуществующем каталоге workdir ещё до запуска чего-либо. Описание всех
полей приведено в справочнике.
Сборка программы вместе с пакетом¶
Компонент, чья сборка создаёт программу, помещает её в .rocks/bin/, так что
пакет несёт её с собой, а запись указывает её по имени:
[components.gateway]
path = "gateway" # a Go module
[components.gateway.build]
backend = "go"
$ tt package build
$ ls .rocks/bin
gateway
$ tt instance start
$ tt instance logs myapp:gateway
myapp:gateway: gateway started, port [--port 8080]
Backend'ы, собирающие программы:
go:go build -trimpathпакетаpackage(.по умолчанию) в программу с именемname(по умолчанию имя компонента);tags,ldflagsиcgo(по умолчанию выключен). Исходный код Go не попадает в состав пакета: включается только то, что указано вincludeкомпонента.cargo:cargo buildбинарного файлаbinв профилеrelease, если вprofileне указано иное, в_build/cargo/;package,features. Блок, в котором также указанmodule, собирает и модуль библиотеки; см. Build a module in Rust.zig:zig buildфайлаbuild.zigизcwd, программаbinберётся из того, что сборка установила в свой префикс,bin/;steps,optimize,options. Блок, в котором также указанmodule, забирает и модуль; см. Build a module in Zig.cmake: проект CMake изcwd, собранный вне дерева исходного кода в_build/component/<component>/, его программы перечислены вoutputсto = "bin"относительно дерева сборки;variables,targets,build_type.makeиshell: собственная сборка, чьи программы перечислены вoutputсto = "bin"относительноcwd, а промежуточные файлы сборки попадают вTT_BUILD_DIR.
[components.tools.build]
backend = "make"
make_target = "tools"
output = [{ path = "build/gw-cli", to = "bin" }]
Один компонент может собирать модули и программы одновременно: строковый
элемент output - это модуль, а файл с to = "share" - файл данных.
Устаревшее поле kind = "executable" из manifest_version = "0.1" по-прежнему
работает, с предупреждением: его сборка создаёт только программы, а сборка
make или shell для такого компонента записывает их в TT_OUTPUT_DIR.
static = true запрашивает у go и cargo программу, которой не требуются
загрузчик и разделяемые библиотеки, а сборка проверяет, что получен именно
такой файл; программы cmake, make и shell только проверяются. Тулчейн
должен быть доступен в PATH. См.
справочник по манифесту.
Как устроен запуск¶
- Процесс возглавляет собственную группу процессов, которой целиком
доставляются его сигнал остановки и
tt instance kill, поэтому скрипт-обёртка останавливается вместе с запущенной им программой. - Вывод процесса направляется в
tt.log. Watchdog сохраняетtt.pidи pid самого процесса,process.pid, в каталоге запуска. tt instance statusпоказывает только то, работает ли процесс, и ничего сверх этого.tt instance logrotateзаново открываетtt.logи отправляет процессу сигналlogrotate_signal, если он задан в записи. На Linux и macOS процесс, который не перехватывает, не игнорирует и не блокирует этот сигнал, не получает его, поскольку он привёл бы к его завершению; об этом пишется вtt.log.tt instance cleanудаляет журнал процесса и каталог его данных.tt connect,tt data play,tt instance kill --dumpи команды кластера отклоняют внешний процесс: это не экземпляр Tarantool.- Экземпляры запускаются в порядке, указанном в
instances.yaml, и ни один не ждёт готовности другого.
Процесс, чей процесс-наблюдатель был завершён чем-то кроме tt instance kill,
продолжает работать без него. tt instance status не показывает его
работающим и называет его в alert'е, tt instance start отказывается
запускать второй экземпляр, а tt instance stop и tt instance kill
останавливают процесс по process.pid.