====== Ansible. Установка ISPmanager ======

Playbook проверялся на следующих дистрибутивах:
  * CentOS 6 / 7
  * Ubuntu 16.04
  * Debian 8

===== Подготовка =====

  * Клонируем git-репозиторий:

<code git>
git clone https://github.com/NARk0d/ansible.ispmanager-install
</code>

  * перемещаемся в рабочий каталог

<code bash>
cd ansible.ispmanager-install
</code>

  * обращаем внимание на следующие файлы и их содержимое:
    * **hosts** - пример inventory-файла, в котором инициализируем следующие **переменные**:

<WRAP center round info 100%>

      * **trial.host** - имя хоста (не переменная, а сразу значение)
      * **ansible_ssh_host** - IP адрес хоста
      * **ansible_port** - порт для соединения по SSH
      * **ansible_ssh_user** - имя пользователя, от имени которого будут выполняться все действия

</WRAP>

    * **%%ispmanager_install_without_mail.yml%%** - playbook (сценарий выполнения) для установки без почтового сервера;
    * **%%ispmanager_install_with_mail.yml%%** - playbook для установки с почтовым сервером.

Playbook заслуживает отдельного внимания. Обращаем особое внимание на выполнение роли **ispmanager**:

<code yaml>
- { role: ispmanager, isp_activation_key: "", FTP: true, MYSQL: true, WEB: true, SSL: true, MAIL: false, ADD_USER: true, user_name: "www-root" }
</code>

Два playbook'а отличаются параметрами этой роли:

^  Переменная  ^  Допустимое значение  ^  Значение по умолчанию  ^  Описание  ^
| **isp_activation_key:** |  %%<string>%%  |  | Если выполняется установка с купленной лицензией, то указываем ключ продукта. \\ Если выполняется триальная установка, то значение оставляем пустым или вообще не указываем данный параметр |
| **FTP** |  true \\ false  |  true  | Включает или отключает установку FTP-сервера. Используется ProFTPd. |
| **MYSQL** |  true \\ false  |  true  | Включает или отключает установку MySQL-сервера |
| **WEB** |  true \\ false  |  true  | Включает или отключает установку web-сервера. Инсталлируется Nginx, PHP-fpm, Apache2 (MPM ITK), Logrotate |
| **PHPMYADMIN** |  true \\ false  |  true  | Включает или отключает установку phpMyAdmin |
| **SSL** |  true \\ false  |  true  | Включает или отключает установку Let's Encrypt |
| **MAIL** |  true \\ false  |  true  | Включает или отключает установку почтового сервера. Инсталлируется Exim, Dovecot, ClamAV, SpamAssassin, OpenDKIM, Sieve, Greylisting, AfterLogic |
| **ADD_USER** |  true \\ false  |  true  | Отвечает за создание пользователя |
| **user_name** |  %%<string>%%  |  www-root  | Задаётся имя пользователя, который будет создан в случае использования соответствующей функции |

----

===== Использование =====

Установка ISPmanager без компонентов почтового сервера с использованием inventory-файла в составе git-репозитории:
<code bash>
ansible-playbook -i hosts ispmanager_install_without_mail.yml
</code>

Аналогично, но с компонентами почтового сервера:
<code bash>
ansible-playbook -i hosts ispmanager_install_with_mail.yml
</code>