Развертывание (Deploy): полное и частичное

Что такое Deploy и почему это важно

В процессе работы с Node-RED вы постоянно будете сталкиваться с термином Deploy (Развертывание). На первый взгляд, он может показаться аналогом кнопки "Сохранить" в обычном текстовом редакторе, но в контексте платформы HI и Node-RED его значение гораздо глубже. Понимание механики развертывания — это ключ к стабильной, предсказуемой и безопасной эксплуатации системы автоматизации.

Развертывание — это процесс активации изменений, внесенных в рабочую область Node-RED. Это не просто сохранение конфигурации потоков в файл на диске контроллера. Это активная операция, которая включает в себя несколько этапов:

Сохранение: Конфигурация всех ваших потоков (flows), включая их связи, настройки узлов и расположение, сохраняется в виде единого JSON-файла (обычно `flows.json`) в памяти контроллера.

Компиляция/Интерпретация: Node-RED анализирует внесенные изменения, проверяет их на базовую корректность и подготавливает к запуску.

Перезапуск: Среда выполнения Node-RED останавливает старые версии потоков (или их части) и запускает новые. Именно на этом этапе ваша новая логика начинает работать.

В правом верхнем углу интерфейса Node-RED находится кнопка Deploy. Ее состояние — ваш главный индикатор.

• Серая, неактивная кнопка: Означает, что в потоках нет несохраненных изменений. То, что вы видите на экране, в точности соответствует тому, что сейчас исполняется на контроллере.
• Красная, активная кнопка: Сигнализирует о том, что вы внесли изменения, которые еще не активированы. Это может быть перемещение узла, изменение его настроек, добавление или удаление соединения.

Как только вы изменяете узел, на нем появляется небольшой синий кружок. Это визуальный маркер, обозначающий так называемый "грязный" узел (dirty node) — узел, конфигурация которого была изменена, но еще не развернута. Наличие хотя бы одного такого узла в рабочей области делает кнопку Deploy активной.

> 📋 Ключевые понятия:

> * Deploy (Развертывание): Процесс применения изменений к работающей среде Node-RED. Включает сохранение, компиляцию и перезапуск потоков.

> * Dirty Node (Измененный узел): Узел, в который были внесены изменения, но они еще не были активированы через Deploy. Визуально помечается синим кружком.

Запомните: до тех пор, пока вы не нажмете красную кнопку "Deploy", все ваши правки — это лишь черновик. Система продолжает работать по старой, ранее развернутой, логике. Это фундаментальное отличие от многих сред программирования, где изменения применяются сразу после сохранения файла. В Node-RED сохранение и активация — это единый, осознанный шаг под названием "Deploy".

---

Полное развертывание (Full Deploy): механизм и последствия

Полное развертывание (Full Deploy) — это самый прямолинейный, но и самый "разрушительный" способ применить изменения. Он является поведением по умолчанию при простом нажатии на кнопку `Deploy`.

Механизм полного развертывания

Когда вы выполняете Full Deploy, Node-RED выполняет следующую последовательность действий:

Остановка всех потоков: Среда выполнения Node-RED останавливает абсолютно все активные процессы на всех вкладках. Это означает, что узлы `inject` прекращают генерировать сообщения по таймеру, прекращается опрос Modbus-устройств, прерываются все активные задержки в узлах `delay`, теряется связь с MQTT-брокером и т.д. Все состояния, хранившиеся в оперативной памяти (в контексте потока), уничтожаются.

Применение всех изменений: Новая конфигурация из файла `flows.json` загружается целиком. Node-RED перестраивает все потоки с нуля на основе этой новой конфигурации.

Перезапуск всех потоков: Все потоки запускаются заново, как если бы вы только что перезагрузили контроллер. Узлы инициализируются, устанавливают соединения, начинают циклы опроса.

> ⚠️ Внимание: Полное развертывание останавливает и перезапускает ВСЕ потоки на контроллере. Это может привести к кратковременному отключению освещения, остановке сбора данных или перезагрузке логики управления климатом. Всегда предупреждайте заказчика перед выполнением этого действия на работающем объекте.

Преимущества и недостатки

Преимущества:

• Гарантия консистентности: Полный перезапуск гарантирует, что система находится в чистом, предсказуемом состоянии. Это устраняет любые "фантомные" проблемы, которые могли возникнуть из-за накопленных ошибок в состоянии потоков (flow context).
• Применение глобальных изменений: Это единственный надежный способ применить изменения в узлах конфигурации (например, настройки подключения к MQTT-брокеру, MySQL-базе данных или COM-порту для Modbus). Поскольку эти узлы могут использоваться десятками других узлов на разных потоках, только полный перезапуск гарантирует, что все они начнут работать с новой конфигурацией.

Недостатки:

• Кратковременный простой (Downtime): На несколько секунд (в зависимости от сложности проекта) вся автоматизация на объекте перестает работать. Для коттеджа это может означать моргание светом, а для небольшого производственного объекта — остановку конвейера или потерю данных с критически важных датчиков.
• Потеря состояния: Если вы используете логику, основанную на контексте потока (например, для реализации переключателей-триггеров или конечных автоматов), это состояние будет потеряно, если оно не сохраняется в файловую систему или базу данных. Система вернется в исходное состояние.

Сценарии использования

Несмотря на недостатки, полное развертывание незаменимо в следующих ситуациях:

• Первоначальная загрузка проекта: Когда вы впервые загружаете конфигурацию на чистый контроллер.
• Внесение изменений в узлы конфигурации: Изменили IP-адрес MQTT-брокера, пароль к базе данных или скорость шины RS-485 — выполняйте Full Deploy.
• Устранение трудновоспроизводимых ошибок: Если после множества частичных развертываний система начинает вести себя странно, полное развертывание часто помогает "очистить" состояние и вернуть ее к стабильной работе.
• После обновления Node-RED или узлов палитры: Это гарантирует, что все компоненты будут запущены в новой среде корректно.

---

Частичное развертывание (Partial Deploy): умный подход

Частичное развертывание (Partial Deploy) — это интеллектуальный механизм, который позволяет минимизировать воздействие на работающую систему. Он идеально подходит для итеративной разработки и отладки, когда вы работаете над конкретным потоком и не хотите затрагивать остальную часть системы.

Принцип работы

При выборе частичного развертывания Node-RED не перезапускает все подряд. Вместо этого он выполняет умный анализ:

Определяет "грязные" узлы: Находит все узлы, которые были изменены с момента последнего развертывания (те самые, с синими кружками).

Определяет затронутые пути: Анализирует, какие еще узлы напрямую зависят от измененных. Например, если вы изменили узел `function`, то все узлы, подключенные к его выходам, считаются затронутыми. Также, если вы изменили узел конфигурации, все узлы, использующие его, будут перезапущены.

Перезапускает только необходимое: Node-RED останавливает и перезапускает только измененные и затронутые узлы. Все остальные потоки на других вкладках, которые никак не связаны с вашими правками, продолжают работать без прерывания.

> 💡 Подсказка: Для быстрой итеративной разработки всегда используйте частичное развертывание. Установите его как действие по умолчанию в выпадающем меню кнопки Deploy, чтобы избежать случайных полных перезапусков.

Как активировать и использовать

Опция частичного развертывания скрыта в выпадающем меню рядом с основной кнопкой `Deploy`.

Нажмите на маленькую стрелочку справа от кнопки `Deploy`.

В появившемся меню вы увидите несколько опций:

* Full (Полное): Стандартное поведение.

* Modified Flows (Измененные потоки): Перезапускает все узлы на тех вкладках (flows), где были изменения.

* Modified Nodes (Измененные узлы): Наиболее точечный вариант. Перезапускает только измененные узлы и их прямые зависимости. Это предпочтительный выбор в 90% случаев при разработке.

Выберите "Modified Nodes". Node-RED запомнит ваш выбор, и теперь основная кнопка `Deploy` будет выполнять именно это действие.

Практический пример

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

Создайте два независимых потока на одной вкладке:

* Поток 1: Узел `inject` (настроен на отправку метки времени раз в 5 секунд) -> узел `debug` (назовем его "Debug-Timer").

* Поток 2: Узел `inject` (отправляет строку "Hello") -> узел `debug` (назовем его "Debug-Message").

Выполните полное развертывание (Full Deploy). Откройте панель отладки. Вы увидите, что "Debug-Timer" начал выводить метки времени каждые 5 секунд. При нажатии на `inject` в Потоке 2, в логе появится сообщение "Hello".

Внесите изменение: Измените payload в узле `inject` Потока 2 на строку "Hello, Engineer!". Обратите внимание, что синий кружок появился только на этом узле.

Выполните частичное развертывание:

* Нажмите на выпадающее меню кнопки `Deploy`.

* Выберите "Modified Nodes".

* Нажмите `Deploy`.

Проанализируйте результат:

* В панели отладки вы не увидите прерывания в работе "Debug-Timer". Он продолжит выводить метки времени, как ни в чем не бывало. Его поток не был затронут.

* Если вы теперь нажмете на `inject` в Потоке 2, в логе появится новое сообщение: "Hello, Engineer!". Этот поток был успешно обновлен.

Этот простой пример демонстрирует главное преимущество частичного развертывания: изоляцию изменений. Вы можете отлаживать логику управления освещением в гостиной, не опасаясь, что в этот момент перезапустится система управления отоплением в котельной.

---

Сводка и лучшие практики

Правильный выбор типа развертывания — это признак профессионального инженера автоматизации. Это напрямую влияет на стабильность системы, скорость разработки и безопасность на объекте.

Ключевые различия

| Критерий | Полное развертывание (Full Deploy) | Частичное развертывание (Partial Deploy) |

| :--- | :--- | :--- |

| Механизм | Останавливает, перестраивает и перезапускает ВСЕ потоки. | Перезапускает ТОЛЬКО измененные узлы и их зависимости. |

| Влияние на систему | Высокое. Кратковременный простой всей системы автоматизации. | Минимальное или нулевое. Незатронутые потоки продолжают работать. |

| Скорость | Медленнее, особенно на больших проектах. | Очень быстро, почти мгновенно. |

| Сценарии использования | Изменение узлов конфигурации, первоначальная загрузка, решение "зависших" проблем. | Повседневная разработка, отладка, внесение небольших правок. |

| Обращение с контекстом | Весь `flow` и `global` контекст в памяти очищается. | Контекст незатронутых потоков сохраняется. |

Алгоритм выбора типа развертывания

При работе на объекте придерживайтесь простого алгоритма:

Вы работаете с узлом конфигурации? (MQTT, Modbus, MySQL и т.д.)

* Да: Используйте Полное развертывание. Это единственный надежный способ.

Вы вносите небольшие изменения в логику одного или нескольких потоков? (Меняете `function`, добавляете `debug`, корректируете `switch`)

* Да: Используйте Частичное развертывание (Modified Nodes).

После частичного развертывания поток ведет себя непредсказуемо?

* Да: Возможно, проблема в "старом" состоянии, оставшемся в контексте. Попробуйте выполнить Полное развертывание, чтобы "очистить" систему. Если проблема осталась, ищите ошибку в логике.

Это первая загрузка проекта на контроллер?

* Да: Используйте Полное развертывание.

Что делать, если после частичного развертывания поток работает некорректно?

Иногда после Partial Deploy вы можете столкнуться с неожиданным поведением. Самая частая причина — это состояние потока (Flow State), хранящееся в контексте (`flow context`). Представьте, что у вас был счетчик, реализованный через `flow.set("counter", ...)`. Вы изменили логику работы с этим счетчиком, но сам счетчик остался в контексте со старым значением. Новая логика может быть не готова к такому значению, что приведет к ошибке.

В этом случае Full Deploy помогает, так как он полностью стирает контекст из оперативной памяти, и при новом запуске все переменные в контексте инициализируются с нуля.

> 🔗 Связанный материал: Понимание состояний потоков критически важно при отладке. Подробнее о работе с контекстом и методах его сохранения между перезагрузками вы узнаете в уроке `COURSE-06-M04-L01`.

Контроль версий для конфигураций

Конфигурация потоков Node-RED — это простой текстовый файл `flows.json`. Это открывает огромные возможности для профессионального управления проектом с использованием системы контроля версий, такой как Git.

• Отслеживание изменений: Вы всегда можете видеть, кто, когда и какие изменения внес в логику.
• Откат к предыдущим версиям: Если новая логика оказалась ошибочной, вы можете за несколько секунд "откатиться" к стабильной версии.
• Ветвление и совместная работа: Несколько инженеров могут работать над разными функциями в отдельных ветках, а затем слить свои изменения в основной проект.

Внедрение Git в вашу практику работы с Node-RED на контроллерах HI выводит вас на следующий уровень надежности и профессионализма, особенно при работе на сложных или командных проектах.

Что дальше

В этом уроке мы разобрали один из самых фундаментальных механизмов Node-RED — развертывание. Теперь вы понимаете разницу между полным и частичным deploy, знаете, как и когда применять каждый из них для эффективной и безопасной работы. В следующем уроке мы перейдем к мощному инструменту отладки — узлу `debug` — и научимся анализировать сообщения, проходящие через ваши потоки.