Перенос HOMEd с OpenWrt на отдельный сервер
Как подойти к переносу конфигурации и данных, разделить Compose-проекты и сохранить возможность отката.
В домашней инфраструктуре возникла задача вынести HOMEd с маршрутизатора OpenWrt на Orange Pi Zero 3 с Docker. Сервисы размещались отдельно, а не одним большим Compose-проектом.
Ниже — схема этого подхода, а не универсальный установочный скрипт. Фактические пути, версии и список работающих компонентов нужно определить на исходном сервере.
Начать с инвентаризации
Сначала составляется таблица: сервис, версия, конфиг, постоянные данные, способ запуска и зависимости.
Недостаточно найти один файл с расширением .conf.
Пути к базам могут быть переопределены в конфигурации,
а контейнеры могут использовать bind mounts или именованные тома.
Отдельно фиксируются:
- адрес MQTT-брокера и используемые учётные записи;
- MQTT-префиксы и имена инстансов;
- интеграции с Home Assistant и другие MQTT-клиенты;
- координаторы ZigBee и способ подключения к ним;
- пользовательские расширения и дополнительные файлы;
- настройки автозапуска и watchdog.
Пароли и сетевые ключи сохраняются в закрытой резервной копии, а не в публичной заметке или выводе диагностики.
Отдельный Compose-проект на сервис
Для этого переноса был выбран подход с независимыми проектами.
Так отдельный компонент можно остановить или проверить,
не выполняя docker compose down для всей системы.
Пример организации каталогов:
/opt/homed/
├── web/
│ ├── compose.yaml
│ └── data/
├── automation/
│ ├── compose.yaml
│ └── data/
└── zigbee-main/
├── compose.yaml
└── data/
Это пример структуры, не перечень обязательных сервисов и не утверждение о путях в любой установке.
Для HOMEd ZigBee официальный контейнер использует каталог /data.
В конфигурации внутри контейнера пути должны соответствовать
именно контейнерной файловой системе.
Сначала копия, затем переключение
Для каждого компонента порядок такой:
- Сохранить исходную конфигурацию и версию.
- Подготовить целевой каталог и Compose-проект.
- Для согласованной копии остановить переносимый сервис либо применить документированный механизм резервного копирования.
- Перенести конфигурацию и все необходимые данные.
- Проверить пути, права и адрес MQTT.
- Запустить целевой экземпляр.
- Проверить не только запуск, но и работу его функций.
Старый экземпляр не должен самопроизвольно возвращаться в работу через автозапуск или watchdog.
Для сервисов, способных выполнять автоматизации, одновременный запуск копий может привести к повторным действиям.
MQTT — отдельная задача
Перенос HOMEd и перенос MQTT-брокера лучше рассматривать как разные переключения. Пока брокер остаётся на старом месте, можно последовательно проверить перенесённые сервисы.
Локальное DNS-имя брокера удобно, но помогает только тем клиентам, которые действительно используют это имя. Устройства с жёстко заданным IP нужно учесть отдельно.
При переезде брокера проверяются его конфигурация, пользователи, ACL, настройки persistence и поддерживаемый порядок сохранения данных. Нельзя считать список сервисов HOMEd полным списком MQTT-клиентов.
Приёмка и откат
После переключения проверяются интерфейс, актуальные данные, команды устройствам, автоматизации и интеграция с Home Assistant. Для ZigBee дополнительно проверяются доступность координатора и управление устройствами существующей сети.
При откате сначала останавливается новый экземпляр, затем возвращается старый. Нельзя рассчитывать на безопасное совместное использование одной рабочей базы двумя процессами.
Удаление старой установки — отдельный финальный шаг, после проверки резервной копии и работы нового сервера.