Переход с предыдущих версий¶
На этой странице описано, как перевести существующие проекты на новую версию
tt, и перечислены несовместимые изменения.
Содержание¶
2.x -> 3.0.0¶
Главные отличия tt 3.0 от tt 2.x:
- Нет окружения tt и файла
tt.yaml. Приложение стало проектом, а бинарные файлы и установленные приложения хранятся в областях установки (scope) – проекта, пользователя или системы. - Команды объединены в группы:
tt instance,tt binary,tt package,tt dataи другие. - Поддерживается только Tarantool 3. Cartridge и структура каталогов tarantoolctl больше не поддерживаются.
Краткий план перехода:
- Преобразуйте окружение tt в проекты – по одному на каждое приложение.
- Замените в скриптах команды
tt2.x на новые: работа с экземплярами, цели команд, бинарные файлы, сборка и упаковка. - Если приложения работают под systemd, создайте unit-файлы заново.
- Проверьте, как скрипты обрабатывают коды завершения и подтверждения.
Сначала описаны изменения, которые касаются большинства пользователей, в конце – те, что нужны в редких случаях.
Файл tt.yaml больше не читается¶
tt 3.0 не читает tt.yaml – ни файл окружения, ни системный
/etc/tarantool/tt.yaml. Вместе с ним удалены:
- флаги
-S(--system),-L(--local),-c(--cfg) и-s(--self) командыtt; - переменные окружения
TT_CLI_CFGиTT_SYSTEM_CONFIG_DIR; - флаг
-c(--config) командtt backup startиtt backup finalize. Он задавалtt.yaml, по которому находилась цель<APP>:<INSTANCE>. Теперь приложение находится по флагам--scopeи--template; - команды
tt cfgиtt env.
tt больше не передаёт управление tt из каталога bin_dir. Чтобы
использовать tt проекта, выполните source .env/activate.sh – скрипт добавит
его в PATH.
Если команда не находит проект, но находит tt.yaml, tt.yml или
instances.yml в текущем или родительском каталоге, она сообщает, что это
окружение tt 2.x, и ссылается на эту страницу.
Как преобразовать окружение в проекты¶
Вместо приложения в окружении теперь используется проект – каталог, в котором
есть app.manifest.toml (его создаёт tt new) или шаблоны экземпляров
.templates/<name>/instances.yaml. tt ищет проект, поднимаясь от текущего
каталога вверх.
Окружение tt с несколькими приложениями в instances.enabled превращается в
несколько проектов – по одному на каждое приложение. Пример окружения tt 2.x:
<environment>/
├── tt.yaml
├── instances.available/
│ ├── app1/
│ │ ├── init.lua
│ │ └── instances.yml
│ └── app2/
└── instances.enabled/
├── app1 -> ../instances.available/app1
└── app2 -> ../instances.available/app2
Остановите экземпляры приложения средствами tt 2.x. Затем для каждого
приложения:
- Перейдите в настоящий каталог приложения (не в символьную ссылку из
instances.enabled) и выполнитеtt new. Этот каталог станет каталогом проекта.
Теперь имя приложения берётся из [package].name манифеста, а не из имени
каталога или ссылки. tt new использует имя каталога, только если оно
допустимо для пакета: строчные латинские буквы, цифры и дефисы. Например,
для каталога my_app выполните tt new -n my-app – цели и каталоги данных
будут называться my-app.
-
Перенесите описание экземпляров и конфигурацию кластера:
-
instances.yml→.templates/default/instances.yaml; config.yaml→.templates/default/config.yaml.
Имена записей сохраняются. Запись без полей, созданная tt 2.x, читается без
изменений. Экземпляр Tarantool из записи должен входить в топологию
конфигурации кластера. Приложению, которое само вызывает box.cfg, топология
и config.yaml не нужны – см.
Приложения на box.cfg.
Политика перезапуска теперь задаётся полем restart записи (например,
restart: on-failure), а не параметром env.restart_on_failure.
- Перенесите данные всех экземпляров сразу: из
var/lib/<instance>в.tarantool/var/lib/<app>/<instance>. Журналы, pid-файлы и сокеты теперь хранятся в.tarantool/var/logи.tarantool/var/run.
Внимание. Пока
var/libсуществует, а.tarantool/var/libнет,tt instance startне запускает экземпляр проекта, данные которого должны быть в.tarantool/var/lib, – чтобы он не стартовал с пустой базой. Как только появится.tarantool/var/lib, эта проверка отключается: экземпляр, данные которого остались вvar/lib, запустится с пустой базой.
-
Установите бинарные файлы проекта командой
tt binary install. Это заменяет параметрыenv.bin_dirиenv.inc_dir: -
версии хранятся в
.tarantool/versions/<product>/<product>_<version>/; - активные версии связываются с
.tarantool/bin, заголовочные файлы – с.tarantool/include/tarantool.
Если бинарных файлов в проекте нет, используется первый tarantool из
PATH.
- Удалите
tt.yaml.
Получившийся проект:
/srv/apps/app1/
├── app.manifest.toml
├── init.lua
├── .templates/
│ └── default/
│ ├── config.yaml
│ └── instances.yaml
└── .tarantool/
├── bin/
└── var/
Чем заменить остальные параметры tt.yaml¶
tt.yaml |
tt 3.0 |
|---|---|
env.instances_enabled |
Нет. Вместо этого – отдельный проект для каждого приложения или приложения, установленные в область установки пользователя или системы |
env.bin_dir, env.inc_dir |
Каталоги bin/ и include/ области установки, в которые устанавливает tt binary --scope |
env.restart_on_failure |
Поле restart записи экземпляра |
env.tarantoolctl_layout |
Нет: структура каталогов tarantoolctl не поддерживается |
env.output_history_max |
Аргумент \history в консоли tt connect, например \history 15. Без аргумента – 10 |
app.run_dir, log_dir, wal_dir, memtx_dir, vinyl_dir |
<root>/var/{run,log,lib}/<app>/<instance>/ в корневом каталоге области установки. Конфигурация кластера может задавать другие пути |
modules.directory |
TT_CLI_MODULES_PATH, см. Внешние модули |
repo.rocks |
Rock-серверы tt registry, см. ниже |
repo.distfiles |
Флаги --local-repo DIR и --local-dir DIR команд tt binary install и tt binary search |
ee.credential_path |
Флаг --credentials-file команды tt binary |
templates |
Путь к собственному шаблону, который передаётся в tt create |
Об изменении repo.rocks:
- В
tt2.xrepo.rocksдобавлял rock-сервер, который LuaRocks опрашивал раньше стандартных. - В
tt3.0TT_REGISTRIESили[platform].registriesманифеста заменяют стандартные серверы – и дляtt package, и дляtt rocks. TT_CLI_REPO_ROCKSпо-прежнему добавляет сервер, которыйtt rocksопрашивает первым.
Подробнее – в разделе Rock-серверы.
Команды для экземпляров перенесены в tt instance¶
Команды для работы с экземплярами перенесены в группу tt instance. Прежние
команды верхнего уровня удалены:
tt 2.x |
tt 3.0 |
|---|---|
tt start, stop, restart, kill, status, logrotate, check, clean |
tt instance start, stop, ... |
tt log, tt log -f |
tt instance logs, tt instance logs --follow |
tt start -i |
tt instance start --foreground |
tt kill -f, tt clean -f |
tt instance kill --yes, tt instance clean --yes |
tt status -f json, tt status --pretty |
tt instance status -o json, tt instance status -o pretty-table |
tt connect |
tt connect или tt instance connect – это одна и та же команда |
Что ещё изменилось:
- Флаг
-fв этих командах больше не означает подтверждение, слежение или формат. - Подтверждение запрашивается только в терминале. Если скрипт передавал
yвtt stopили запускалtt --no-prompt stop, теперь передавайте флаг--yes. Без него команда завершится с кодом 1. tt instance start --foregroundзапускает каждый экземпляр под отдельным процессом-наблюдателем, как и в фоновом режиме. Вывод экземпляров дублируется вtt.log, а сами экземпляры не перезапускаются. Коды завершения:0– экземпляры остановились вовремя;137– экземпляр не остановился заstop_timeoutи был принудительно завершён;- в остальных случаях – код первого экземпляра, который сам завершился с другим кодом.
- Команда для нескольких экземпляров продолжает работу после ошибки одного из них и завершается с кодом 3, если часть экземпляров завершилась с ошибкой.
Цель команды – это экземпляр¶
Команды для экземпляров принимают цель в одном из видов:
<app>:<instance>– один экземпляр;<app>:*– все экземпляры приложения;- список таких целей через запятую;
- без цели – все экземпляры текущего проекта.
Просто <app>, которое в tt 2.x означало все экземпляры приложения, теперь
отклоняется, чтобы случайно не остановить их все:
tt 2.x |
tt 3.0 |
|---|---|
tt start app |
tt instance start app:* или tt instance start в проекте |
tt start app:storage-001 |
tt instance start app:storage-001 |
tt start – все приложения из instances.enabled |
Нет. Выполните tt instance start в каждом проекте или tt instance start app1:*,app2:* для приложений, установленных в область установки системы |
tt connect app |
tt connect app:<instance> |
<app> – это [package].name из манифеста проекта или имя каталога проекта,
если манифеста нет. Вне проекта с таким именем <app> означает приложение,
установленное в область установки системы. Чтобы задать область установки
явно, используйте флаг --scope project|user|system. Подробнее – в разделе
Цели.
Прекращённая поддержка¶
- Tarantool 1.10 и 2.x.
tt binaryне показывает и не устанавливает Tarantool, Tarantool Enterprise и Enterprise SDK версий ниже 3. - Tarantool Enterprise теперь устанавливается под именем своей версии,
например
3.8.1, а не под именамиgc64-иnogc64-, как в 2.x. - Ранее установленный Tarantool Enterprise 2.x показывается, переключается и удаляется под прежним именем.
- Структура каталогов tarantoolctl и приложения tarantoolctl.
- Cartridge:
tt cartridge,tt replicaset --cartridge, шаблонcartridgeкомандыtt createиtt pack --cartridge-compat.
Бинарными файлами управляет tt binary¶
Команды для установки бинарных файлов перенесены в группу tt binary:
tt 2.x |
tt 3.0 |
|---|---|
tt install tarantool 3.2.0 |
tt binary install tarantool 3.2.0 |
tt install tarantool-ee gc64-3.2.0-0-r40 |
tt binary install tarantool gc64-3.2.0-0-r40 или 3.2.0ee для последней сборки 3.2.0 |
tt install tarantool-dev ~/src/tarantool/build |
tt binary install tarantool --from-build ~/src/tarantool/build |
tt uninstall tarantool 3.2.0 |
tt binary uninstall tarantool 3.2.0 |
tt search tarantool |
tt binary search tarantool |
tt binaries list |
tt binary list |
tt binaries switch tarantool 3.2.0 |
tt binary switch tarantool 3.2.0 |
tt download <version> |
tt binary install tarantool-sdk <version> – устанавливает SDK, а не только скачивает его |
tt install --local-repo tarantool |
tt binary install tarantool --local-repo DIR – исходный код из Git в DIR/tarantool |
tt install --local-repo tarantool-ee |
tt binary install tarantool 3ee --local-dir DIR – архивы SDK в DIR |
- Раньше
--local-repoбыл переключателем и брал путь изrepo.distfilesвtt.yaml. Теперь он, как и--local-dir, принимает путь к каталогу относительно текущего каталога. - Каждая команда
tt binaryработает с одной областью установки:--scope project(по умолчанию),userилиsystem. На другую область установки команда не переключается.
Подробнее – в разделе Управление бинарными файлами.
tt pack, tt build и tt init заменены на tt package¶
Приложение собирается и упаковывается как пакет,
описанный в app.manifest.toml. Всем командам tt package нужен манифест – его
создаёт tt new.
tt 2.x |
tt 3.0 |
|---|---|
tt init |
tt new. Инструмента для преобразования приложений Cartridge или tarantoolctl нет |
tt build |
tt package build |
tt pack tgz, deb, rpm |
tt package pack – создаёт архив .tt, который устанавливается командой tt package install |
tt pack --with-integrity-check KEY |
tt package pack --with-integrity-check KEY в дистрибутиве с integrity = "rsa", см. Подписание пакетов |
tt pack --unit-params-file |
tt service systemd install, см. Unit-файлы systemd |
tt pack --use-docker, --cartridge-compat |
Нет |
В архив входят .rocks/, .templates/, среды выполнения и файлы из списка
[package].include.
Примечание.
init.luaиз корня проекта попадает в архив, только если он указан в[package].include. Если конфигурация кластера загружает его черезapp.file, добавьте файл в этот список или загружайте код компонента черезapp.module.
tt run запускает Tarantool проекта, в котором находится текущий каталог.
Раньше команда читала tt.yaml.
- Корень проекта – ближайший каталог выше, в котором есть
app.manifest.tomlили шаблоны экземпляров в.templates/<name>/. Пакет не требуется. - Tarantool запускается в текущем каталоге, и пути считаются от него.
Например,
tt run ../script.luaв подкаталоге запускает скрипт из родительского каталога. - Опции
tt run– только-hи--helpперед именем скрипта.--перед именем скрипта завершает эти опции и отбрасывается. - Все аргументы начиная с имени скрипта передаются скрипту без изменений:
tt run script.lua a -- -hпередаёт скриптуa -- -h. Справкаtt2.x описывала--иначе.
Приложения на box.cfg описываются записями script¶
В tt 2.x приложение, которое само вызывает box.cfg, запускалось из
init.lua, <instance>.init.lua или единственного файла <name>.lua в
instances.enabled. tt 3.0 эти варианты не распознаёт: скрипт запускается,
только если в записи instances.yaml задано поле script:
legacy-001:
script: init.lua # путь относительно каталога приложения
- Такие записи не входят в топологию конфигурации кластера. Приложению, которое
состоит только из них,
config.yamlне нужен. - Переменная
TARANTOOL_CFG, которая указывала наinstances.yml, больше не задаётся. Нужные скрипту переменные окружения задавайте в полеenvзаписи. - Каталоги данных и порт, которые скрипт не задал сам,
box.cfgберёт из переменныхTT_WAL_DIR,TT_MEMTX_DIR,TT_VINYL_DIRиTT_LISTEN.
Подробнее – в разделе Запуск приложения на box.cfg.
Системное окружение заменено областью установки системы¶
В tt 2.x команда tt -S работала с окружением из /etc/tarantool/tt.yaml:
приложения хранились в /etc/tarantool/instances.enabled, а данные, журналы и
pid-файлы – в каталогах sys_env внутри /var/lib/tarantool,
/var/log/tarantool и /var/run/tarantool.
В tt 3.0 вместо этого есть область установки системы – каталог
/opt/tarantool (или каталог из TT_SYSTEM_ROOT). В нём хранятся приложения,
установленные из пакетов:
# tt package install --scope system myapp-1.0.0-linux-amd64.tt
# tt instance start myapp:*
Где что хранится:
/opt/tarantool/apps/<app>– ссылка на активную версию приложения;/opt/tarantool/var/{lib,log,run}/<app>/<instance>/– файлы экземпляров;/opt/tarantool/etc/<app>/– конфигурация этого хоста:config.yamlиinstances.yaml.
До первого запуска перенесите данные каждого экземпляра из
/var/lib/tarantool/sys_env/<app>/<instance> в
/opt/tarantool/var/lib/<app>/<instance>. Вне проекта tt не ищет данные в
прежнем каталоге.
Пакеты deb и rpm tt 3.0 не устанавливают /etc/tarantool/tt.yaml, каталоги
sys_env и /etc/logrotate.d/tt.conf. При обновлении deb-пакета старые файлы
остаются до полного удаления пакета (purge).
Внимание. Старое правило logrotate вызывает
tt -S logrotate, а эта команда теперь завершается с ошибкой. Удалите это правило. В собственном правиле переоткрывайте журналы командойtt instance logrotate <app>:*– пример приведён в разделе Журналы.
Unit-файлы systemd создаёт tt service systemd¶
Unit-файлы, которые tt pack в tt 2.x добавлял в пакеты, запускали
tt -L <environment> start как сервисы типа forking. С tt 3.0 они не
работают.
Для приложения, установленного в область установки системы, команда
tt service systemd install <app> создаёт:
- шаблонный unit-файл
<app>@.service, который запускает один экземпляр черезtt instance start --foreground; - drop-in для каждого экземпляра с полями
restartиstop_timeoutиз его записи.
После этого экземплярами управляет systemctl, а tt instance start, stop,
restart и kill отказываются ими управлять.
В tt 2.x приложение с несколькими экземплярами тоже использовало unit-файл
<app>@.service, но в /usr/lib/systemd/system. В tt 3.0 unit-файл создаётся
в /etc/systemd/system и перекрывает старый. Поэтому переходите в таком
порядке:
- Остановите и отключите старые unit-файлы.
- Удалите пакет, который их установил.
- Соберите приложение и установите его в область установки системы.
- Установите unit-файлы командой
tt service systemd install <app>.
Команда работает только с областью установки системы – не с проектом и не с областью установки пользователя.
Параметры из --unit-params-file заменяются так:
systemd-unit-params.yml |
tt 3.0 |
|---|---|
FdLimit |
В unit-файле задано LimitNOFILE=65535. Другое значение задайте в собственном drop-in <app>@.service.d/override.conf |
instance-env |
Поле env записи экземпляра или записи "*" |
TT, ConfigPath, ExecArgs |
Нет: unit-файл запускает tt из области установки приложения |
Подробнее – в разделе Запуск экземпляров под systemd.
tt cluster publish запрашивает подтверждение¶
tt cluster publishзапрашивает подтверждение перед записью конфигурации, но только в терминале. В скрипте публикации передавайте--yes(-y), иначе команда завершится с кодом 1 и ничего не запишет.--forceотключает проверку конфигурации, но не подтверждение.tt cluster show --validateиtt cluster publishпроверяют конфигурацию по JSON Schema конфигурации кластера Tarantool. Проверка строже, чем вtt2.x: неизвестные ключи верхнего уровня и областей применения конфигурации отклоняются. Ошибки выводятся в формате<path> [code] <message>.
Удалённые команды¶
tt 2.x |
tt 3.0 |
|---|---|
tt env, . <(tt env) |
source .env/activate.sh. Файл создаёт первая команда tt binary install в проекте |
tt cfg dump |
Нет. Rock-серверы показывает tt registry list |
tt enable |
Нет: проект определяется по текущему каталогу, а приложение устанавливается командой tt package install |
tt instances |
tt instance status – для экземпляров, tt package list --scope system – для установленных приложений |
tt cartridge |
Нет |
Команда tt create¶
- Для
tt createфайлtt.yamlне нужен. - Команда создаёт приложение в текущем каталоге или в каталоге из
--dstи не создаёт ссылку вinstances.enabled. - Собственный шаблон задаётся путём к каталогу или архиву
.tgz, напримерtt create ./templates/basic. - Переменная шаблона
rundirудалена. - Встроенные шаблоны размещают
instances.yamlиconfig.yamlв.templates/default/. Шаблонsingle_instanceиспользует расширение.yaml, а не.yml. Шаблонcartridgeудалён. - Шаблон, который создаёт
app.manifest.toml, отклоняет имена, недопустимые для пакета. Например,vshard_clusterпреобразует--name my_appвmy-app, аMy_Appотклоняет.
Коды завершения¶
В tt 2.x любая ошибка, кроме ошибок tt backup и tt restore, завершала
команду с кодом 1. В tt 3.0 коды такие:
| Код | Значение |
|---|---|
1 |
Запрос нельзя выполнить в заданном виде: ошибка в использовании, нет файла или проекта, нужно подтверждение, а терминала нет |
2 |
Сбой системы, в которой выполнялась команда: сервер недоступен или не ответил вовремя, имя хоста не разрешается, файловой системе не хватает прав или места. Например, tt connect к порту, который никто не слушает, теперь завершается с кодом 2, а не 1 |
3 |
Команда для нескольких целей выполнилась успешно только для части из них |
Если скрипт проверял код 1, теперь проверяйте любой код, отличный от 0.
tt backup и tt restore сохраняют собственные коды, начиная с 3. Все коды
описаны в tt help errors.
tt backup-id заменена на tt backup id¶
Команда, которая выводит идентификатор новой резервной копии, перенесена в
группу tt backup. В скрипте резервного копирования замените
id=$(tt backup-id) на id=$(tt backup id). Формат идентификатора не
изменился.
Внешние модули ищутся в TT_CLI_MODULES_PATH¶
- Внешние модули ищутся только в каталогах из переменной
TT_CLI_MODULES_PATH(через двоеточие). Относительный путь отсчитывается от рабочего каталога. - Каталог
modules.directoryизtt.yamlи стандартный каталогmodulesрядом с ним больше не проверяются. Модуль оттуда не будет найден, и команда, которую он заменял, снова будет выполняться как встроенная командаtt. - Модуль с именем группы команд, например
cluster, перехватывает всю группу:tt cluster publish ...запускает модуль с аргументамиpublish .... - Команды
tt modules,tt help,tt completionиtt versionзаменить нельзя. - Флаг
-Iзапускает встроенную командуtt, даже если есть модуль с таким именем.
Подробнее – в разделе Внешние модули.
tt daemon запускает команды tt 3.0¶
Запрос к tt daemon теперь содержит команду tt 3.0. Например, запрос для
tt start test_app:
- в
tt2.x:{"command_name":"start", "params":["test_app"]}; - в
tt3.0:{"command_name":"instance", "params":["start", "test_app:*"]}.
Глобальные флаги tt 2.x, например -L, удалены. Для команд, которые
запрашивают подтверждение, передавайте --yes: daemon запускает команды без
терминала. Подробнее – в разделе
Работа с tt daemon.
Сборка tt и импорт его пакетов¶
Переменная TT_CLI_BUILD_SSL принимает значения default, openssl и
openssl_static. Значения no, shared и static отклоняются:
tt 2.x |
tt 3.0 |
|---|---|
Не задана или no – без TLS |
Не задана или default – TLS на чистом Go, без cgo |
shared |
openssl |
static |
openssl_static |
Для Go-кода, который импортирует tt:
- путь модуля –
github.com/tarantool/tt/v3; lib/cluster,lib/connect,lib/dialиlib/integrityперенесены вgithub.com/tarantool/tt/sdk/cluster,sdk/connect,sdk/dialиsdk/integrity. Каждый из них стал отдельным модулем с API в статусе alpha;InjectedCmdsизcli/cmdудалён. Дистрибутив добавляет свои команды как модули tt и выбирает поставщика integrity черезcore.WithIntegrity. Подробнее – в разделе Дистрибутивы и модули.
tt cat и tt play заменены на tt data cat и tt data play¶
tt cat и tt play удалены без псевдонимов – используйте tt data cat и
tt data play. Новые команды читают файлы средствами Go, поэтому локальный
Tarantool не нужен. Имена флагов сохранились, но поведение изменилось:
tt 2.x |
tt 3.0 |
|---|---|
--format yaml\|json\|lua |
-o/--format. json – формат JSON Lines, по одному объекту на строку |
--to N не включает N |
--to N включает N, как и --from N |
--from/--to сравнивают один LSN со всеми репликами |
Ограничивают LSN одной реплики: она задаётся флагом --replica или берётся единственная реплика из файлов. Для нескольких реплик используйте --from-vclock/--to-vclock |
| Граница может разрезать транзакцию | Транзакция внутри границы берётся целиком |
Все .snap и .xlog каталога, сначала снимки |
Самый свежий снимок в заданных границах, затем журналы по vclock, без данных, которые уже есть в снимке |
--show-system фильтрует только изменения данных |
Также скрывает строки RAFT, синхронной репликации и NOP |
play: один запрос на строку, без транзакций |
Один поток IPROTO, запросы --batch выполняются одновременно, доступны --txn-mode, --on-error, --dry-run |
Дополнительно:
- Если задан
--fromили--from-vclock, снимок не читается. Номера строк снимка не являются LSN, поэтому границы применяются только к журналам упреждающей записи (WAL). - Вывод
catсохраняетHEADERиBODYкаждой строки. Тела строк RAFT и синхронной репликации теперь декодируются. - Снимок не содержит данных спейсов vinyl: они хранятся в файлах
.run.tt data catчитает эти файлы, если они указаны явно или найдены с флагом-r.tt data playс ними не работает. tt data playзавершается с кодом 3, если цель отклонила часть транзакций, и с кодом 2 при сбое соединения.- Команда
tt coredumpне перенесена в группу.
1.3.1 -> 2.0.0¶
Новый формат конфигурационного файла tt¶
Формат конфигурационного файла tt 2.0.0 несовместим с предыдущими версиями:
- Корневая секция
ttудалена. - Общие настройки окружения перемещены в секцию
env. Все относительные пути в этой секции разрешаются от каталога конфигурационного файла. - Относительные пути в секции
appразрешаются от каталога приложения.
Новая раскладка runtime-артефактов¶
Раскладка runtime-артефактов изменилась:
- Относительные пути разрешаются от каталога приложения. Для инстанса,
определенного одним скриптом, создается каталог в
instances.enabled. - Поскольку относительные пути уже содержат имя приложения, добавляется только имя инстанса. Раскладка локального окружения по умолчанию в 2.0.0 такова:
instances.enabled/app/
├── init.lua
├── instances.yml
└── var
├── lib
│ ├── inst1
│ └── inst2
├── log
│ ├── inst1
│ └── inst2
└── run
├── inst1
└── inst2
Для переноса артефактов из версии 1.*:
- Создайте каталоги артефактов в каталоге приложения: var/lib, var/log и var/run.
- Скопируйте подкаталоги инстансов из окружения 1.* в каталог приложения.
Например, для копирования данных:
cp -r <env_dir>/var/lib/app/* <instances_enabled>/app/var/lib/
Эти изменения не затрагивают абсолютные пути: имя приложения к ним добавляется всегда.
Изменилась рабочая директория¶
Процесс инстанса теперь использует каталог приложения в качестве своей рабочей директории, а не текущий каталог tt. Переместите или скопируйте файлы, к которым инстанс обращается по относительным путям, в каталог приложения.