Создание и подготовка устройства IoT Edge в Linux с помощью симметричного ключа

Бесплатный или стандартный Концентратор IoT в подписке Azure.

• Бесплатный или стандартный концентратор IoT в вашей подписке Azure
• Visual Studio Code
• расширение Azure IoT Edge. Расширение Azure IoT Edge для Visual Studio Code находится в режиме обслуживания.
• расширение Центр Интернета вещей Azure

• Бесплатный или стандартный концентратор IoT в вашей подписке Azure

• Azure CLI в среде

  Как минимум, версия Azure CLI должна быть 2.0.70 или более поздней. Для проверки используйте az --version. Эта версия поддерживает команды расширения az и внедряет фреймворк команд Knack.

В центре Интернета вещей на портале Azure вы создаете и управляете устройствами IoT Edge отдельно от устройств Интернета вещей, которые не поддерживают функции edge.

1. Войдите на портал Azure и перейдите в центр Интернета вещей.

2. В левой области выберите "Устройства " в меню, а затем нажмите кнопку "Добавить устройство".

3. В разделе "Создание устройства" укажите следующие сведения:

   • Создайте описательный идентификатор устройства, например my-edge-device-1 (все в нижнем регистре). Скопируйте этот идентификатор устройства, как вы его используете позже.
   • Установите флажок IoT Edge device.
   • В качестве типа проверки подлинности выберите Симметричный ключ.
   • Используйте параметры по умолчанию для автоматического создания ключей проверки подлинности, которые подключают новое устройство к центру.

4. Нажмите Сохранить.

Вы можете увидеть ваше новое устройство в вашем IoT-хабе.

Вход в Azure

Используйте расширения Azure IoT для Visual Studio Code для выполнения операций с центром Интернета вещей. Установите необходимые компоненты расширения Azure IoT.

После установки расширений Azure IoT Edge и Центр Интернета вещей Azure в меню слева появится значок Azure. Войдите в учетную запись Azure через Visual Studio Code, выбрав значок Azure и выбрав Sign in to Azure.

Регистрация нового устройства с помощью Visual Studio Code

Регистрация нового устройства аналогична созданию устройства IoT Edge на портале Azure. Это виртуальное устройство является одним из двойников, в то время как реальное устройство является другим двойником. Программа Visual Studio Code может настроить это виртуальное устройство для вас, выполнив следующие шаги.

1. В меню обозревателя Visual Studio Code разверните раздел Центр Интернета вещей Azure.
2. Выберите ... многоточие в заголовке раздела Центр Интернета вещей Azure. Если вы не видите многоточие, выберите или наведите указатель мыши на заголовок.
3. Выберите Create IoT Edge Device.
4. В открываемом текстовом поле укажите идентификатор устройства, например my-edge-device-1 (все строчные буквы), и нажмите клавишу ВВОД.

В выходной консоли Visual Studio Code отображается результат команды: печать JSON. Сведения об устройстве включают предоставленный идентификатор устройства и создает значение connectionString , которое можно использовать для подключения физического устройства к центру Интернета вещей. В выходной консоли также отображаются ключи и другие сведения об идентификации устройства.

Теперь устройство отображается в разделе Центр Интернета вещей Azure > Устройства меню обозревателя.

Используйте команду az iot hub device-identity create, чтобы создать новый идентификатор устройства в вашем концентраторе IoT. Замените device_id_here на свой новый и уникальный идентификатор устройства, например my-edge-device-1 (строчными буквами). Замените hub_name_here на ваш существующий Центр Интернета вещей.

Эта команда принимает три параметра:

• --device-id или -d: Укажите описательное имя, которое будет уникальным в рамках вашего центра Интернета вещей.

• --hub-name или -n: содержит имя Центра Интернета вещей;

• --edge-enabled или --ee. Объявите, что устройство является устройством IoT Edge.

  az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled
  

Если ваш CLI сообщает: Команда требует расширение azure-iot. Хотите установить его сейчас?, введите Y и нажмите клавишу ВВОД, чтобы начать загрузку и создать ваше устройство.

Устройства с поддержкой функций edge, подключенные к вашему узлу IoT, перечислены на странице "Устройства" вашего узла IoT. Если у вас несколько устройств, можно отфильтровать список, выбрав тип устройств Iot Edge , а затем нажмите кнопку "Применить".

Когда вы будете готовы настроить устройство, вам потребуется строка подключения, которая связывает физическое устройство с его удостоверением в центре Интернета Вещей. Для устройств, которые проходят проверку подлинности с симметричными ключами, строки подключения доступны для копирования на портале. Чтобы найти строку подключения на портале, выполните следующие действия.

1. На странице Devices выберите идентификатор устройства IoT Edge из списка.
2. Скопируйте значение в поле Основная строка подключения или Дополнительная строка подключения. Оба ключа работают.

В разделе Центр Интернета вещей Azure обозревателя Visual Studio Code перечислены все устройства, подключающиеся к центру Интернета вещей. Устройства IoT Edge имеют другой значок, поэтому их можно легко отличить от не Edge устройств. Вы увидите, что модули $edgeAgent и $edgeHub развертываются на каждом устройстве IoT Edge.

Когда вы будете готовы настроить устройство, вам потребуется строка подключения, которая связывает физическое устройство с его удостоверением в центре Интернета Вещей. Вот как получить строку подключения из Visual Studio Code:

1. Щелкните правой кнопкой мыши идентификатор (имя) устройства в разделе Центр Интернета вещей Azure.
2. Выберите Копировать строку подключения устройства. Connection string копируется в буфер обмена.

Вы также можете выбрать Get Device Info в контекстном меню правой кнопкой мыши, чтобы просмотреть все сведения об устройстве, включая строка подключения, в окне вывода.

Чтобы просмотреть все устройства в Центре Интернета вещей, используйте az iot hub device-identity list команду. Замените hub_name_here собственным именем Центра Интернета вещей:

az iot hub device-identity list --hub-name hub_name_here

Любое устройство, зарегистрированное в качестве устройства IoT Edge, имеет свойство capabilities.iotEdge имеет значение true. Вы также можете увидеть много других метаданных в виде выходных данных JSON, включая идентификаторы устройств.

Когда вы будете готовы настроить устройство, вам потребуется его строка подключения, которая связывает физическое устройство с его удостоверением в Центре IoT. Используйте следующую команду az iot hub device-identity connection-string show, чтобы вернуть строка подключения для одного устройства. Замените [device_id] и [hub_name] собственными значениями. Значение параметра device-identity чувствительно к регистру.

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Выходные данные JSON должны отображаться в консоли, как показано в следующем примере:

{
  "connectionString": "HostName=[hub_name].azure-devices.net;DeviceId=[device_id];SharedAccessKey=[device_key]"
}

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

Вы можете установить IoT Edge с помощью нескольких команд. Откройте терминал и выполните следующие команды:

• 24.04:

  wget https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  sudo dpkg -i packages-microsoft-prod.deb
  rm packages-microsoft-prod.deb
  

• 22.04:

  wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  sudo dpkg -i packages-microsoft-prod.deb
  rm packages-microsoft-prod.deb
  

Его можно установить с помощью APT и выполнить несколько команд. Откройте терминал и выполните следующие команды:

• 12 - Книжный червь (arm32v7):

  curl https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
  sudo apt install ./packages-microsoft-prod.deb
  

• 11 - Bullseye (arm32v7):

  curl https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
  sudo apt install ./packages-microsoft-prod.deb
  

Вы можете установить IoT Edge с помощью нескольких команд. Откройте терминал и выполните следующие команды:

• 9.x (amd64):

    wget https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
    sudo yum localinstall packages-microsoft-prod.rpm
    rm packages-microsoft-prod.rpm
  

• 8.x (amd64):

    wget https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
    sudo yum localinstall packages-microsoft-prod.rpm
    rm packages-microsoft-prod.rpm
  

Вы устанавливаете исполняемую среду IoT Edge из Snap Store на последующих шагах. Переходите к следующему разделу.

Установите движок Moby.

sudo apt-get update; \
  sudo apt-get install moby-engine

Установите движок Moby.

sudo apt-get update; \
  sudo apt-get install moby-engine

Установите модуль Moby и CLI.

sudo yum install moby-engine moby-cli

curl -ssl https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
chmod +x check-config.sh
./check-config.sh

IoT Edge имеет зависимости от Docker и Службы удостоверений Интернета вещей. Установите зависимости с помощью следующих команд:

sudo snap install docker
sudo snap install azure-iot-identity

Snap Docker обслуживается Canonical и поддерживается для производственных сценариев.

1. Создайте или измените существующий файл конфигурации управляющей программы Docker:

   sudo nano /etc/docker/daemon.json
   

2. Задайте драйвер ведения журнала по умолчанию драйверу local ведения журнала, как показано в примере:

      {
         "log-driver": "local"
      }
   

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

   sudo systemctl restart docker
   

В настоящее время оснастка Docker не поддерживает настройку драйвера ведения журнала local.

Установите последнюю версию IoT Edge и пакет службы идентификации IoT (если вы еще не обновились до последней версии):

• 22.04:

  sudo apt-get update; \
     sudo apt-get install aziot-edge
  

Установите последнюю версию IoT Edge и пакет службы идентификации IoT (если вы еще не обновились до последней версии):

sudo apt-get update; \
  sudo apt-get install aziot-edge

Установите последнюю версию IoT Edge и пакет службы идентификации IoT (если вы еще не обновились до последней версии):

sudo yum install aziot-edge

Установите IoT Edge из Snap Store.

sudo snap install azure-iot-edge

Подключение снап-пакетов

По умолчанию привязки являются свободными от зависимостей, ненадежными и строго ограничены. Поэтому после установки необходимо подключить snaps к другим snaps и к системным ресурсам. Используйте следующие команды для подключения службы идентификации Интернета вещей и IoT Edge snap пакетов друг к другу и системным ресурсам. Чтобы приступить к работе, вручную подключите снапсы. Для производственных развертываний их можно настроить, чтобы они автоматически подключались, что поможет уменьшить нагрузку на подготовку.

#------------------------
#  IoT Identity Service
#------------------------

# Connect the Identity Service snap to the logging system
# and grant permission to query system info

sudo snap connect azure-iot-identity:log-observe
sudo snap connect azure-iot-identity:mount-observe
sudo snap connect azure-iot-identity:system-observe
sudo snap connect azure-iot-identity:hostname-control

# If using a TPM, enable TPM access

sudo snap connect azure-iot-identity:tpm

#------------
#  IoT Edge
#------------

# Connect to your /home directory to enable writing support bundles

sudo snap connect azure-iot-edge:home

# Connect to logging and grant permission to query system info

sudo snap connect azure-iot-edge:log-observe
sudo snap connect azure-iot-edge:mount-observe
sudo snap connect azure-iot-edge:system-observe
sudo snap connect azure-iot-edge:hostname-control
# Allow IoT Edge to connect to the /var/run/iotedge folder and use sockets

sudo snap connect azure-iot-edge:run-iotedge

# Connect IoT Edge to Docker

sudo snap connect azure-iot-edge:docker docker:docker-daemon

Вы можете настроить устройство IoT Edge с проверкой подлинности симметричного ключа с помощью следующей команды:

sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'

1. Примените изменения конфигурации.

   sudo iotedge config apply
   

2. Чтобы просмотреть файл конфигурации, его можно открыть:

   sudo nano /etc/aziot/config.toml
   

1. Создайте файл config.toml в домашнем каталоге и настройте устройство IoT Edge с аутентификацией с использованием симметричного ключа для snap.

   sudo nano ~/config.toml
   

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

   [provisioning]
   source = "manual"
   connection_string = "REPLACE_WITH_DEVICE_CONNECTION_STRING"
   

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

3. Задайте конфигурацию для IoT Edge и службы удостоверений с помощью следующей команды:

   sudo snap set azure-iot-edge raw-config="$(cat ~/config.toml)"
   

sudo apt-get autoremove --purge aziot-edge

Оставьте флаг --purge, если планируется переустановить IoT Edge и использовать те же сведения о конфигурации в будущем. Флаг --purge удаляет все файлы, связанные с IoT Edge, включая файлы конфигурации.

sudo yum remove aziot-edge

Удалите среду выполнения IoT Edge:

sudo snap remove azure-iot-edge

Удалите службу удостоверений Azure:

sudo snap remove azure-iot-identity

sudo apt-get autoremove --purge moby-engine

sudo yum remove moby-cli
sudo yum remove moby-engine

sudo snap remove docker