ispmanager-mod_rewrite/README.ru.md

ispmanager-mod_rewrite

Описание

Плагин для ispmanager дляя поддержки mod_rewrite

Поддерживаемые ОС

• AlmaLinux 9/10
• CentOS Stream 9/10
• и подбные RedHat подобные операционные системы

Описание работы

Плагин при установке пытается определить установленный nginx и его версию, скачивает необходимые пакеты и исходные коды модуля для nginx, собирает модуль и подкладывает собранные so файл, к модулям nginx.

Далее в UI ispmanager можно активировать модуль и подключить для нужных сайтов.

В пакете установлен хук, которые отслеживает версию nginx пакета и при обнолвлении пересобирает модуль.

Логи

Файлы логов работы плагина и сборки можно найти по пути:

• /usr/local/mgr5/var/nginx-mod-rewrite-plugin-addon.log
• /usr/local/mgr5/var/nginx-mod-rewrite-plugin.log

Сборка пакета

Для сборки пакета требуется наличие docker в ОС, более ничего не нужно. Для сборки пакета rpm плагина для ispmanager, необходимо выполнить следующую команду:

bash build_package.sh almalinux:9

Где almalinux:9 - это может быть любой образ rpm-based ОС.

Если сборка прошла успешно, в каталоге _packages появятся rpm файлы, пример таких файлов:

_packages/ispmanager-plugin-nginx_mod_rewrite_plugin-0.0.1-1.el9.src.rpm
_packages/ispmanager-plugin-nginx_mod_rewrite_plugin-0.0.1-1.el9.x86_64.rpm

На этом сборка окончена.

Установка и описание настроек

Для установки, необходимо установить пакет ispmanager-plugin-nginx_mod_rewrite_plugin на машине с уставновленным ispmanager. ispmanager должен быть сконфигурирован поддерживать nginx. Во время установки будут доустановлены, некоторые пакеты.

Список пакетов, которые будут достановлены:

• openssl-devel
• pcre-devel
• zlib-devel
• gcc
• gcc-c++
• make
• wget
• python3

Т.к nginx требует сборки любого модуля именно с текущей версией, поэтому модуль собирается именно при установке, детектится версия nginx и под нее происходит сборка.

Если же nginx обновляется, то при установке добавляется хук, который при обновлении nginx пересобирает под новый nginx модуль.

Для установки нужно установить собранный в предыдущем пункте пакет:

sudo dnf install _packages/ispmanager-plugin-nginx_mod_rewrite_plugin-0.0.1-1.el9.x86_64.rpm

Если вдруг установка провалилась, лог установки можно изучить здесь - /usr/local/mgr5/var/nginx-mod-rewrite-plugin.log

Если все прошло успешно, то необходимо перейти в раздел "Модули":

Найти модуль с названием "Модуль nginx mod_rewrite" и нажать на значек настройки модуля. На изображении выше обведены синим контуром.

Далее откроется окно сборки модуля:

Для отмены сборки, нажмите кнопку "Отменить сборку". Для сборки и установки хука пересборки при обновлении nginx необходимо нажать "Собать модуль и установить хук на пересборку".

Процесс сборки можно будет изучить в логе: `/usr/local/mgr5/var/nginx-mod-rewrite-plugin.log.