Wiren Board Cloud: различия между версиями

Текущая версия на 11:23, 14 апреля 2024

Описание

Демонстрация

Wiren Board Cloud — сервис удаленного администрирования систем автоматизации на контроллерах Wiren Board. Подробное описание возможностей

Работает в контроллерах Wiren Board 6 и новее.

Информацию об ошибках и пожелания присылайте на портал техподдержки. Если вы сообщаете о проблемах — приложите к сообщению диагностический архив.

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

На контроллер Wiren Board устанавливается агент wb-cloud-agent, который соединяется с облаком и получает из него настройки для создания тоннелей и отправки метрик. Для отправки метрик используется сервис wb-cloud-agent-telegraf, а для тоннелей wb-cloud-agent-frpc.

Данные передаются по защищённому каналу. Авторизация контроллера в облаке происходит по ключу, хранящемся в чипе ATECCx08.

Подключение контроллера к облаку

Установка агента

Агент доступен на контроллерах Wiren Board 6 и новее с релизами ПО testing, wb-2207, wb-2310 и новее. Как узнать релиз ПО на контроллере.

Установка:

Обновите список пакетов:
```
apt update
```
Установите агент:
```
apt install wb-cloud-agent
```

В дальнейшем агент будет обновляться вместе с операционной системой командами:

apt update ; apt upgrade

Важно! После обновления контроллера fit-файлом надо заново поставить агента. В будущем это будет исправлено.

Добавление контроллера в облако

Ссылка на добавление в веб-интерфейсе контроллера

По умолчанию контроллер отключен от облака, надо его добавить:

Откройте веб-интерфейс контроллера, перейдите Настройки → Система и кликните на появившейся ссылке в разделе Подключение к облаку.
После перехода по ссылке вы попадёте в личный кабинет, либо система попросит авторизоваться или создать аккаунт.

Также ссылку на добавление можно получить в консоли, для этого подключитесь к контроллеру по SSH и введите команду wb-cloud-agent:

# wb-cloud-agent
👉 https://wirenboard.cloud/controllers?add=69bdf824559896554d15abeaba3e62ad30c5a8f65er82f52be0bf87f084b1

Важно! Если в контроллере удалить данные через factory reset, а потом снова поставить агент — контроллер подключится к облаку автоматически.

Отключение контроллера от облака

Инструкция:

Перейдите в личный кабинет, откройте страницу контроллера и удалите контроллер.
Подключитесь к контроллеру по SSH.
Введите команду:
```
apt purge wb-cloud-agent
```

Если вы раньше использовали stable-релиз и добавляли при установке экспериментальный репозиторий — удалите его:

rm /etc/apt/sources.list.d/wb-cloud.list ; apt update

@@ Строка 1: / Строка 1: @@
-{{DISPLAYTITLE:Удалённый доступ к контроллеру Wiren Board через Wiren Board Cloud}}
+{{DISPLAYTITLE: Wiren Board Cloud — удалённое администрирование}}
 == Описание ==
-{{note|info|Cервис находится в стадии открытого бета-тестирования. Его можно использовать в любых проектах, но могут встречаться незначительные ошибки и временная потеря связи с облаком.}}
+{{YouTube
-[https://wirenboard.cloud Wiren Board Cloud] — сервис удалённого администрирования контроллеров Wiren Board, который позволяет отслеживать текущий статус контроллера, а также получать доступ к SSH и веб-интерфейсу. По умолчанию сервис выключен.
+|link=https://youtu.be/rWrG4mDfgec
+|text=Демонстрация}}
+[https://wirenboard.cloud Wiren Board Cloud] —  сервис удаленного администрирования систем автоматизации на контроллерах Wiren Board. '''[https://wirenboard.com/ru/pages/cloud/ Подробное описание возможностей]'''
-Информацию об ошибках и пожелания присылайте в [https://t.me/+mF77lEE0kB01NGY6 Чат пользователей Wiren Board Cloud]. Если вы сообщаете о проблемах — приложите к сообщению [[Wiren_Board_Web_Interface#diagnostic |диагностический архив]].
+Работает в контроллерах Wiren Board 6 и новее.
-<gallery mode="packed" heights="120px" caption="Интерфейс облака и демонстрация возможностей">
+Информацию об ошибках и пожелания присылайте на [https://support.wirenboard.com/ портал техподдержки]. Если вы сообщаете о проблемах — приложите к сообщению [[Wiren_Board_Web_Interface#diagnostic |диагностический архив]].
-Image: wb-cloud-controllers.png | Список контроллеров
-Image: wb-cloud-controller-page.png | Страница контроллера
-Image: wb-cloud-controller-ssh.png | Доступ к SSH через браузер
-Image: wb-cloud-controller-webui.png | Доступ к веб-интерфейсу
-</gallery>
 == Принцип работы ==
-На контроллере устанавливается агент ''wb-cloud-agent'', который соединяется с облаком и получает оттуда настройки для создания тоннелей и отправки метрик. Для отправки метрик используется сервис ''wb-cloud-agent-telegraf'', а для тоннелей ''wb-cloud-agent-frpc''.
+На контроллер Wiren Board устанавливается агент ''wb-cloud-agent'', который соединяется с облаком и получает из него настройки для создания тоннелей и отправки метрик. Для отправки метрик используется сервис ''wb-cloud-agent-telegraf'', а для тоннелей ''wb-cloud-agent-frpc''.
-Данные передаются по защищённому каналу. Авторизация контроллера в облаке происходит по сертификату, хранящемся в чипе [[CryptodevATECCx08_Auth|ATECCx08]].
+Данные передаются по защищённому каналу. Авторизация контроллера в облаке происходит по ключу, хранящемся в чипе [[CryptodevATECCx08_Auth|ATECCx08]].
-== Подключение контроллера ==
+== Подключение контроллера к облаку ==
 === Установка агента ===
-Процедура установки зависит от релиза ПО, которое установлено на контроллере.
+Агент доступен на контроллерах Wiren Board 6 и новее с релизами ПО testing, wb-2207, wb-2310 и новее. [[Wiren_Board_Software#releases|Как узнать релиз ПО на контроллере]].
-testing-релиз:
+Установка:
 # Обновите список пакетов:
 #:<syntaxhighlight lang="bash">
 apt update
 </syntaxhighlight>
-# Установите агент
+# Установите агент:
 #:<syntaxhighlight lang="bash">
 apt install wb-cloud-agent
 </syntaxhighlight>
-stable-релиз:
+В дальнейшем агент будет обновляться вместе с операционной системой командами:
-# Добавьте тестовый репозиторий и обновите список пакетов:
+:<syntaxhighlight lang="bash">
-#:<syntaxhighlight lang="bash">
+apt update ; apt upgrade
-echo "deb http://deb.wirenboard.com/all experimental.wb-cloud-agent main" > /etc/apt/sources.list.d/wb-cloud.list ; apt update
-</syntaxhighlight>
-# Установите агент
-#:<syntaxhighlight lang="bash">
-apt install wb-cloud-agent
 </syntaxhighlight>
+Важно! После обновления контроллера fit-файлом надо заново поставить агента. В будущем это будет исправлено.
 === Добавление контроллера в облако ===
+[[Image: wb-cloud-add-controller-1.png |thumb|300px|Ссылка на добавление в веб-интерфейсе контроллера]]
 По умолчанию контроллер отключен от облака, надо его добавить:
 # Откройте веб-интерфейс контроллера, перейдите '''Настройки''' → '''Система''' и кликните на появившейся ссылке в разделе '''Подключение к облаку'''.
 # После перехода по ссылке вы попадёте в личный кабинет, либо система попросит авторизоваться или создать аккаунт.
-<gallery mode="packed" heights="150px">
+Также ссылку на добавление можно получить в консоли, для этого подключитесь к контроллеру по [[SSH]] и введите команду <code>wb-cloud-agent</code>:
-Image: wb-cloud-add-controller-1.png | Ссылка на добавление в веб-интерфейсе контроллера
-Image: wb-cloud-add-controller-2.png | Запрос на добавление, если пользователь авторизован
-Image: wb-cloud-add-controller-3.png | Заполнение дополнительной информации
-</gallery>
-=== Удаление контроллера из облака ===
+<syntaxhighlight lang="console">
-Если вы не хотите использовать облако:
+# wb-cloud-agent
-# Перейдите в личный кабинет и откройте страницу контроллера.
+👉 https://wirenboard.cloud/controllers?add=69bdf824559896554d15abeaba3e62ad30c5a8f65er82f52be0bf87f084b1
-# Внизу страницы нажмите кнопку '''Удалить контроллер'''.
+</syntaxhighlight>
-<gallery mode="packed" heights="150px">
+Важно! Если в контроллере удалить данные через factory reset, а потом снова поставить агент — контроллер подключится к облаку автоматически.
-Image: wb-cloud-controller-page.png | Кнопка ''Удалить контроллер'' внизу
-Image: wb-cloud-delete-controller-1.png | Подтверждение удаления контроллера
-</gallery>
-=== Отключение агента на контроллере ===
+== Отключение контроллера от облака ==
-Если вы никогда не планируете подключать контроллер к облаку, можно отключить агент:
+Инструкция:
+# Перейдите в личный кабинет, откройте страницу контроллера и удалите контроллер.
 # Подключитесь к контроллеру по [[SSH]].
-# Введите команды:
+# Введите команду:
 #:<syntaxhighlight lang="bash">
-systemctl stop wb-cloud-agent ; systemctl disable wb-cloud-agent
+apt purge wb-cloud-agent
 </syntaxhighlight>
-Чтобы повторно активировать агент:
+Если вы раньше использовали stable-релиз и добавляли при установке экспериментальный репозиторий — удалите его:
-# Подключитесь к контроллеру по [[SSH]].
+:<syntaxhighlight lang="bash">
-# Введите команды:
+rm /etc/apt/sources.list.d/wb-cloud.list ; apt update
-#:<syntaxhighlight lang="bash">
-systemctl enable wb-cloud-agent ; systemctl start wb-cloud-agent
 </syntaxhighlight>

Навигация