Версия: 1.9

Precheck - проверка конфигурации

Что такое Precheck?

Precheck — инструмент для валидации конфигурации клана перед началом установки. Он позволяет быстро проверить:

Наличие обязательных переменных
Отсутствие непредусмотренных переменных, которые могут помешать корректной работе инсталлятора
Правильный формат имён хостов
Наличие лицензии и сертификатов
Наличие обязательных групп хостов

Как начать пользоваться?

Precheck доступен наряду с командами установки (такими как preinstall, infra и т.д.). Precheck запускается локально и не требует доступа к целевым хостам.

Для запуска:

Зайти в директорию с командами:
```
cd ~/ansible/
```
Подключить команды:
```
source setup.sh
```
Выбрать клан для проверки:
```
clan path/to/your/clan
```
Запустить Precheck:
```
check
```

Как читать вывод Precheck?

Precheck может выводить как информацию об ошибках (Errors), так и предупреждения (Warnings).

Ошибки помечаются в выводе красным цветом. Наличие ошибок говорит о том, что последующая инсталляция не может быть начата до их исправления.

Предупреждения помечаются в выводе жёлтым цветом. Предупреждения могут быть сознательно проигнорированы и позволяют приступить к инсталляции при одобрении поддержкой.

Возможные варианты вывода

Здесь описаны возможные проблемы, которые может подсветить Precheck и методы их решения.

Если вы столкнулись с ошибкой/предупреждением, то нужно сначала их исправить, добившись хорошего вывода Precheck, и только после этого приступать к инсталляции.

Хороший вывод:

В этом случае конфигурация верна и можно приступать к процессу инсталляции.
Ошибка: Missing required arguments: ...

Причина: Отсутствие обязательных переменных.

Пример вывода:

Решение: Добавить в клан соответствующие переменные. Список обязательных переменных можно посмотреть в разделе «Конфигурация Sage» клиентской документации.
Предупреждение: Found internal arguments, consider removing them: ...

Причина: Наличие непредусмотренных переменных в клане.

Пример вывода:

Решение: Если переменные не нужны, то их следует удалить, иначе связаться с поддержкой. Список предусмотренных, но необязательных переменных можно посмотреть в разделе «Конфигурация Sage» клиентской документации.
Ошибка: License file not found

Причина: отсутствие лицензии в положенном месте.

Пример вывода:

Решение: добавить файл с лицензией в ~/ansible/files/licenses/license.json
Ошибка: Certificates not found for:, Keys for certificates not found for:

Причина: Отсутствуют сертификаты/ключи для перечисленных хостов

Пример вывода:

Решение: Добавить сертификаты/ключи в ~/ansible/files/certificates/
Ошибка: В hosts.yml не указаны все необходимые группы:

Причина: В файле hosts.yml указаны не все необходимые группы, либо необходимая группа пуста (нет хостов).

Пример вывода:

Решение: добавить в hosts.yml перечисленные группы и добавить в эти группы нужные хосты.
Ошибка: Host 10.233.21.177 in ['grafana'] not a FQDN

Причина: Все хосты в hosts.yml должны быть указаны в формате FQDN (Fully Qualified domain name). Формат IP не поддерживается.

Пример вывода:

Решение: Замените IP адреса хостов в hosts.yml на доменные имена (FQDN).