Как проверить YAML перед применением новой конфигурации?
Перед применением новой конфигурации Home Assistant следует выполнить проверку конфигурации доступным для вашей установки способом. Результат нужно прочитать полностью: если найдены ошибки YAML или настроек, сначала исправьте их в configuration.yaml и связанных файлах, затем повторите проверку.
Сначала определите установку
Способ проверки зависит от типа установки. Используйте соответствующий пункт интерфейса или команду, предусмотренную вашей средой. Не переносите инструкцию для Container на Home Assistant OS без проверки применимости.
- Определите, используется ли OS или Container.
- Откройте доступный инструмент проверки конфигурации.
- Проверьте именно текущий каталог конфигурации.
Как читать результат
Проверка должна завершиться без ошибок, относящихся к изменённым файлам. Сообщение об ошибке содержит направление для поиска проблемы: неверный отступ, ключ, значение или ссылка на отсутствующий компонент.
- Исправляйте одну группу ошибок за раз.
- Сохраняйте исходный текст сообщения.
- После каждого исправления запускайте проверку повторно.
Перед применением
Даже успешная проверка не заменяет понимание того, что изменилось. После подтверждения корректности примените изменения способом, поддерживаемым вашей установкой, и наблюдайте за результатом.
- Сделайте резервную копию конфигурации.
- Проверьте связанные автоматизации и интеграции.
- При сомнениях применяйте изменения небольшими частями.
Проверьте себя
- Определить доступный способ проверки.
- Исправить все обнаруженные ошибки.
- Повторить проверку перед перезагрузкой или перезапуском.
Частый вопрос
Можно ли применить конфигурацию, если проверка сообщила об ошибке?
Не следует. Сначала исправьте ошибку и повторите проверку, иначе новая конфигурация может не загрузиться корректно.