Краткое руководство. Настройка службы подготовки устройств Центр Интернета вещей (DPS) с помощью Bicep

Статья
03/09/2023

Вы можете использовать Bicep-файл для программной настройки облачных ресурсов Azure, необходимых для подготовки устройств. В этих шагах показано, как создать Центр Интернета вещей и новый экземпляр службы подготовки устройств Центр Интернета вещей с помощью Bicep-файла. Центр Интернета вещей также связан с ресурсом DPS с помощью файла Bicep. Это связывание позволяет ресурсу DPS назначать устройства в центр по настроенным вами политикам распределения.

Bicep — это предметно-ориентированный язык (DSL), который использует декларативный синтаксис для развертывания ресурсов Azure. Он обеспечивает краткий синтаксис, надежную безопасность типов и поддержку повторного использования кода. Bicep предлагает лучшие возможности для разработки решений Azure типа "инфраструктура как код".

В этом кратком руководстве используется Azure PowerShell и Azure CLI для выполнения программных действий, необходимых для создания группы ресурсов и развертывания Bicep-файла, но вы можете легко использовать .NET, Ruby или другие языки программирования для выполнения этих действий и развертывания Bicep-файла.

Необходимые компоненты

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

Используйте среду 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 PowerShell локально:
- Установите последнюю версию модуля Az PowerShell.
- Подключитесь к учетной записи Azure с помощью командлета Connect-AzAccount.
Если вы решили использовать Azure Cloud Shell:
- Дополнительные сведения см. в статье Общие сведения об Azure Cloud Shell.

Проверка BICEP-файла

Файл Bicep, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска Azure.

Примечание.

В настоящее время нет поддержки файлов Bicep для создания регистраций с новыми ресурсами DPS. Наличие такой поддержки является востребованным и понятным, поэтому мы рассматриваем возможность ее добавления.

@description('Specify the name of the Iot hub.')
param iotHubName string

@description('Specify the name of the provisioning service.')
param provisioningServiceName string

@description('Specify the location of the resources.')
param location string = resourceGroup().location

@description('The SKU to use for the IoT Hub.')
param skuName string = 'S1'

@description('The number of IoT Hub units.')
param skuUnits int = 1

var iotHubKey = 'iothubowner'

resource iotHub 'Microsoft.Devices/IotHubs@2021-07-02' = {
  name: iotHubName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {}
}

resource provisioningService 'Microsoft.Devices/provisioningServices@2022-02-05' = {
  name: provisioningServiceName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {
    iotHubs: [
      {
        connectionString: 'HostName=${iotHub.properties.hostName};SharedAccessKeyName=${iotHubKey};SharedAccessKey=${iotHub.listkeys().value[0].primaryKey}'
        location: location
      }
    ]
  }
}

Два ресурса Azure определены в файле Bicep выше:

Microsoft.Devices/iothubs: создает новую Центр Интернета вещей Azure.
Microsoft.Devices/provisioningservices: создает новую службу подготовки устройств Центр Интернета вещей Azure с новым Центр Интернета вещей, который уже связан с ним.

Сохраните копию файла Bicep локально в качестве main.bicep.

Развертывание BICEP-файла

Войдите в учетную запись Azure и выберите подписку.

Войдите в Azure в командной строке:
- CLI
- PowerShell
```
az login
```
```
Connect-AzAccount
```
Следуйте инструкциям, чтобы выполнить аутентификацию с использованием кода и войти в учетную запись Azure через веб-браузер.
Если у вас есть несколько подписок Azure, то при выполнении входа в Azure вы получаете доступ ко всем учетным записям Azure, связанным с вашими учетными данными.
- CLI
- PowerShell
```
az account list -o table
```
```
Get-AzSubscription
```
Используйте следующую команду, чтобы выбрать подписку, которую вы хотите использовать для выполнения команд для создания ресурсов Центра Интернета вещей и DPS. Вы можете использовать имя подписки или идентификатор из выходных данных предыдущей команды:
- CLI
- PowerShell
```
az account set --subscription {your subscription name or id}
```
```
Set-AzContext -Subscription {your subscription name or id}
```
Разверните файл Bicep со следующими командами.
Совет

При выполнении команд вам будет предложено указать расположение группы ресурсов. Список доступных расположений можно получить, выполнив такую команду:
- CLI
- PowerShell
az account list-locations -o table

Get-AzLocation
- CLI
- PowerShell
```
az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters iotHubName={IoT-Hub-name} provisioningServiceName={DPS-name}
```
```
New-AzResourceGroup -Name exampleRG -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -iotHubName "{IoT-Hub-name}" -provisioningServiceName "{DPS-name}"
```
Замените {IoT-Hub-name} глобально уникальным именем Центр Интернета вещей, замените {DPS-name} глобально уникальным именем ресурса службы подготовки устройств (DPS).

Создание ресурсов занимает несколько секунд.

Просмотр развернутых ресурсов

Чтобы проверить развертывание, выполните следующую команду и найдите новую службу подготовки и Центр Интернета вещей в выходных данных:
- CLI
- PowerShell
```
 az resource list -g exampleRg
```
```
Get-AzResource -ResourceGroupName exampleRG
```
Чтобы убедиться, что концентратор уже связан с ресурсом DPS, выполните следующую команду.
- CLI
- PowerShell
```
az iot dps show --name <Your provisioningServiceName>
```
```
Get-AzIoTDeviceProvisioningService -ResourceGroupName exampleRG -Name "{DPS-name}"
```
Найдите здесь центры, которые связаны с элементом iotHubs.

Очистка ресурсов

Другие краткие руководства в этой коллекции созданы на основе этого документа. Если вы планируете продолжить работу с последующими краткими руководствами или руководствами, не убирайте ресурсы, созданные в этом кратком руководстве. Если вы не планируете продолжать работу, вы можете использовать Azure PowerShell или Azure CLI для удаления группы ресурсов и всех его ресурсов.

Чтобы удалить группу ресурсов и все его ресурсы из портал Azure, просто откройте группу ресурсов и выберите "Удалить группу ресурсов" и "Сверху".

Чтобы удалить развернутую группу ресурсов, выполните следующие действия.

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -name exampleRG

Вы также можете удалить группы ресурсов и отдельные ресурсы с помощью портал Azure, PowerShell или REST API или с поддерживаемыми пакетами SDK для платформы.

Следующие шаги

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

Краткое руководство. Подготовка имитированного устройства с использованием симметричных ключей

Поделиться через