Особенности работы с Web-скриптами (APS)

Материал из ISPWiki
Перейти к: навигация, поиск


Web-скрипты (APS) являются удобным средством работы с популярным Web-ориентированным программным обеспечением. В настоящее время в ISPmanager поддерживается работа с APS стандартов 1.0, 1.1, 1.2.

Работа с репозиторием APS

Панель управления работает с основным официальным репозиторием APS, доступным по адресу: http://apscatalog.com/all.atom

Администратор сервера также может подключить свой репозиторий APS, указав в конфигурационном файле панели путь до xml-файла репозитория с помощью параметра:

ApsExtRepository

Например:

ApsExtRepository http://my.web.aps/repo.xml

При обновлении списка Web-скриптов панель закачивает файлы репозитория и производит их разбор, сохраняя в свою базу данных информацию о доступных пакетах Web-скриптов. В ISPmanager Business вся информация о пакетах скриптов хранится в базе данных мастер-панели.

В момент, когда первый раз производится установка конкретного пакета APS, Web-скрипт скачивается панелью на сервер, а уже затем производится установка Web-скрипта в директорию Web-домена, указанную пользователем. При повторной установке скрипта любым пользователем APS не скачивается заново, а используется его локальная копия. В ISPmanager Business скрипты скачиваются только на сервер, где расположена мастер-панель, а уже в момент установки пользователем по необходимости копируются в нужный узел кластера.

Настройка пользовательского списка пакетов веб-скриптов

На уровне пользователя панели список Web-скриптов отличается от доступного администраторам панели управления. Мы постарались сделать список максимально удобным для использования. Администраторы могут увидеть этот список, нажав кнопку "Разрешенные" в "Каталоге Web-скриптов".


Пользователи панели управления могут работать только с теми пакетами APS, которые разрешены к использованию. Функциональность управления доступностью Web-скриптов для пользователя отражена в списке "Пакеты Web-скриптов" (кнопка "Список" в "Каталоге Web-скриптов"). Администратор может разрешить или запретить конкретный пакет APS к использованию, а также выбрать из списка пакетов тот, который будет использован по умолчанию (при "Быстрой установке", см. ниже).


На уровне пользователя доступные пакеты вынесены в один список, сгруппированный по имени, для каждой группы пакетов имеется кнопка "Установить". При нажатии на эту кнопку пользователю предлагается сначала выбрать конкретную версию пакета (версия "По умолчанию" уже выбрана в списке и отмечена зеленым цветом), а затем продолжить установку с помощью мастера.


Несколько по-другому выглядит пользовательский список Web-скриптов, доступный по кнопке "Скрипты" в списке Web-доменов. Так как эта форма отображается для конкретного Web-домена, она дополнена информацией об уже установленных Web-скриптах с возможностью удалить какой-либо из списка установленных. При удалении никакая пользовательская информация удалена не будет. Также в этом варианте формы появляется кнопка "Быстрая установка", при нажатии на которую для Web-домена будет установлен пакет Web-скрипта с версией по-умолчанию и автоматически подобранными настройками.


Обновление списка Web-скриптов и настройки

При обновлении списка Web-скриптов происходит обновление всей информации о доступных пакетах APS. Соответственно, какие-либо пакеты могут удаляться из списка, другие будут добавляться. Чтобы во время обновления не терялись настройки доступности Web-скриптов пользователям, у администратора имеется возможность повлиять на автоматическое применение этих настроек при обновлении.

В директории панели управления etc/templates имеется файл aps_settings.xml.

Пример файла:

<doc>
  <imagemapping defimg="aps.png">
    <apsimg name="Drupal">drupal.png</apsimg>
    <apsimg name="joomla">joomla.png</apsimg>
    <apsimg name="WordPress">wordpress.png</apsimg>
    <apsimg name="Prestashop">prestashop.png</apsimg>
    <apsimg name="phpBB">phpbb.png</apsimg>
  </imagemapping>
  <updaterules>
    <onupdate name="Drupal" type="latest"/>
    <onupdate name="joomla" type="latest" quantity="1"/>
    <onupdate name="WordPress"/>
    <onupdate name="Prestashop" quantity="2"/>
    <onupdate name="phpBB" force="yes"/>
  </updaterules>
  <defverrules>
    <defver name="Drupal"/>
    <defver name="joomla" type="latest"/>
    <defver name="WordPress"/>
    <defver name="Prestashop"/>
    <defver name="phpBB"/>
  </defverrules>
</doc>

Секция imagemapping

Данная секция предназначена для описания картинок для Web-скриптов (отображаются в пользовательском списке для каждого web-скрипта). Атрибут defimg секции определяет картинку, которая будет использована по умолчанию, если не найдена подходящая по имени скрипта.

Картинки должны быть расположены в директории skins/common/img панели управления и являться файлами формата png размером 32*32 точки.

Каждый элемент apsimg в значении содержит имя картинки, подходящей для web-скрипта, имя которого указано в атрибуте name.

Секция updaterules

Данная секция описывает правила обновления списка доступных пользователю Web-скриптов.

Каждый элемент onupdate содержит правило обновления для web-скрипта, имя которого указано в атрибуте name.

Атрибуты элемента:

  • name - имя Web-скрипта, к которому должно применяться правило (напр. name="joomla")
  • type - тип автоматического выбора пакетов. Возможные значения - latest (использовать последние версии - самые новые), earliest (использовать самые ранние версии - самые старые), definite (использовать конкретную версию) (напр. type="latest"). В случае, если значение атрибута - definite, в значении элемента onupdate нужно указать версию Web-скрипта (напр. <onupdate name="Drupal" type="definite">7.31-36</onupdate>). Значение по умолчанию - latest
  • quantity - количество пакетов Web-скриптов (напр. quantity="1"). Применимо, если type имеет значение latest или earliest, - при значении, отличном от единицы, доступность по умолчанию будет включена у указанного количества пакетов. Комбинация type="latest" и quantity="3", например, приведет к включению доступности у трёх последних версий пакетов Web-скриптов. Значение по умолчанию - 1
  • force - без указания этого атрибута наборы правил применяются только если в списке пакетов конкретного Web-скрипта не осталось ни одного пакета, доступного пользователям. Значение атрибута, указанное как "yes" (force="yes") позволяет при каждом обновлении переопределять версии доступных пакетов в соответствии с правилом . Ранее доступные версии могут при этом стать недоступными.

Секция defverrules

Данная секция описывает порядок выбора версии пакета "по умолчанию" из списка доступных пользователям.

Каждый элемент defver содержит правило автоматического выбора версии по умолчанию для web-скрипта, имя которого указано в атрибуте name.

Атрибуты элемента:

  • name - имя Web-скрипта, к которому должно применяться правило (напр. name="joomla")
  • type - тип автоматического выбора пакета по умолчанию. Возможные значения - latest (использовать последнюю версию - самую новую), earliest (использовать самую раннюю версию - самую старую), definite (использовать конкретную версию) (напр. type="latest"). В случае, если значение атрибута - definite, в значении элемента defver нужно указать версию Web-скрипта, которая будет выбрана доступной по умолчанию (напр. <defver name="Drupal" type="definite">7.31-36</defver>). Значение по умолчанию - latest

В соответствии с правилами, описываемыми в секции updaterules, при обновлении списка Web-скриптов у определённых пакетов APS будет включена доступность пользователям, а в соответствии с правилами из defverrules один из этих пакетов будет выбран как пакет "По умолчанию".

Правила из defverrules также применяются и при работе администратора с доступностью Web-скриптов пользователям. Например, при выключении доступности Web-скрипта если в списке есть ещё доступные, один из них будет автоматически выбран как используемый по умолчанию именно в соответствии с этими правилами.