Установка и развертывание

Установка и развертывание#

Метаданные#

  • Документ ID: REG-OPS-003

  • Версия: 0.1.1

  • Ответственный: ООО "Аросса"

  • Статус: Готово

1. Требования к окружению#

  • Аппаратные требования: локальный контроллер с Linux, CAN-интерфейсом, сетевым доступом и достаточными ресурсами для backend/UI/MQTT; для ПАК также требуется комплект полевых устройств AT32/ESP32 и Linux-камера.

  • Сетевые требования: доступность MQTT и REST между local/tenant/master уровнями, связность CANopen и RS485 в полевом контуре, поддержка автономной работы при временном отсутствии облачного канала.

  • Требования к ОС и зависимостям: Linux, PostgreSQL, Go 1.22 runtime, frontend на Vue 3.4.21/Vite 5.2.9, MQTT-брокер, dfu-util для AT32, ESP-IDF/idf.py для ESP32, ARM toolchain для AT32/ASR6601.

2. Порядок развертывания ПО «Зеленый робот» и ПАК#

  1. Подготовить backend/frontend стенд из ../ioot-pro-cabinet:

    • cd ../ioot-pro-cabinet

    • docker compose up -d --build

  2. Запустить frontend локально при необходимости стендовой проверки:

    • cd ../ioot-pro-cabinet/frontend-vue

    • ../scripts/node-env.sh npm install

    • ../scripts/node-env.sh npm run dev -- --host 127.0.0.1 --port 5173

  3. Проверить доступность runtime:

    • http://127.0.0.1:8080/swagger

    • GET /api/v1/app/context

    • GET /api/v1/modules/list

  4. Настроить MQTT/CANopen/RS485 и проверить локальный runtime на контроллере.

  5. Подключить embedded-компоненты из ../ioot-pro-embedded:

    • собрать/обновить прошивки AT32F415, ESP32-S3, ASR6601;

    • выполнить запись контроллеров по USB DFU или ST-Link.

  6. Выполнить smoke-проверку полного контура и оформить ввод в эксплуатацию.

3. Интеграция с ioot-pro-embedded#

  • Рабочий каталог:

    • cd ../ioot-pro-embedded

  • Сборка:

    • ./scripts/ioot_build_firmware.sh firmware-459-047-01

    • ./scripts/ioot_build_firmware.sh esp32

    • ./scripts/ioot_build_firmware.sh asr6601

  • Запись AT32 по USB DFU:

    • ./scripts/ioot_flash_at32_dfu.sh --build --profile firmware-459-047-01 --port /dev/cu.usbmodemXXXX

    • ./scripts/ioot_flash_at32_kernel_plc.sh --build --profile firmware-459-047-01 --plc-target wm_047 --port /dev/cu.usbmodemXXXX

  • Предварительные условия:

    • ARM_GCC_PATH должен указывать на каталог с arm-none-eabi-gcc;

    • idf.py должен быть доступен в shell для сборки ESP32-S3;

    • dfu-util должен быть установлен для сценариев AT32.

  • Проверка версии runtime:

    • app/context (scope runtime + policy.permissions/capabilities/guards),

    • modules/scheme (catalog_enrichment, runtime-конфигурация shell),

    • modules/list,

    • status/stream.

  • Для отладочного режима на стенде после обновления используется последовательный smoke-контур:

    • проверка CANopen/SDO,

    • проверка локального /api/v1/app/context,

    • проверка обработки команд,

    • проверка fallback поведения клиента: reconnect status/stream и резервный polling status/list.

4. Локальное и автономное развертывание#

  • Локальное развертывание допускается без постоянного облачного канала, если на объекте обеспечены Linux runtime, локальная БД, MQTT и связность с приборным контуром.

  • Для HMI-сценариев используется Linux-embedded сборка iP-11 на панели iT-21; такая поставка применяется как преднастроенный локальный контур оператора.

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

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

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

5. Откат и восстановление#

  • Порядок отката версии: остановить сервисы, восстановить предыдущий пакет релиза и совместимый дамп конфигурации/БД, выполнить smoke-проверку API и телеметрии.

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

Содержание