Gérer le cycle de vie d’une instance Azure IoT Operations

Utilisez Azure CLI et le portail Azure pour gérer, désinstaller ou mettre à jour des instances Azure IoT Operations.

Prérequis

• Instance Azure IoT Operations déployée sur un cluster. Pour obtenir plus d’informations, consultez Déployer Opérations Azure IoT.

• Azure CLI installé sur votre ordinateur de développement. Ce scénario nécessite Azure CLI version 2.64.0 ou ultérieure. Utilisez az --version pour vérifier votre version et az upgrade pour effectuer une mise à jour si nécessaire. Si vous souhaitez en savoir plus, veuillez consulter la rubrique Installation de l’interface de ligne de commande Azure.

• Extension Opérations Azure IoT pour Azure CLI. Utilisez la commande suivante pour ajouter l’extension ou la mettre à jour vers la dernière version :

  az extension add --upgrade --name azure-iot-ops
  

Gérer

Après le déploiement, vous pouvez utiliser Azure CLI et le portail Azure pour afficher et gérer votre instance Opérations Azure IoT.

Instances de liste

Azure portal

1. Dans le portail Azure, recherchez et sélectionnez Opérations Azure IoT.
2. Utilisez les filtres pour afficher les instances d’Opérations Azure IoT en fonction de l’abonnement, du groupe de ressources, etc.

Azure CLI

Utilisez la commande az iot ops list pour afficher toutes les instances d’Opérations Azure IoT dans votre abonnement ou groupe de ressources.

La commande de base retourne toutes les instances dans votre abonnement.

az iot ops list

Pour filtrer les résultats par groupe de ressources, ajoutez le paramètre --resource-group.

az iot ops list --resource-group <RESOURCE_GROUP>

Afficher une instance

Azure portal

Vous pouvez afficher votre instance d’Opérations Azure IoT dans le portail Azure.

1. Dans le portail Azure, accédez au groupe de ressources qui contient votre instance d’Opérations Azure IoT, ou recherchez et sélectionnez Opérations Azure IoT.

2. Sélectionnez le nom de votre instance d’Opérations Azure IoT.

3. Dans la page Vue d’ensemble de votre instance, la table Extensions Arc affiche les ressources déployées sur votre cluster.

   

Azure CLI

Utilisez la commande az iot ops show pour afficher les propriétés d’une instance.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Vous pouvez également utiliser la commande az iot ops show pour afficher les ressources de votre déploiement Opérations Azure IoT dans Azure CLI. Ajoutez l’indicateur --tree pour afficher une arborescence du déploiement qui inclut l’instance d’Opérations Azure IoT spécifiée.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree

L’arborescence d’un déploiement ressemble à l’exemple suivant :

MyCluster
├── extensions
│   ├── akvsecretsprovider
│   ├── azure-iot-operations-ltwgs
│   └── azure-iot-operations-platform-ltwgs
└── customLocations
    └── MyCluster-cl
        ├── resourceSyncRules
        └── resources
            ├── MyCluster-ops-init-instance
            └── MyCluster-observability

Vous pouvez exécuter az iot ops check sur votre cluster pour évaluer l’intégrité et les configurations de chaque composant Opérations Azure IoT. Par défaut, la commande vérifie MQ, mais vous pouvez spécifier le service avec le paramètre --ops-service.

Mettre à jour les étiquettes et la description de l’instance

Azure portal

1. Dans le portail Azure, accédez au groupe de ressources qui contient votre instance d’Opérations Azure IoT, ou recherchez et sélectionnez Opérations Azure IoT.

2. Sélectionnez le nom de votre instance d’Opérations Azure IoT.

3. Dans la page Vue d’ensemble de votre instance, sélectionnez Ajouter des étiquettes ou Modifier pour modifier des étiquettes sur votre instance.

Azure CLI

Utilisez la commande az iot ops update pour modifier les paramètres d’étiquettes et de description de votre instance d’Opérations Azure IoT. Les valeurs fournies dans la commande update remplacent les étiquettes ou descriptions existantes.

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>

Pour supprimer toutes les étiquettes d’une instance, affectez une valeur Null au paramètre d’étiquettes. Par exemple :

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

Gérer les composants

Chaque instance Opérations Azure IoT comprend plusieurs composants, tels que l’Agent MQTT, le Connecteur OPC UA et les flux de données. Pour en savoir plus sur la gestion de ces composants, consultez leurs articles respectifs. Par exemple, pour gérer l’Agent MQTT, commencez par la Vue d’ensemble de l’Agent.

(Préversion) Gérer les composants à l’aide de manifestes de déploiement Kubernetes

En général, Opérations Azure IoT utilise la plateforme Azure Arc pour offrir une expérience cloud hybride dans laquelle vous pouvez gérer la configuration via Azure Resource Manager (ARM) et des outils front-end comme le Portail Azure, Bicep et Azure CLI.

Toutefois, vous pouvez également gérer les composants d’Opérations Azure IoT à l’aide de manifestes de déploiement Kubernetes YAML. Cela signifie que vous pouvez utiliser des outils tels que kubectl pour gérer certains composants d’Opérations Azure IoT. Cette fonctionnalité est en préversion et présente certaines limitations :

• Seuls certains composants prennent en charge l’utilisation de manifestes de déploiement Kubernetes. Ces composants sont l’Agent MQTT et lesflux de données. D’autres composants tels que le Connecteur OPC UA et le Service Akri ne prennent pas en charge cette fonctionnalité.
• Si Opérations Azure IoT n’est pas déployé avec la synchronisation des ressources activée à l’aide de az iot ops create --enable-rsync, les modifications apportées aux ressources à l’aide de manifestes de déploiement Kubernetes ne sont pas synchronisées avec Azure. Pour en savoir plus sur la synchronisation des ressources, consultez Synchronisation des ressources.
• Même si la synchronisation des ressources est activée, les nouvelles ressources créées à l’aide de manifestes de déploiement Kubernetes ne sont pas synchronisées avec Azure. Seules les modifications apportées aux ressources existantes sont synchronisées.

Désinstaller

Azure CLI et le portail Azure offrent différentes options pour désinstaller Opérations Azure IoT.

Les étapes du portail Azure peuvent supprimer une instance Azure IoT Operations, mais elles ne peuvent pas affecter les ressources associées dans le déploiement. Si vous souhaitez supprimer l’intégralité du déploiement, utilisez Azure CLI.

Azure portal

1. Dans le portail Azure, accédez au groupe de ressources qui contient votre instance d’Opérations Azure IoT, ou recherchez et sélectionnez Opérations Azure IoT.

2. Sélectionnez le nom de votre instance d’Opérations Azure IoT.

3. Dans la page Vue d’ensemble de votre instance, sélectionnez Supprimer.

4. Passez en revue la liste des ressources qui ne sont pas supprimées dans le cadre de cette opération, puis tapez le nom de votre instance et sélectionnez Supprimer pour confirmer.

   

Azure CLI

Utilisez la commande az iot ops delete pour supprimer le déploiement entier d’Opérations Azure IoT d’un cluster. La commande delete évalue les ressources liées à Opérations Azure IoT sur le cluster et présente une arborescence des ressources à supprimer. Le cluster doit être en ligne lorsque vous exécutez cette commande.

La commande delete simplifie le redéploiement des opérations Azure IoT sur le même cluster. Il annule la commande create afin que vous puissiez exécuter à nouveau create, delete, create et ainsi de suite sans avoir à réexécuter init.

La commande delete supprime :

• L’instance d’Opérations Azure IoT.
• Les extensions Arc
• Localisations personnalisées
• Les règles de synchronisation des ressources
• Les ressources que vous pouvez configurer dans votre solution Opérations Azure IoT, comme les actifs, le répartiteur MQTT et les flux de données

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Pour supprimer l’instance et supprimer également les dépendances Azure IoT Operations (résultat de init), ajoutez l’indicateur --include-deps.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps