Удаленное управление конфигурациями ресурсов

Внимание

Предварительная версия операций Интернета вещей Azure, включенная Azure Arc в настоящее время находится в предварительной версии. Не следует использовать это программное обеспечение предварительной версии в рабочих средах.

Юридические условия, применимые к функциям Azure, которые находятся в состоянии бета-версии, предварительной версии или иным образом еще не выпущены в общедоступной версии, см. на странице Дополнительные условия использования предварительных версий в Microsoft Azure.

Ресурс в Azure IoT Operations Preview — это логическая сущность, созданная для представления реального ресурса. Ресурс Операций Интернета вещей Azure может иметь свойства, теги и события, описывающие его поведение и характеристики.

Серверы OPC UA — это программные приложения, взаимодействующие с ресурсами. Серверы OPC UA предоставляют теги OPC UA, представляющие точки данных. Теги OPC UA предоставляют данные в режиме реального времени или исторические данные о состоянии, производительности, качестве или состоянии активов.

Конечная точка ресурса — это пользовательский ресурс в кластере Kubernetes, который подключает серверы OPC UA к модулям соединителя OPC UA. Это подключение позволяет соединителю OPC UA получить доступ к точкам данных ресурса. Без конечной точки ресурса данные не могут передаваться с сервера OPC UA к экземпляру предварительной версии брокера OPC UA Azure и экземпляру Предварительной версии Azure IoT MQ. После настройки пользовательских ресурсов в кластере устанавливается подключение к нижнему серверу OPC UA, а сервер перенаправит данные телеметрии в экземпляр брокера OPC UA.

Сайт — это семейство экземпляров Операций Интернета вещей Azure. Сайты помогают упорядочивать экземпляры и управлять доступом. ИТ-администратор создает сайты, назначает экземпляры и предоставляет пользователям OT в организации доступ.

На портале Операций Интернета вещей Azure (предварительная версия) экземпляр представляет кластер операций Интернета вещей Azure. Экземпляр может иметь одну или несколько конечных точек ресурса.

В этой статье описывается, как использовать портал Операций Интернета вещей Azure (предварительная версия) и Azure CLI для:

• Определение конечных точек ресурса
• Добавление ресурсов и определение тегов и событий

Эти ресурсы, теги и события сопоставляют входящие данные с серверов OPC UA с понятными именами, которые можно использовать в конвейерах предварительной версии брокера MQ и обработчика данных Интернета вещей Azure.

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

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

Вход

Портал операций Интернета вещей Azure

Чтобы войти на портал Операций Интернета вещей Azure (предварительная версия), перейдите на портал Операций Интернета вещей Azure (предварительная версия) в браузере и войдите с помощью учетных данных идентификатора Microsoft Entra.

Выбор сайта

После входа на портале отображается список сайтов, к которым у вас есть доступ. Каждый сайт — это семейство экземпляров операций Интернета вещей Azure, где можно настроить ресурсы. ИТ-администратор отвечает за организацию экземпляров на сайтах и предоставление доступа пользователям OT в организации. Экземпляры, которые не являются частью сайта, отображаются в узле неназначенных экземпляров . Выберите сайт, который вы хотите использовать:

Совет

Поле фильтра можно использовать для поиска сайтов.

Если вы не видите никаких сайтов, возможно, вы не будете в правильном клиенте Azure Active Directory. Вы можете изменить клиент в правом верхнем меню на портале. Если вы по-прежнему не видите ни одного сайта, что означает, что вы еще не добавлены. Обратитесь к ИТ-администратору, чтобы запросить доступ.

Выбор экземпляра

После выбора сайта на портале отображается список экземпляров операций Интернета вещей Azure, которые являются частью сайта. Выберите экземпляр, который вы хотите использовать:

Совет

Поле фильтра можно использовать для поиска экземпляров.

Azure CLI

Перед использованием az iot ops asset команд войдите в подписку, содержащую развертывание Операций Интернета вещей Azure:

az login

Создание конечной точки ресурса

По умолчанию развертывание Операций Интернета вещей Azure включает встроенный симулятор OPC PLC. Чтобы создать конечную точку ресурса, использующую встроенный симулятор OPC PLC:

Портал операций Интернета вещей Azure

1. Выберите конечные точки ресурса и создайте конечную точку ресурса:

   

   Совет

   Поле фильтра можно использовать для поиска конечных точек ресурсов.

2. Введите следующие сведения о конечной точке:

   Поле	Значение
   Имя.	opc-ua-connector-0
   URL-адрес брокера OPC UA	opc.tcp://opcplc-000000:50000
   Проверка подлинности пользователя	Anonymous
   Проверка подлинности транспорта	Do not use transport authentication certificate

3. Чтобы сохранить определение, нажмите кнопку "Создать".

Azure CLI

Выполните следующую команду:

az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} 

Совет

Используйте az connectedk8s list для перечисления кластеров, к которых у вас есть доступ.

Дополнительные сведения см. в статье az iot ops asset endpoint.

Эта конфигурация развертывает новый assetendpointprofile ресурс, вызываемого opc-ua-connector-0 в кластере. После определения ресурса модуль pod соединителя OPC UA обнаруживает его. Модуль pod использует конечную точку ресурса, указанную в определении ресурса, для подключения к серверу OPC UA.

При запуске симулятора OPC PLC данные передаются из симулятора в соединитель, брокер OPC UA и, наконец, к брокеру MQ.

Настройка конечной точки ресурса для использования имени пользователя и пароля

В предыдущем примере используется Anonymous режим проверки подлинности. В этом режиме не требуется имя пользователя или пароль.

Портал операций Интернета вещей Azure

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

1. Выполните действия, описанные в статье "Настройка проверки подлинности пользователя OPC UA с именем пользователя и паролем ", чтобы добавить секреты для имени пользователя и пароля в Azure Key Vault и проецировать их в кластер Kubernetes.
2. На портале Операций Интернета вещей Azure (предварительная версия) выберите имя пользователя и пароль для поля проверки подлинности пользователя, чтобы настроить конечную точку ресурса для использования этих секретов. Затем введите следующие значения для полей ссылки на имя пользователя и ссылок на пароль:

Поле	значение
Справочник по имени пользователя	aio-opc-ua-broker-user-authentication/username
Справочник по паролям	aio-opc-ua-broker-user-authentication/password

Azure CLI

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

1. Выполните действия, описанные в статье "Настройка проверки подлинности пользователя OPC UA с именем пользователя и паролем ", чтобы добавить секреты для имени пользователя и пароля в Azure Key Vault и проецировать их в кластер Kubernetes.

2. Используйте следующую команду, чтобы создать конечную точку ресурса:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Настройка конечной точки ресурса для использования сертификата проверки подлинности транспорта

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

Портал операций Интернета вещей Azure

1. Выполните действия, описанные в настройке взаимного доверия , чтобы добавить сертификат транспорта и закрытый ключ в Azure Key Vault и проецировать их в кластер Kubernetes.
2. На портале Операций Интернета вещей Azure (предварительная версия) выберите "Использовать сертификат проверки подлинности транспорта" для поля проверки подлинности транспорта и введите отпечаток сертификата.

Azure CLI

1. Выполните действия, описанные в настройке взаимного доверия , чтобы добавить сертификат транспорта и закрытый ключ в Azure Key Vault и проецировать их в кластер Kubernetes.

2. Используйте следующую команду, чтобы создать конечную точку ресурса:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Дополнительные сведения см . в ресурсе az iot ops.

Добавление ресурса, тегов и событий

Портал операций Интернета вещей Azure

Чтобы добавить ресурс на портале Операций Интернета вещей Azure (предварительная версия), выполните следующие действия.

1. Перейдите на вкладку "Активы ". Перед созданием ресурсов вы увидите следующий экран:

   

   Совет

   Поле фильтра можно использовать для поиска ресурсов.

   Выберите " Создать ресурс".

2. На экране сведений о активе введите следующие сведения о ресурсах:

   • Имя ресурса
   • Конечная точка ресурса. Выберите конечную точку ресурса из списка.
   • Description

   

3. Настройте набор свойств, которые необходимо связать с ресурсом. Вы можете принять список свойств по умолчанию или добавить собственный. По умолчанию доступны следующие свойства:

   • Производитель
   • Универсальный код ресурса (URI) производителя
   • Модель
   • Код продукта
   • Версия оборудования
   • Версия ПО
   • Серийный номер
   • URI документации

4. Нажмите кнопку "Далее", чтобы перейти на страницу "Добавить теги".

Добавление отдельных тегов в ресурс

Теперь можно определить теги, связанные с ресурсом. Чтобы добавить теги OPC UA, выполните приведенные действия.

1. Выберите "Добавить тег" или "Добавить тег CSV>".

2. Введите сведения о теге:

   • Идентификатор узла. Это значение является идентификатором узла с сервера OPC UA.
   • Имя тега (необязательно). Это понятное имя, которое вы хотите использовать для тега. Если имя тега не указано, идентификатор узла используется в качестве имени тега.
   • Режим наблюдаемости (необязательно) со следующими вариантами:
     • нет
     • Показатели
     • Счетчик
     • Гистограмма
     • Журнал
   • Интервал выборки (миллисекунда). Можно переопределить значение по умолчанию для этого тега.
   • Размер очереди. Можно переопределить значение по умолчанию для этого тега.

   

   В следующей таблице показаны некоторые примеры значений тегов, которые можно использовать с встроенным симулятором OPC PLC:

   Идентификатор узла	Имя тега	Режим наблюдаемости
   ns=3; s=FastUInt10	Температура	ничего
   ns=3; s=FastUInt100	Тег 10	ничего

3. Выберите " Управление параметрами по умолчанию", чтобы настроить параметры телеметрии по умолчанию для ресурса. Эти параметры применяются ко всем тегам OPC UA, принадлежащим ресурсу. Эти параметры можно переопределить для каждого добавляемого тега. Параметры телеметрии по умолчанию:

   • Интервал выборки (миллисекунда) — интервал выборки указывает самую быструю скорость, с которой сервер OPC UA должен образцировать базовый источник для изменений данных.
   • Интервал публикации (миллисекунда) — скорость публикации данных сервера OPC UA.
   • Размер очереди: глубина очереди для хранения данных выборки перед публикацией.

Массовое добавление тегов в ресурс

Вы можете импортировать до 1000 тегов OPC UA за раз из CSV-файла:

1. Создайте CSV-файл, который выглядит следующим образом:

   NodeID	TagName	Интервал выборки в миллисекундах	QueueSize	ObservabilityMode
   ns=3; s=FastUInt1000	Тег 1000	1000	5	ничего
   ns=3; s=FastUInt1001	Тег 1001	1000	5	ничего
   ns=3; s=FastUInt1002	Тег 1002	5000	10	ничего

2. Выберите "Добавить тег" или CSV-файл импорта CSV > (.csv). Выберите созданный CSV-файл и нажмите кнопку "Открыть". Теги, определенные в CSV-файле, импортируются:

   

   При импорте CSV-файла, содержащего теги, дублирующие существующие теги, на портале Операций Интернета вещей Azure (предварительная версия) отображается следующее сообщение:

   

   Вы можете заменить повторяющиеся теги и добавить новые теги из файла импорта или отменить импорт.

3. Чтобы экспортировать все теги из ресурса в CSV-файл, выберите "Экспортировать все " и выберите расположение для файла:

   

4. На странице "Теги" нажмите кнопку "Далее", чтобы перейти на страницу "Добавить события".

Совет

Поле фильтра можно использовать для поиска тегов.

Azure CLI

Используйте следующую команду, чтобы добавить ресурс термостата с помощью Azure CLI. Команда добавляет два тега в ресурс с помощью --data параметра:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --data  data_source='ns=3;s=FastUInt10', name=temperature --data data_source='ns=3;s=FastUInt100', name='Tag 10'

При создании ресурса с помощью Azure CLI можно определить следующее:

• Несколько тегов с помощью --data параметра несколько раз.
• Несколько событий с помощью --event параметра несколько раз.
• Необязательные сведения для ресурса, например:
  • Производитель
  • Универсальный код ресурса (URI) производителя
  • Модель
  • Код продукта
  • Версия оборудования
  • Версия ПО
  • Серийный номер
  • URI документации
• Значения по умолчанию для интервала выборки, интервала публикации и размера очереди.
• Пометьте определенные значения для интервала выборки, интервала публикации и размера очереди.
• Конкретные значения событий для интервала публикации выборки и размера очереди.
• Режим наблюдаемости для каждого тега и события

Добавление отдельных событий в ресурс

Портал операций Интернета вещей Azure

Теперь можно определить события, связанные с ресурсом. Чтобы добавить события OPC UA, выполните действия:

1. Выберите "Добавить событие" или "Добавить CSV>".

2. Введите сведения о событии:

   • Уведомление о событии. Это значение является уведомлением о событии с сервера OPC UA.
   • Имя события (необязательно). Это понятное имя, которое вы хотите использовать для события. Если имя события не указано, то в качестве имени события используется уведомление о событии.
   • Режим наблюдаемости (необязательно) со следующими вариантами:
     • нет
     • Показатели
     • Счетчик
     • Гистограмма
     • Журнал
   • Размер очереди. Можно переопределить значение по умолчанию для этого тега.

   

3. Выберите " Управление параметрами по умолчанию" , чтобы настроить параметры событий по умолчанию для ресурса. Эти параметры применяются ко всем событиям OPC UA, принадлежащим ресурсу. Эти параметры можно переопределить для каждого добавляемого события. Параметры событий по умолчанию:

   • Интервал публикации (миллисекунда) — скорость публикации данных сервера OPC UA.
   • Размер очереди: глубина очереди для хранения данных выборки перед публикацией.

Массовое добавление событий в ресурс

Вы можете импортировать до 1000 событий OPC UA за раз из CSV-файла.

Чтобы экспортировать все события из ресурса в CSV-файл, выберите "Экспорт всех " и выберите расположение для файла.

На странице "События" нажмите кнопку "Далее", чтобы перейти на страницу "Рецензирование".

Совет

Поле фильтра можно использовать для поиска событий.

Просмотр изменений

Просмотрите тег ресурса и тег OPC UA и сведения о событии и внесите необходимые изменения:

Azure CLI

При создании ресурса с помощью Azure CLI можно определить несколько событий с помощью --event параметра несколько раз. Синтаксис параметра --event аналогичен параметру --data :

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

Для каждого определяемого события можно указать следующее:

• Уведомление о событии. Это значение является уведомлением о событии с сервера OPC UA.
• Имя события. Это понятное имя, которое вы хотите использовать для события. Если имя события не указано, то в качестве имени события используется уведомление о событии.
• Режим наблюдаемости.
• Размер очереди.

Обновление ресурса

Портал операций Интернета вещей Azure

Найдите и выберите созданный ранее ресурс. Используйте вкладки "Сведения о ресурсах", "Теги" и "События", чтобы внести изменения:

На вкладке "Теги" можно добавлять теги, обновлять существующие теги или удалять теги.

Чтобы обновить тег, выберите существующий тег и обновите сведения о теге. Затем нажмите кнопку "Обновить":

Чтобы удалить теги, выберите один или несколько тегов и нажмите кнопку "Удалить теги":

Вы также можете добавлять, обновлять и удалять события и свойства таким же образом.

Завершив внесение изменений, нажмите кнопку "Сохранить ", чтобы сохранить изменения.

Azure CLI

Чтобы вывести список ресурсов, используйте следующую команду:

az iot ops asset query -g {your resource group name}

Совет

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

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

az iot ops asset show --name thermostat -g {your resource group}

Чтобы обновить ресурс, используйте az iot ops asset update команду. Например, чтобы обновить описание ресурса, используйте следующую команду:

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

Чтобы получить список тегов актива термостата, используйте следующую команду:

az iot ops asset data-point list --asset thermostat -g {your resource group}

Чтобы перечислить события актива термостата, используйте следующую команду:

az iot ops asset event list --asset thermostat -g {your resource group}

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

az iot ops asset data-point add --asset thermostat -g {your resource group} --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

Чтобы удалить тег, используйте az iot ops asset data-point remove команду.

События ресурса можно управлять с помощью az iot ops asset event команд.

Удаление актива

Портал операций Интернета вещей Azure

Чтобы удалить ресурс, выберите ресурс, который требуется удалить. На странице сведений о ресурсе нажмите кнопку "Удалить". Подтвердите изменения, чтобы удалить ресурс:

Azure CLI

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

az iot ops asset delete --name thermostat -g {your resource group name}

Notifications

При внесении изменений в ресурс на портале Операций Интернета вещей Azure (предварительная версия) вы увидите уведомление, которое сообщает о состоянии операции:

Связанный контент

• Общие сведения о брокере AZURE OPC UA
• Общие сведения об Azure IoT AKRI
• az iot ops asset
• az iot ops asset endpoint