Инструкция по установке платформы GetLMS

1. Требования

Перед началом установки убедитесь, что у вас установлены:

Ansible (версии 2.10 и выше)
sshpass (необходим для передачи пароля SSH)
Доступ по SSH к серверу с правами root

2. Подготовка к установке

Распакуйте архив с установочными файлами в любую удобную директорию.
В архив входят:
- inventory.yml — файл настроек
- getlms-app-single.yml — Ansible playbook
- вспомогательные файлы и шаблоны
Добавьте сервер в known_hosts.
Для этого выполните команду:
```
ssh root@<ip_сервера>
```
После первого подключения подтвердите добавление ключа (yes) и закройте соединение (exit).

3. Настройка параметров

Откройте файл inventory.yml и укажите ваши данные. Пример:

all:
  hosts:
  children:
    apps:
      hosts:
        main:
          ansible_host: <ip сервера, куда будет устанавливаться платформа>
          ansible_connection: ssh
          ansible_ssh_user: root
          ansible_ssh_pass: "<пароль пользователя root>"
      vars:
        db_name: getlms
        db_user: web
        db_password: "<пароль БД>"
        user_name: web
        user_password: "<пароль пользователя web>"
        cp_domain: "<домен панели управления, например: cp-reestr.getlms.ru>"
        client_domain: "<домен второго уровня, например: getlms.ru>"

Курсы будут доступны по поддоменам вида *.getlms.ru, а панель управления — по адресу cp-reestr.getlms.ru.

4. Запуск установки

После заполнения файла настроек запустите установку:

ansible-playbook -i inventory.yml getlms-app-single.yml

Дождитесь завершения выполнения. Если установка прошла успешно, в консоли не должно быть сообщений об ошибках (failed=0).

5. Проверка работы

Откройте в браузере домен, указанный в параметре cp_domain.
Убедитесь, что страница панели управления доступна и корректно загружается.

6. Настройка SSL-сертификатов

Для обеспечения защищенного соединения используется Certbot.

Для панели управления (cp_domain) сертификат создается автоматически во время установки.
Для курсов (client_domain) требуется wildcard-сертификат, который необходимо сгенерировать вручную.

Инструкция по созданию wildcard-сертификата доступна по ссылке:

https://certbot.eff.org/instructions?ws=nginx&os=ubuntufocal&tab=wildcard

7. Завершение установки

После генерации сертификата и перезапуска Nginx платформа готова к работе.