diff --git a/debian/control b/debian/control index 9af93c8..2cba53d 100644 --- a/debian/control +++ b/debian/control @@ -1,10 +1,10 @@ Source: surok Section: admin Priority: optional -Maintainer: Denis Zheleztsov +Maintainer: Denis Zheleztsov Build-Depends: debhelper (>= 9) Standards-Version: 3.9.5 -Vcs-Git: http://vcs.bingo-boom.ru/difrex/surok.git +Vcs-Git: https://github.com/Difrex/surok Package: surok Architecture: all diff --git a/doc/ru/app.configuration.md b/doc/ru/app.configuration.md index f002724..11c89d6 100644 --- a/doc/ru/app.configuration.md +++ b/doc/ru/app.configuration.md @@ -13,17 +13,17 @@ "conf_name": "kiosk", "template": "/etc/surok/templates/kiosk.jj2", "dest": "/etc/nginx/sites-available/kioskservice.conf", - "reload_cmd": "/bin/systemctl reload nginx", + "reload_cmd": "/sbin/nginx -t && /bin/systemctl reload nginx", "run_cmd": ["/usr/bin/node", "-c", "config.json"] } ``` Давайте разберем конфигурационный файл по опциям * services - array. Список хэшей с описанием сервисов - name - string. Имя сервиса. Это имя приложения в marathon - group - string. Группа в которой находится сервис. Группу можно узнать в marathon. Записывается в обратном порядке. Т.е. если у нас есть группа /webapps/php, то записывать её следует, как php.webapps + 1. name - string. Имя сервиса. Это имя приложения в marathon + 2. group - string. Группа в которой находится сервис. Группу можно узнать в marathon. Записывается в обратном порядке. Т.е. если у нас есть группа /webapps/php, то записывать её следует, как php.webapps. Если группа не указана, то сурок ожидает группу в переменной окружения SUROK_DISCOVERY_GROUP, если и SUROK_DISCOVERY_GROUP нет, то берется группа marathon(0.5.5). - ports - array. Список имен портов сервиса. Не обязательная опция. + 3. ports - array. Список имен портов сервиса. Не обязательная опция. * conf_name - string. Название конфига. Должен быть уникальным значением. Слежит для создания и чтения lock конфигурации. * template - string. Абсолютный путь к файлу шаблона. * dest - string. Абсолютный путь к файлу в который запишется результат генерации шаблона. diff --git a/doc/ru/surok.configuration.md b/doc/ru/surok.configuration.md index 9b9a19f..213ae15 100644 --- a/doc/ru/surok.configuration.md +++ b/doc/ru/surok.configuration.md @@ -1,10 +1,14 @@ -# Конфигурация Surok +# Конфигурация Surok (0.7.x) **/etc/surok/conf/surok.json** Разберем конфигурационный файл по опциям ``` { - "marathon": "10.0.1.199:8080", + "marathon": { + "force": true, + "host": "marathon.mesos:8080", + "enabled": true + }, "confd": "/etc/surok/conf.d", "domain": "marathon.mesos", "wait_time": 20, @@ -14,7 +18,10 @@ } ``` -* marathon(v0.7) - string. Адрес Marathon Sheduler. +* marathon(v0.7) - hash. В текущей версии отвечает за перезапуск контейнера. Обнаружение сервисов через Marathon пока недоступно. + 1. force - boolean. Рестарт контейнера с force или нет. + 2. host - string. Адрес Marathon. + 3. enabled - boolean. Вкл/выкл. * confd - strig. Абсолютный путь до директории с конфигурационными файлами приложений. * domain - string. Домен, который обслуживает mesos-dns. * wait_time - int. Время в секундах сколько Surok ждет до того, как начать заново делать запросы на обнаружение сервисов. diff --git a/doc/ru/templates.md b/doc/ru/templates.md index 5ac75c3..4b98f32 100644 --- a/doc/ru/templates.md +++ b/doc/ru/templates.md @@ -1,4 +1,4 @@ -# Шиблоны +# Шаблоны Шаблоны для Surok пишутся на Jinja2. Возможно, стоит прочитать документацию.