За все свое время знакомства с Erlang мне не нравилось что в нем почти нет CoC, особенно это касалось релизов. Есть мануалы для rebar, можно сделать ручками, но нельзя просто взять и rebar deploy. Эту проблему хочется решить, хотя бы для простых проектов.
Чтобы не разгребать кучу bash скриптов и не читать мануалы по ребару, можно воспользоваться утилитой Relx — она позволяет быстро собрать релиз, обновление и упаковать все это в архив .tar.gz; все это с минимальными настройками и почти без мануалов. Сама утилита очень простая, но мне ее для своих проектов хватает за глаза.
Приложенька
Для тестов нам надо создать простейшее приложение, пусть это будет key-value база данных.
В relx.config мы указываем версию релиза с его названием и зависимостями, в нашем случае это dummy первой версии и sasl для горячего обновления кода.
Чтобы подробнее узнать про конфигурацию relx можно посмотреть этот пример, там все доступные опции приведены с комментариями.
Соберем первую версию:
# скомпилируем код приложения
$ ./rebar compile
# создадим первый релиз
$ ./relx release
# стартуем ноду
$ _rel/dummy/bin/dummy start
# подключаемся
$ _rel/dummy/bin/dummy remote_console
И немного поиграемся:
(dummy@127.0.0.1)1> dummy_db:version().
1
(dummy@127.0.0.1)2> dummy_db:get(a).
not_found
(dummy@127.0.0.1)3> dummy_db:set(foo, bar).
{ok,foo,bar}
(dummy@127.0.0.1)4> dummy_db:get(foo).
{ok,bar}
Как видим - все работает. Консоль можно не закрывать, она понадобится дальше. Поменяем ответ функции dummy_db:get(key) когда ключа не существует с not_found на {not_found, key} и обновим все это с hot code reloading, изменив версию базы данных.
Обновляем
Код обновленного приложения лежит в теге v2. Мы обновили код kvdb, добавили .appup и пару строк о второй версии для relx: v1…v2. Для горячего обновления кода сделаем следующее:
# снова компилируем
$ ./rebar compile
# собираем релиз, relup файл упаковываем в .tar.gz,
# чтобы можно было загружать на сервер
$ ./relx release relup tar
# здесь по идее нам надо было загрузить наш архив на сервер в папку с релизами
# _rel/<app_name>/releases/<new_version>/<app_name>.tar.gz
# но мы все делаем на локальной ноде, поэтому просто копируем
$ cp _rel/dummy/dummy-0.0.2.tar.gz _rel/dummy/releases/0.0.2/dummy.tar.gz
# обновляем приложение
$ _rel/dummy/bin/dummy upgrade "0.0.2/dummy"
Если все обновилось, то можно вернуться в нашу коноль и проверить обновление:
% проверим версию
(dummy@127.0.0.1)5> dummy_db:version().
2
% старые данные
(dummy@127.0.0.1)6> dummy_db:get(foo).
{ok,bar}
% и код ответа
(dummy@127.0.0.1)7> dummy_db:get(a).
{not_found,a}
Задача решена :)