Перезагрузка модуля
Любое приложение или модуль Tarantool’а можно перезагрузить с нулевым временем простоя.
Ниже представлен пример, который иллюстрирует наиболее типичный случай – «обновление и перезагрузка».
Примечание
В этом примере используются рекомендованные методики администрирования на основании файлов экземпляров и утилиты tarantoolctl.
Обновите файлы приложения.
Например, модуль в
/usr/share/tarantool/app.lua
:local function start() -- начальная версия box.once("myapp:v1.0", function() box.schema.space.create("somedata") box.space.somedata:create_index("primary") ... end) -- код миграции с 1.0 на 1.1 box.once("myapp:v1.1", function() box.space.somedata.index.primary:alter(...) ... end) -- код миграции с 1.1 на 1.2 box.once("myapp:v1.2", function() box.space.somedata.index.primary:alter(...) box.space.somedata:insert(...) ... end) end -- запустить файберы в фоновом режиме, если необходимо local function stop() -- остановить все файберы, работающие в фоновом режиме, и очистить ресурсы end local function api_for_call(xxx) -- сделать что-то end return { start = start, stop = stop, api_for_call = api_for_call }
Обновить файл экземпляра.
Например,
/etc/tarantool/instances.enabled/my_app.lua
:#!/usr/bin/env tarantool -- -- пример горячей перезагрузки кода -- box.cfg({listen = 3302}) -- ВНИМАНИЕ: правильно выполните разгрузку! local app = package.loaded['app'] if app ~= nil then -- остановите старую версию приложения app.stop() -- разгрузите приложение package.loaded['app'] = nil -- разгрузите все зависимости package.loaded['somedep'] = nil end -- загрузите приложение log.info('require app') app = require('app') -- запустите приложение app.start({some app options controlled by sysadmins})
Самое главное – правильно разгрузить приложение и его зависимости.
Вручную перезагрузите файл приложения.
Например, используя
tarantoolctl
:$ tarantoolctl eval my_app /etc/tarantool/instances.enabled/my_app.lua
После компиляции новой версии модуля на C (библиотека общего пользования *.so
), вызовите функцию box.schema.func.reload(„module-name“) из Lua-скрипта для перезагрузки модуля.