README.ru.md

# ispmanager-mod_rewrite

## Описание

Плагин для ispmanager дляя поддержки [mod_rewrite](https://github.com/bayrepo/ngx_http_apache_rewrite_module)

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

- 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`

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

![Модули](img/isp_mod_rewrite1.png)

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

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

![Сборка](img/isp_mod_rewrite2.png)

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

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