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

Important

Opérations Azure IoT Préversion avec Azure Arc est actuellement en préversion. Vous ne devez pas utiliser ce logiciel en préversion dans des environnements de production.

Vous devez déployer une nouvelle installation d’Opérations Azure IoT quand une version en disponibilité générale devient disponible. Vous ne pourrez pas mettre à niveau une installation en préversion.

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.

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 ""

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

Mettre à jour

Dans la préversion publique, Opérations Azure IoT prend en charge la mise à niveau des instances de la version 0.7.x vers la version 0.8.x.

Vous devez déployer une nouvelle installation d’Opérations Azure IoT quand une version en disponibilité générale est publiée. Vous ne pourrez pas effectuer de mise à niveau à partir d’une installation en préversion.

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 Mettre à niveau.

4. L’Assistant de la mise à niveau d’Opérations Azure IoT vous invite à vous assurer que vous disposez de la dernière version de l’extension CLI d’Opérations Azure IoT. Copiez et exécutez la commande az extension add fournie.

5. Effectuez une mise à jour vers la dernière version de l’instance Opérations Azure IoT. Copiez et exécutez la commande az iot ops upgrade fournie.

6. Une fois la commande de mise à niveau terminée, vous pouvez quitter l’Assistant et actualiser votre page d’instance.

Azure CLI

Utilisez la commande az iot ops upgrade pour mettre à niveau un déploiement Opérations Azure IoT. Cette commande :

• Met à niveau les extensions Azure Arc sur votre cluster.
• Met à niveau l’instance Opérations Azure IoT.

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