Gérer les configurations de ressources à distance

Important

Opérations Azure IoT (préversion) – activé parc Azure Arc est actuellement en PRÉVERSION. Vous ne devez pas utiliser ce logiciel en préversion dans des environnements de production.

Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

Une ressource dans Opérations Azure IoT (préversion) est une entité logique que vous créez pour représenter une ressource réelle. Une ressource Opérations Azure IoT peut avoir des propriétés, des balises et des événements qui décrivent son comportement et ses caractéristiques.

Les serveurs OPC UA sont des applications logicielles qui communiquent avec des ressources. Les serveurs OPC UA exposent des balises OPC UA qui représentent des points de données. Les balises OPC UA fournissent des données en temps réel ou un historique sur l’état, les performances, la qualité ou la condition des ressources.

Un point de terminaison de ressource est une ressource personnalisée dans votre cluster Kubernetes qui connecte des serveurs OPC UA à des modules de connecteur OPC UA. Cette connexion permet à un connexion OPC UA d’accéder aux points de données d’une ressource. Sans point de terminaison de ressource, les données ne peuvent pas être acheminées d’un serveur OPC UA vers une instance Azure IoT OPC UA Broker (préversion) et une instance Azure IoT MQ (préversion). Après la configuration des ressources personnalisées dans votre cluster, une connexion est établie vers le serveur OPC UA en aval et le serveur transfère la télémétrie vers l’instance Broker OPC UA.

Un site est une collection d’instances d’Opérations Azure IoT. Les sites vous aident à organiser vos instances et à gérer le contrôle d’accès. Votre administrateur informatique crée des sites, leur attribue des instances et leur accorde l’accès aux utilisateurs de OT de votre organisation.

Dans le portail Opérations Azure IoT (préversion), une instance représente un cluster Opérations Azure IoT. Une instance peut avoir un ou plusieurs points de terminaison de ressources.

Cet article explique comment utiliser le portail Opérations Azure IoT (préversion) et Azure CLI pour effectuer ce qui suit :

• Définissez les points de terminaison de ressources qui connectent les ressources à votre instance Azure IoT Operations.
• Ajoutez des ressources et définissez leurs étiquettes et événements pour activer le flux de données des serveurs OPC UA vers le répartiteur Azure IoT MQ.

Ces ressources, étiquettes et événements mappent des données entrantes provenant de serveurs OPC UA à des noms conviviaux que vous pouvez utiliser dans le répartiteur MQ et des pipelines Processeur de données Azure IoT (préversion).

Prérequis

Pour configurer un point de terminaison de ressource, vous devez exécuter une instance d’Opérations Azure IoT.

Connexion

Portail Opérations Azure IoT

Pour vous connecter au portail Opérations Azure IoT (préversion), accédez au portail Opérations Azure IoT (préversion) dans votre navigateur, puis connectez-vous en utilisant vos informations d’identification Microsoft Entra ID.

Sélectionner votre site

Une fois connecté, le portail affiche la liste des sites auxquels vous avez accès. Chaque site est une collection d’instances Opérations Azure IoT où vous pouvez configurer vos ressources. Votre administrateur informatique est chargé d’organiser des instances dans des sites et d’accorder l’accès aux utilisateurs OT de votre organisation. Les instances qui ne font pas partie d’un site apparaissent dans le nœud Instances non attribuées. Sélectionnez le site que vous souhaitez utiliser :

Conseil

Vous pouvez utiliser la zone de filtre pour rechercher des sites.

Si vous ne voyez aucun site, il est possible que vous ne soyez pas dans le tenant Azure Active Directory approprié. Vous pouvez modifier le tenant à partir du menu supérieur droit dans le portail. Si vous ne voyez toujours pas de site, cela signifie que vous n’avez pas encore été ajouté à l’un d’entre eux. Contactez votre administrateur informatique pour demander l’accès.

Sélectionner votre instance

Une fois que vous avez sélectionné un site, le portail affiche la liste des instances Opérations Azure IoT qui font partie du site. Sélectionnez l’instance que vous souhaitez utiliser :

Conseil

Vous pouvez utiliser la zone de filtre pour rechercher des instances.

Azure CLI

Avant d’utiliser les commandes az iot ops asset, connectez-vous à l’abonnement qui contient votre déploiement Opérations Azure IoT :

az login

Créer un point de terminaison de ressource

Par défaut, un déploiement Opérations Azure IoT inclut un simulateur OPC PLC intégré. Pour créer un point de terminaison de ressource qui utiliser le simulateur OPC PLC intégré :

Portail Opérations Azure IoT

1. Sélectionnez Points de terminaison de ressource, puis Créer un point de terminaison de ressource :

   

   Conseil

   Vous pouvez utiliser la zone de filtre pour rechercher des points de terminaison de ressources.

2. Entrez les informations de point de terminaison suivantes :

   Champ	Valeur
   Nom	opc-ua-connector-0
   URL d’OPC UA Broker	opc.tcp://opcplc-000000:50000
   Authentification utilisateur	Anonymous
   Authentification de transport	Do not use transport authentication certificate

3. Pour enregistrer la définition, sélectionnez Créer.

Azure CLI

Exécutez la commande suivante :

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} 

Conseil

Utilisez az connectedk8s list pour répertorier les clusters auquel vous avez accès.

Pour en savoir plus, consultez point de terminaison de ressources Opérations Azure IoT.

Cette configuration déploie une nouvelle ressource assetendpointprofile appelée opc-ua-connector-0 vers le cluster. Après votre définition d’une ressource, un pod de connecteur OPC UA le détecte. Le pod utilise un point de terminaison de ressource, que vous spécifiez dans la définition de ressource, pour se connecter à un serveur OPC UA.

Quand le simulateur OPC PLC s’exécute, les données s’acheminent du simulateur vers le connecteur, puis vers OPC UA Broker et enfin vers le broker MQ.

Configurer un point de terminaison de ressource pour utiliser un nom d’utilisateur et un mot de passe

L’exemple précédent utilise le mode d’authentification Anonymous. Ce mode ne nécessite pas de nom d’utilisateur ni de mot de passe.

Portail Opérations Azure IoT

Pour utiliser le mode d’authentification UsernamePassword, procédez comme suit :

1. Suivez les étapes de configuration de l’authentification utilisateur OPC UA avec nom d’utilisateur et mot de passe pour ajouter des secrets pour le nom d’utilisateur et le mot de passe dans Azure Key Vault, puis projetez-les dans le cluster Kubernetes.
2. Dans le portail Opérations Azure IoT (préversion), sélectionnez Nom d’utilisateur et mot de passe pour le champ Authentification utilisateur pour configurer le point de terminaison de ressource afin d’utiliser ces secrets. Entrez ensuite les valeurs suivantes pour les champs Référence du nom d’utilisateur et Référence du mot de passe :

Champ	Value
Référence du nom d’utilisateur	aio-opc-ua-broker-user-authentication/username
Référence du mot de passe	aio-opc-ua-broker-user-authentication/password

Azure CLI

Pour utiliser le mode d’authentification UsernamePassword, procédez comme suit :

1. Suivez les étapes de configuration de l’authentification utilisateur OPC UA avec nom d’utilisateur et mot de passe pour ajouter des secrets pour le nom d’utilisateur et le mot de passe dans Azure Key Vault, puis projetez-les dans le cluster Kubernetes.

2. Utilisez une commande comme l’exemple suivant pour créer votre point de terminaison de ressource :

   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"
   

Configurer un point de terminaison de ressource pour utiliser un certificat d’authentification de transport

Pour configurer le point de terminaison de ressource pour utiliser un certificat d’authentification de transport, procédez comme suit :

Portail Opérations Azure IoT

1. Suivez les étapes de configuration de l’approbation mutuelle pour ajouter un certificat de transport et une clé privée à Azure Key Vault, puis projetez-les dans un cluster Kubernetes.
2. Dans le portail Opérations Azure IoT (préversion), sélectionnez Utiliser le certificat d’authentification de transport pour le champ Authentification de transport et entrez l’empreinte numérique du certificat.

Azure CLI

1. Suivez les étapes de configuration de l’approbation mutuelle pour ajouter un certificat de transport et une clé privée à Azure Key Vault, puis projetez-les dans un cluster Kubernetes.

2. Utilisez une commande comme l’exemple suivant pour créer votre point de terminaison de ressource :

   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"
   

Pour en savoir plus, consultez ressource Opérations Azure IoT.

Ajouter une ressource, des balises et des événements

Portail Opérations Azure IoT

Pour ajouter une ressource dans le portail Opérations Azure IoT (préversion) :

1. Sélectionnez l'onglet Ressources . Avant de créer des ressources, l’écran suivant s’affiche :

   

   Conseil

   Vous pouvez utiliser la zone de filtre pour rechercher des ressources.

   Sélectionnez Créer une ressource.

2. Sur l’écran des détails de la ressource, entrez les informations suivantes sur la ressource :

   • Nom de l’actif
   • Point de terminaison de ressource. Sélectionnez le point de terminaison de votre ressource à partir de la liste.
   • Description

   

3. Configurez l’ensemble de propriétés que vous souhaitez associer à la ressource. Vous pouvez accepter la liste par défaut des propriétés ou ajouter vos propres propriétés. Les propriétés suivantes sont disponibles par défaut :

   • Fabricant
   • URI de fabricant
   • Modèle
   • Code du produit
   • Version du matériel
   • Version du logiciel
   • Numéro de série
   • URI de la documentation

4. Sélectionnez Suivant pour accéder à la page Ajouter des balises.

Ajouter des balises individuelles à une ressource

Vous pouvez maintenant définir les balises associées à la ressource. Pour ajouter des balises OPC UA :

1. Sélectionnez Ajouter une balise ou un fichier CSV > Ajouter une balise.

2. Entrez les détails de votre balise :

   • ID de nœud. Cette valeur représente l’ID de nœud du serveur OPC UA.
   • Nom de balise (facultatif). Cette valeur est le nom convivial que vous souhaitez utiliser pour la balise. Si vous ne spécifiez aucun nom de balise, l’ID de nœud est utilisé comme nom de balise.
   • Mode d’observabilité (facultatif) avec les choix suivants :
     • Aucun(e)
     • Jauge
     • Compteur
     • Histogramme
     • Journal
   • Fréquence d’échantillonnage (millisecondes). Vous pouvez remplacer la valeur par défaut pour cette balise.
   • Taille de file d’attente. Vous pouvez remplacer la valeur par défaut pour cette balise.

   

   Le tableau suivant montre des exemples de valeurs de balise que vous pouvez utiliser avec le simulateur OPC PLC intégré :

   ID de nœud	Nom de la balise	Mode d’observabilité
   ns=3;s=FastUInt10	température	aucun(e)
   ns=3;s=FastUInt100	Balise 10	aucun(e)

3. Sélectionnez Gérer les paramètres par défaut pour configurer les paramètres de télémétrie par défaut de la ressource. Ces paramètres s’appliquent à toutes les balises OPC UA qui appartiennent à la ressource. Vous pouvez remplacer ces paramètres pour chaque balise que vous ajoutez. Les paramètres de télémétrie par défaut incluent :

   • Intervalle d’échantillonnage (millisecondes) : l’intervalle d’échantillonnage indique le taux le plus rapide auquel le serveur OPC UA doit échantillonner sa source sous-jacente pour les modifications de données.
   • Intervalle de publication (millisecondes) : le taux auquel le serveur OPC UA doit publier des données.
   • Taille de file d’attente : la profondeur de la file d’attente permettant de conserver les données d’échantillonnage avant leur publication.

Ajouter des balises en bloc à une ressource

Vous pouvez importer jusqu’à 1 000 balises OPC UA à la fois à partir d’un fichier CSV :

1. Créez un fichier CSV qui ressemble à l’exemple suivant :

   NodeID	TagName	Millisecondes de l’intervalle d’échantillonnage	QueueSize	ObservabilityMode
   ns=3;s=FastUInt1000	Balise 1000	1000	5	aucun(e)
   ns=3;s=FastUInt1001	Balise 1001	1000	5	aucun(e)
   ns=3;s=FastUInt1002	Balise 1002	5 000	10	Aucune

2. Sélectionnez Ajouter une balise ou un fichier CSV > Importer un fichier CSV (.csv). Sélectionnez le fichier CSV que vous avez créé, puis Ouvrir. Les balises définies dans le fichier CSV sont importées :

   

   Si vous importez un fichier CSV contenant des balises qui sont des doubles de balises existantes, le portail Opérations Azure IoT (préversion) affiche le message suivant :

   

   Vous pouvez remplacer les balises en double et ajouter de nouvelles balises à partir du fichier d’importation ou vous pouvez annuler l’importation.

3. Pour exporter toutes les balises à partir d’une ressource vers un fichier CSV, sélectionnez Exporter tout, puis choisissez un emplacement pour le fichier :

   

4. Sur la page Balises, sélectionnez Suivant pour accéder à la page Ajouter des événements.

Conseil

Vous pouvez utiliser la zone de filtre pour rechercher des balises.

Azure CLI

Utilisez la commande suivante pour ajouter une ressource « thermostat » à l’aide d’Azure CLI. La commande ajoute deux balises à la ressource à l’aide du paramètre --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'

Lorsque vous créez une ressource à l’aide d’Azure CLI, vous pouvez définir :

• Plusieurs balises en utilisant plusieurs fois le paramètre --data.
• Plusieurs événements en utilisant plusieurs fois le paramètre --event.
• Informations facultatives pour la ressource, telles que :
  • Fabricant
  • URI de fabricant
  • Modèle
  • Code du produit
  • Version du matériel
  • Version du logiciel
  • Numéro de série
  • URI de la documentation
• Valeurs par défaut pour l’intervalle d’échantillonnage, l’intervalle de publication et la taille de file d’attente.
• Valeurs spécifiques de balise pour l’intervalle d’échantillonnage, l’intervalle de publication et la taille de file d’attente.
• Valeurs spécifiques d’événements pour l’intervalle de publication d’échantillonnage et la taille de la file d’attente.
• Mode d’observabilité pour chaque balise et événement

Ajouter des événements individuels à une ressource

Portail Opérations Azure IoT

Vous pouvez maintenant définir les événements associés à la ressource. Pour ajouter des événements OPC UA :

1. Sélectionnez Ajouter un événement ou un fichier CSV > Ajouter un événement.

2. Entrez les détails de votre événement :

   • Notificateur d’événement. Cette valeur représente le notificateur d’événement du serveur OPC UA.
   • Name d’événement (facultatif). Cette valeur est le nom convivial que vous souhaitez utiliser pour l’événement. Si vous ne spécifiez aucun nom, le notificateur d’événement est utilisé comme nom d’événement.
   • Mode d’observabilité (facultatif) avec les choix suivants :
     • Aucun(e)
     • Jauge
     • Compteur
     • Histogramme
     • Journal
   • Taille de file d’attente. Vous pouvez remplacer la valeur par défaut pour cette balise.

   

3. Sélectionnez Gérer les paramètres par défaut pour configurer les paramètres d’événement par défaut de la ressource. Ces paramètres s’appliquent à tous les événements OPC UA qui appartiennent à la ressource. Vous pouvez remplacer ces paramètres pour chaque événement que vous ajoutez. Les paramètres d’événement par défaut incluent :

   • Intervalle de publication (millisecondes) : le taux auquel le serveur OPC UA doit publier des données.
   • Taille de file d’attente : la profondeur de la file d’attente permettant de conserver les données d’échantillonnage avant leur publication.

Ajouter des événements en bloc à une ressource

Vous pouvez importer jusqu’à 1 000 événements OPC UA à la fois à partir d’un fichier CSV.

Pour exporter tous les événements à partir d’une ressource vers un fichier CSV, sélectionnez Exporter tout, puis choisissez un emplacement pour le fichier.

Sur la page Événements, sélectionnez Suivant pour accéder à la page Vérifier.

Conseil

Vous pouvez utiliser la zone de filtre pour rechercher des événements.

Vérifier vos modifications

Passez en revue votre ressource et les détails d’événement et de balise OPC UA et apportez les ajustements nécessaires :

Azure CLI

Lorsque vous créez une ressource à l’aide d’Azure CLI, vous pouvez définir plusieurs événements en utilisant plusieurs fois le paramètre --event. La syntaxe du paramètre --event est similaire à celle du paramètre --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

Pour chaque événement que vous définissez, vous pouvez spécifier les éléments suivants :

• Notificateur d’événement. Cette valeur représente le notificateur d’événement du serveur OPC UA.
• Nom de l’événement. Cette valeur est le nom convivial que vous souhaitez utiliser pour l’événement. Si vous ne spécifiez aucun nom, le notificateur d’événement est utilisé comme nom d’événement.
• Mode d’observabilité.
• Taille de file d’attente.

Mise à jour d’une ressource

Portail Opérations Azure IoT

Recherchez et sélectionnez la ressource que vous avez créée précédemment. Utilisez les onglets Détails de la ressource, Balises et Événements pour apporter des modifications :

Sous l’onglet Balises, vous pouvez ajouter des balises, mettre à jour des balises existantes ou supprimer des balises.

Pour mettre à jour une balise, sélectionnez une balise existante et mettez à jour les informations sur la balise. Sélectionnez ensuite Mettre à jour :

Pour supprimer des balises, sélectionnez une ou plusieurs balises, puis Supprimer des balises :

Vous pouvez également ajouter, mettre à jour et supprimer des événements et des propriétés de la même manière.

Une fois les modifications apportées terminées, sélectionnez Enregistrer pour enregistrer vos modifications.

Azure CLI

Pour répertorier vos ressources, utilisez la commande suivante :

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

Conseil

Vous pouvez affiner la commande de requête pour rechercher des ressources qui correspondent à des critères spécifiques. Par exemple, vous pouvez rechercher des ressources par fabricant.

Pour afficher les détails de la ressource thermostat, utilisez la commande suivante :

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

Pour mettre à jour une ressource, utilisez la commande az iot ops asset update. Par exemple, pour mettre à jour la description de la ressource, utilisez une commande semblable à l’exemple suivant :

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

Pour répertorier les balises de la ressource thermostat, utilisez la commande suivante :

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

Pour répertorier les événements de la ressource thermostat, utilisez la commande suivante :

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

Pour ajouter une nouvelle balise à la ressource thermostat, utilisez une commande semblable à l’exemple suivant :

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

Pour supprimer une balise, utilisez la commande az iot ops asset data-point remove.

Vous pouvez gérer les événements d’une ressource à l’aide des commandes az iot ops asset event.

Supprimer un élément multimédia

Portail Opérations Azure IoT

Pour supprimer une ressource, sélectionnez la ressource à supprimer. Dans la page des détails de la Ressource, sélectionnez Supprimer. Confirmez vos modifications pour supprimer la ressource :

Azure CLI

Pour supprimer une ressource, utilisez une commande qui ressemble à l’exemple suivant :

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

Notifications

Lorsque vous apportez une modification à une ressource dans le portail Opérations Azure IoT (préversion), une notification s’affiche qui signale l’état de l’opération :

Contenu connexe

• Vue d’ensemble d’Azure OPC UA Broker
• Vue d’ensemble d’Azure IoT Akri
• ressource Opérations Azure IoT
• point de terminaison de ressource Opérations Azure IoT