Различия

Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.

--- ru:base:services 2006/11/14 14:30
+++ ru:base:services 2006/11/20 12:00 текущий
@@ Строка 1: / Строка 1: @@
-^Название переменной ^Описание  |
+===== Сервисы =====
-| access_login | FTP логин, используемый для заливки конфигов на сервер. Обычно это логин dedikit с homedir /opt/dedikit/upload |
+== Сервисы ==
-| access_passwd | Пароль для access_login |
+{{ru:small_icons:services2_list.png|}} //Сервисы// это службы, управляющие обновлением конфигурации сервера. К каждому сервису принадлежит определенный набор файлов конфигурации (//filegens//), которые будут обновлены на выделенном сервере при изменении соответствующих пунктов в панели. Сервисы могут быть трех состояний:\\
-| access_method | Метод заливки конфигов. На данный момент поддерживается только ftp |
+//Synced// - данные в панели соответствуют конфигурации сервера;\\
-| clients_home | Обязательная переменная, определяющая, где будут создаваться папки ftp/shell пользователей. НЕ МЕНЯЙТЕ ее на работающей машине, иначе Вы нарушите работу ВСЕХ своих сайтов (Apache DocumentRoot будет смотреть в другое место). |
+//Pending rebuild// - были произведены изменения в панели и ожидается обновление конфигураци;\\
-| contact_email | Переменная, определяющая емейл владельца сервера. Необходимо указывать работающий емейл, так как на него идет служебная информация о сервере |
+//Rebuild blocked// - при обновлении произошла ошибка, автоматическое обновление блокировано. Ошибка будет показываться в графе //Error// \\
-| language | Переменная, определяющая язык подсказок панели. Представляет из себя двухбуквенное сочетание страны маленькими буквами. На данный момент поддерживается ru, en. |
+Обновление конфигурации сервера происходит не моментально! Сразу после изменений в панели сервис должен находится в состоянии //Pending rebuild//. В течение минуты-двух он перейдет в состояние //Synced//, это означает, что необходимые изменений произведены на сервере.\\
-| system_hostname | Системное имя сервера. Никакой полезной нагрузки не несет и возможно скоро будет вообще удалено |
+Также в меню //actions// можно видеть раздел //filegens//. //Filegens// это темплейты всех файлов, которые заливаются на сервер.\\
-| system_ipaddr | Основной IP адрес сервера. По этому адресу идет ftp-соединение для заливания конфигурации и обращение к системному http-серверу для запуска обновления конфигурации |
+== Filegens ==
-| login_cookie_expires | Через какое время будет удалена кука авторизации. Формат совпадает с форматом поля Expires в http cookies. Значение по умолчанию +2d |
+//Filegens// (генераторы) представляют из себя простой способ генерации любых конфигов прямо из базы, без написания лишнего кода. \\
+Рассмотрим самый простой пример, генерация конфига //vhosts.conf// для веб-сервера apache.\\
+Идем в //base/services//, добавляем к сервису webserver новый генератор test. \\
+//**Name**// - это имя //filegen//. При перестройке сервисов порядок вызова генератора определяется им.\\
+//**Filename**// - имя файла, куда будет сохраняться результат работы генератора. Если тип генератора //скрипт// и Filename не заполнено, используется временный файл, который потом удаляется \\
+//**Start mark**// - если файл необходимо встраивать внутрь другого, то это отметка начала генерированной секции. Необходимо оставлять это поле пустым, если нужно заменять файл.\\
+//**End mark**// - аналогично //Start mark//. Не используется, если //Start mark// не определен.\\
+//**File permissions**// - 4-х значный номер, обозначающий права на файл. Если не указан, используются права существующего на dedicated файла.\\
+//**Template**// - сам темплейт конфига. Подробнее о структуре ниже.\\
+Итак, пример построения //apache_vhosts.conf//:\\
+<code>
+<TMPL_LOOP accounts_loop>
+# HERE we loop over accounts
+# sites of account <TMPL_VAR login>
+<TMPL_LOOP hosts_loop> # embedded loop of bound to account hosts
+<VirtualHost *:80>
+  ServerName <TMPL_VAR name>
+  ServerAlias <TMPL_LOOP aliases_loop><TMPL_VAR alias> </TMPL_LOOP> # one more embedded loop
+# здесь используется backreferences и переменные из настроек
+  DocumentRoot <TMPL_VAR GLOBAL_clients_home>/<TMPL_VAR accounts_loop.login>/domains/<TMPL_VAR name>/html
+</VirtualHost>
+</TMPL_LOOP> # closing hosts_loop
+</TMPL_LOOP> # closing accounts_loop
+</code>
+Начинаем разбирать наш пример.\\
+Первым делом желательно прочитать документацию по //HTML::Template//, //template-engine//, использующуюся при построении файлов. Достаточно понимать значение //TMPL_LOOP//, //TMPL_VAR//. Документация расположена по адресу [[http://html-template.sourceforge.net/]].\\
+Каждый цикл индицируется названием //LOOPNAME_loop// и имеет ключ, к которому в темплейте можно обращаться как main_key. Например,\\
+<code>
+<TMPL_LOOP accounts_loop>
+Account <TMPL_VAR login> have ID <TMPL_VAR main_key>
+</TMPL_LOOP>
+</code>
+У каждого цикла есть параметры, в //accounts_loop// есть //login//, //passwd// и т.п.\\
+Параметром может быть цикл, тогда он содержит поддерево данных, типа {//accounts_loop//}{//$account_id//}{//hosts_loop//}{$//host_id//}{//name//}.\\
+В примере с //apache_vhosts.conf// это видно на //hosts_loop// и //aliases_loop//.\\
+Особый пример представляет строка //DocumentRoot//, в которой используется сразу два приема, //backreference// и доступ к переменным из //настроек//.\\
+//**backreference**// - это переменная, **НЕ ЛЕЖАЩАЯ** в текущей вложенности цикла. Как пример, мы приводим //accounts_loop.login//, который в //hosts_loop// не виден, так как хранится в //accounts_loop// (внешнем цикле).\\
+//**GLOBAL**// - способ обратиться к переменным в //configure//. Убирается из имени //GLOBAL_// и вытаскивается переменная.\\
+== Использование нескольких одинаковых циклов. ===
+В случае, если нужно использовать в одном уровне вложенности несколько одинаковых циклов применяется следующий путь: \\
+Пример (два цикла accounts_loop рядом): \\
+<code>
+Accounts: <TMPL_LOOP accounts_loop><TMPL_VAR login> </TMPL_LOOP>
+Hosts: <TMPL_LOOP accounts_loop><TMPL_LOOP hosts_loop><TMPL_VAR name> </TMPL_LOOP></TMPL_LOOP>
+</code>
+работать **НЕ БУДЕТ**, так как в темплейте два одинаковых внешних цикла accounts_loop и система будет пытаться присвоить переменные от одного цикла другому, что будет вызывать ошибку. \\
+Обходной путь - использовать номера в имени цикла. \\
+Правильный пример: \\
+<code>
+Accounts: <TMPL_LOOP accounts_loop><TMPL_VAR login> </TMPL_LOOP>
+Hosts: <TMPL_LOOP 2_accounts_loop><TMPL_LOOP hosts_loop><TMPL_VAR name> </TMPL_LOOP></TMPL_LOOP>
+</code>
+Обратите внимание, что во втором случае вместо accounts_loop стоит 2_accounts_loop - будет браться цикл accounts_loop, но не возникнет коллизии имен. \\
+== Генерация нескольких файлов из одного темплейта. ==
+Иногда необходимо сделать группу конфигурационных файлов. Как пример можно привести файлы зон //named// или виртуальных хостов //apache//. Самый простой способ деления - вставлять в темплейт метки начала деления //DK_NEW_FILE//. Пример: создаем файлы вирутальных хостов //apache//, по файлу на виртхост:\\
+<code>
+DK_NEW_FILE /usr/local/apache/conf.d/<TMPL_VAR name>.conf
+  ServerName <TMPL_VAR name>
+  ServerAlias <TMPL_LOOP aliases_loop><TMPL_VAR alias> </TMPL_LOOP> # one more embedded loop
+DocumentRoot <TMPL_VAR domain_htdocs_dir> # domain_htdocs_dir изменяется при каждой итерации цикла hosts_loop
+</code>
+//DK_NEW_FILE// дает команду системе обработки темплейтов создать файл с именем, идущим после //DK_NEW_FILE// (/usr/local/apache/conf.d/<TMPL_VAR name> в данном случае) и с содержимым от текущей метки до следующей или конца темплейта.
+метка //DK_NEW_FILE// должна находится в начале строки.\\

Различия

Просмотров

Навигация

Personal Tools

Поиск

Toolbox