Учебник. Настройка среды для работы с краткими руководствами и учебниками по IoT Plug and Play
Перед началом работы с краткими руководствами и учебниками по IoT Plug and Play необходимо настроить центр Интернета вещей и Службу подготовки устройств (DPS) в подписке Azure. Кроме того, вам понадобятся локальные копии файлов модели, используемых в примерах приложений, и обозреватель Интернета вещей Azure.
Внимание
В этой статье содержатся шаги по подключению к службе с помощью подписанного URL-адреса. Этот метод проверки подлинности удобнее для тестирования и оценки, но проверка подлинности в службе с помощью идентификатора Microsoft Entra или управляемых удостоверений является более безопасным подходом. Дополнительные сведения см. в статье "Рекомендации > по безопасности cloud security".
Необходимые компоненты
Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.
Подготовка среды к работе с Azure CLI
Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.
Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.
Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.
Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.
Создание ресурсов
Создайте группу ресурсов Azure для ресурсов:
az group create --name my-pnp-resourcegroup --location centralus
Создайте Центр Интернета вещей. Следующая команда использует имя my-pnp-hub в качестве примера имени создаваемого центра Интернета вещей. Выберите уникальное имя центра Интернета вещей, которое будет использоваться вместо my-pnp-hub:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Создайте экземпляр DPS. Следующая команда использует имя my-pnp-dps в качестве примера имени создаваемого экземпляра DPS. Выберите уникальное имя экземпляра DPS, которое будет использоваться вместо my-pnp-dps:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Чтобы связать экземпляр DPS с центром Интернета вещей, используйте следующие команды. Замените my-pnp-dps и my-pnp-hub уникальными именами, которые вы выбрали ранее:
hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString
Получение параметров
В некоторых кратких руководствах и учебниках используется строка подключения для центра Интернета вещей. Кроме того, строка подключения требуется при настройке обозревателя Интернета вещей Azure. Получите строку подключения и запишите ее. Замените my-pnp-hub уникальным именем своего центра Интернета вещей:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
В большинстве кратких руководств и учебников используется область идентификаторов конфигурации DPS. Получите область идентификаторов и запишите ее. Замените my-pnp-dps уникальным именем своего экземпляра DPS:
az iot dps show --name my-pnp-dps --query properties.idScope
Во всех кратких руководствах и учебниках используется регистрация устройств DPS. Используйте следующую команду, чтобы создать регистрацию отдельных устройств my-pnp-device в экземпляре DPS. Замените my-pnp-dps уникальным именем своего экземпляра DPS. Запишите значения идентификатора регистрации и первичного ключа для использования в кратких руководствах и учебниках:
az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'
Создание переменной среды
Создайте пять переменных среды, чтобы настроить примеры для кратких руководств и учебников. Так вы сможете использовать Службу подготовки устройств (DPS) для подключения к центру Интернета вещей:
- IOTHUB_DEVICE_SECURITY_TYPE: значение
DPS; - IOTHUB_DEVICE_DPS_ID_SCOPE: область идентификатора DPS, которую вы записали ранее;
- IOTHUB_DEVICE_DPS_DEVICE_ID: значение
my-pnp-device; - IOTHUB_DEVICE_DPS_DEVICE_KEY: первичный ключ регистрации, который вы записали ранее;
- IOTHUB_DEVICE_DPS_ENDPOINT: значение
global.azure-devices-provisioning.net.
Примерам службы требуются следующие переменные среды, чтобы определить центр и устройство для подключения:
- IOTHUB_CONNECTION_STRING: строка подключения центра Интернета вещей, которую вы записали ранее.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Например, в оболочке командной системы Linux Bash:
export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"
Например, в командной строке Windows:
set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device
Скачивание файлов модели
В кратких руководствах и учебниках используются примеры файлов модели для контроллера температуры и устройств термостата. Чтобы скачать примеры файлов модели, сделайте следующее:
Создайте на локальном компьютере папку models.
Щелкните правой кнопкой мыши TemperatureController.json и сохраните этот JSON-файл в папку models.
Щелкните правой кнопкой мыши Thermostat.json и сохраните этот JSON-файл в папку models.
Установка обозревателя Azure IoT
В кратких руководствах и учебниках используется обозреватель Интернета вещей Azure. Перейдите к выпускам обозревателя Интернета вещей Azure и разверните список ресурсов для самого последнего выпуска. Скачайте и установите последнюю версию приложения для вашей операционной системы.
При первом запуске средства вам будет предложено ввести строку подключения центра Интернета вещей. Используйте строку подключения, которую вы записали ранее.
Настройте средство для использования файлов модели, которые вы скачали ранее. На домашней странице в средстве выберите "Параметры" самонастраивающийся Интернета вещей, а затем + Добавить > локальную папку. Выберите папку models, которую вы создали ранее. Затем щелкните Save (Сохранить), чтобы сохранить параметры.
Дополнительные сведения см. в статье Установка и использование обозревателя Интернета вещей Azure.
Очистка ресурсов
Вы можете использовать центр Интернета вещей и экземпляр DPS для всех кратких руководств и учебников по IoT Plug and Play — вам нужно только выполнить действия, описанные в этой статье. По завершении работы ресурсы можно удалить из подписки с помощью следующей команды:
az group delete --name my-pnp-resourcegroup
Следующие шаги
Теперь, когда вы настроили среду, вы можете обратиться к одному из кратких руководств или учебников, например: