Слой за слоем / xoloxi.org
Офтоп /

Перенос HOMEd с OpenWrt на отдельный сервер

Как подойти к переносу конфигурации и данных, разделить Compose-проекты и сохранить возможность отката.

В домашней инфраструктуре возникла задача вынести HOMEd с маршрутизатора OpenWrt на Orange Pi Zero 3 с Docker. Сервисы размещались отдельно, а не одним большим Compose-проектом.

Ниже — схема этого подхода, а не универсальный установочный скрипт. Фактические пути, версии и список работающих компонентов нужно определить на исходном сервере.

Начать с инвентаризации

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

Недостаточно найти один файл с расширением .conf. Пути к базам могут быть переопределены в конфигурации, а контейнеры могут использовать bind mounts или именованные тома.

Отдельно фиксируются:

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

Отдельный Compose-проект на сервис

Для этого переноса был выбран подход с независимыми проектами. Так отдельный компонент можно остановить или проверить, не выполняя docker compose down для всей системы.

Пример организации каталогов:

/opt/homed/
├── web/
│   ├── compose.yaml
│   └── data/
├── automation/
│   ├── compose.yaml
│   └── data/
└── zigbee-main/
    ├── compose.yaml
    └── data/

Это пример структуры, не перечень обязательных сервисов и не утверждение о путях в любой установке.

Для HOMEd ZigBee официальный контейнер использует каталог /data. В конфигурации внутри контейнера пути должны соответствовать именно контейнерной файловой системе.

Сначала копия, затем переключение

Для каждого компонента порядок такой:

  1. Сохранить исходную конфигурацию и версию.
  2. Подготовить целевой каталог и Compose-проект.
  3. Для согласованной копии остановить переносимый сервис либо применить документированный механизм резервного копирования.
  4. Перенести конфигурацию и все необходимые данные.
  5. Проверить пути, права и адрес MQTT.
  6. Запустить целевой экземпляр.
  7. Проверить не только запуск, но и работу его функций.

Старый экземпляр не должен самопроизвольно возвращаться в работу через автозапуск или watchdog.

Для сервисов, способных выполнять автоматизации, одновременный запуск копий может привести к повторным действиям.

MQTT — отдельная задача

Перенос HOMEd и перенос MQTT-брокера лучше рассматривать как разные переключения. Пока брокер остаётся на старом месте, можно последовательно проверить перенесённые сервисы.

Локальное DNS-имя брокера удобно, но помогает только тем клиентам, которые действительно используют это имя. Устройства с жёстко заданным IP нужно учесть отдельно.

При переезде брокера проверяются его конфигурация, пользователи, ACL, настройки persistence и поддерживаемый порядок сохранения данных. Нельзя считать список сервисов HOMEd полным списком MQTT-клиентов.

Приёмка и откат

После переключения проверяются интерфейс, актуальные данные, команды устройствам, автоматизации и интеграция с Home Assistant. Для ZigBee дополнительно проверяются доступность координатора и управление устройствами существующей сети.

При откате сначала останавливается новый экземпляр, затем возвращается старый. Нельзя рассчитывать на безопасное совместное использование одной рабочей базы двумя процессами.

Удаление старой установки — отдельный финальный шаг, после проверки резервной копии и работы нового сервера.

Документация