Déployer des opérations de Azure IoT sur un cluster de test

Découvrez comment déployer Opérations Azure IoT sur un cluster de test, qui est un cluster Kubernetes avec Arc que vous pouvez utiliser pour les scénarios de test et d’évaluation.

Si vous souhaitez déployer Opérations Azure IoT sur un cluster de production, consultez Deploy Opérations Azure IoT sur un cluster de production.

Avant de commencer

Cet article décrit les Opérations Azure IoT déploiements et instances qui sont deux concepts différents :

• Un Opérations Azure IoT deployment décrit tous les composants et ressources qui activent le scénario de Opérations Azure IoT. Ces composants et ressources sont les suivants :

  • Instance de Opérations Azure IoT
  • Extensions Arc
  • Localisations personnalisées
  • Ressources que vous pouvez configurer dans votre solution de Opérations Azure IoT, telles que les ressources et les appareils.

• Une Opérations Azure IoT instance est la ressource parente qui regroupe la suite de services définis dans Quel est Opérations Azure IoT ? comme le répartiteur MQTT, les flux de données et le connecteur pour OPC UA.

Lorsque nous parlons de déploiement de Opérations Azure IoT, nous entendons l’ensemble complet des composants qui constituent un deployment. Une fois le déploiement effectué, vous pouvez afficher, gérer et mettre à jour l’instance.

Conditions préalables

Ressources cloud :

• Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez-en un gratuitement avant de commencer.

• Autorisations d’accès Azure. Pour plus d’informations, consultez Vue d’ensemble > des autorisations requises pour le déploiement.

Ressources de développement :

• La Azure CLI installée sur votre ordinateur de développement. Vérifiez les extensions Azure CLI disponibles pour connaître la version minimale requise afin d’utiliser l’extension azure-iot-ops. Utilisez az --version pour vérifier votre version et az upgrade pour effectuer une mise à jour si nécessaire. Pour plus d’informations, consultez la rubrique Installation de l’interface de ligne de commande Azure (CLI).

• Extension Opérations Azure IoT pour le 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
  

Un hôte de cluster :

• Disposer d’un cluster Kubernetes compatible Azure Arc avec les fonctionnalités personnalisées d’identité d’emplacement et de charge de travail activées. Si vous n'en avez pas, suivez les étapes décrites dans Prepare your Azure Arc-enabled Kubernetes cluster.

  Si vous avez déployé Opérations Azure IoT sur votre cluster précédemment, désinstallez ces ressources avant de continuer. Pour plus d’informations, consultez Update Opérations Azure IoT.

Cardinalité automatique

Pour déterminer automatiquement la cardinalité initiale pendant le déploiement, omettez le cardinality champ dans la ressource Broker. L’opérateur broker MQTT déploie le nombre approprié de pods en fonction du nombre de nœuds disponibles au moment du déploiement. Cette fonctionnalité est utile pour les scénarios hors production où vous n’avez pas besoin d’affiner la haute disponibilité ou les paramètres de mise à l’échelle.

Pour utiliser la cardinalité automatique, préparez un fichier de configuration Broker au format JSON qui omet le cardinality champ. Par exemple, définissez uniquement le profil de mémoire :

{
  "memoryProfile": "Medium"
}

Ensuite, déployez avec l’indicateur --broker-config-file (autres paramètres omis pour la concision) :

az iot ops create ... --broker-config-file <FILE>.json

Pour plus d’informations, consultez la prise en charge de la configuration avancée du répartiteur MQTT par Azure CLI.

Déployer dans le portail Azure

Basics

L’expérience de déploiement du portail Azure est un outil d’assistance qui génère une commande de déploiement basée sur vos ressources et configuration. La dernière étape consiste à exécuter une commande Azure CLI. Vous avez donc toujours besoin des prérequis Azure CLI décrits dans la section précédente.

1. Connectez-vous au portail Azure.

2. Dans la zone de recherche, recherchez et sélectionnez Opérations Azure IoT.

3. Cliquez sur Créer.

4. Sous l’onglet Informations de base , fournissez les informations suivantes :

   Paramètre	Valeur
   Abonnement	Sélectionnez l’abonnement qui contient votre cluster avec Arc.
   Groupe de ressources	Sélectionnez le groupe de ressources qui contient votre cluster avec Arc.
   Nom du cluster	Sélectionnez le cluster sur lequel vous souhaitez déployer Opérations Azure IoT.
   Nom de l’emplacement personnalisé	Facultatif : remplacez le nom par défaut de l’emplacement personnalisé.
   Version du déploiement	Sélectionnez la version 1.2 (la plus récente). Pour plus d’informations, consultez les versions des opérations IoT.
   Composants optionnels du déploiement > connecteur OPC UA	Choisissez de déployer le connecteur facultatif pour le composant OPC UA.

5. Sélectionnez Suivant : Configuration.

Configuration

1. Sous l’onglet Configuration , fournissez les informations suivantes :

   Paramètre	Valeur
   nom Opérations Azure IoT	Optional : remplacez le nom par défaut de l’instance de Opérations Azure IoT.
   Configuration du répartiteur MQTT	Facultatif : modifiez les paramètres par défaut du répartiteur MQTT. Dans Azure portail, il est possible de configurer cardinality et memory profile paramètres. Pour configurer d’autres paramètres, notamment la mémoire tampon de message sauvegardée sur disque et les options avancées du client MQTT, consultez Azure CLI prise en charge de la configuration avancée du répartiteur MQTT.
   Configuration du profil de flux de données	Facultatif : modifiez les paramètres par défaut pour les flux de données. Pour plus d’informations, consultez Configurer le profil de flux de données.

   capture d’écran

2. Sélectionnez Suivant : Gestion des dépendances.

Gestion des dépendances

1. Sous l’onglet Gestion des dépendances , sélectionnez un registre de schémas existant ou procédez comme suit pour en créer un :

   1. Sélectionnez Créer nouveau.

   2. Entrez un nom de Registre de schémas et un espace de noms de Registre de schémas.

   3. Sélectionnez Select stockage Azure conteneur.

   4. Choisissez un compte de stockage dans la liste des comptes avec espace de noms hiérarchiques, ou sélectionnez Créer pour en créer un.

      Le registre de schémas nécessite un compte stockage Azure avec un espace de noms hiérarchique et un accès réseau public activé. Lors de la création d’un compte de stockage, choisissez un type de compte de stockage à usage général v2 et définissez l’espace de noms hiérarchiquesur Activé.

      Pour plus d’informations sur la configuration de votre compte de stockage, consultez les instructions de déploiement de production.

   5. Sélectionnez un conteneur dans votre compte de stockage ou sélectionnez Conteneur pour en créer un.

   6. Sélectionnez Appliquer pour confirmer les configurations du Registre de schémas.

2. Opérations Azure IoT utilise namespaces pour organiser les ressources et les appareils. Chaque instance de Opérations Azure IoT utilise un espace de noms unique pour ses ressources et appareils. Sous l’onglet Dependency management, sélectionnez un espace de noms Azure Device Registry existant ou procédez comme suit pour en créer un :

   1. Sélectionnez Créer nouveau.

   2. Sous l’onglet Informations de base , fournissez les informations suivantes :

      Paramètre	Valeur
      Abonnement	Sélectionnez votre abonnement.
      Groupe de ressources	Sélectionnez le groupe de ressources qui contient votre instance de Opérations Azure IoT.
      Nom	Entrez un nom unique pour votre espace de noms.
      Region	Sélectionnez la région Azure pour stocker votre espace de noms.

      Sélectionnez Suivant pour continuer.

   3. Sous l’onglet Balises , vous pouvez éventuellement ajouter des balises à votre espace de noms. Sélectionnez Suivant pour continuer.

   4. Sous l’onglet Vérifier + créer , passez en revue vos configurations et sélectionnez Créer pour créer l’espace de noms.

   5. Retournez à l'onglet Gestion des dépendances, et sélectionnez l’espace de noms nouvellement créé dans la liste.

Options de déploiement

1. Sous l’onglet Gestion des dépendances, sélectionnez l’option de déploiement Paramètres de test. Cette option utilise les paramètres par défaut recommandés à des fins de test.

   capture d’écran

2. Sélectionnez Suivant : Automation.

Exécuter des commandes Azure CLI

La dernière étape de l’expérience de déploiement du portail Azure consiste à exécuter un ensemble de commandes Azure CLI pour déployer Opérations Azure IoT sur votre cluster. Le portail génère ces commandes en fonction des informations que vous fournissez dans les étapes précédentes.

Une à la fois, exécutez chaque commande Azure CLI sous l’onglet Automation dans un terminal :

1. Connectez-vous à Azure CLI de manière interactive avec un navigateur, même si vous vous êtes déjà connecté avant. Si vous ne vous connectez pas de manière interactive, vous risquez d’obtenir une erreur indiquant que votre appareil doit être géré pour accéder à votre ressource.

   az login
   

2. Installez la dernière extension CLI Opérations Azure IoT si ce n'est pas déjà fait.

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

3. Copiez et exécutez la commande az iot ops schema registry create pour créer un registre de schémas utilisé par Opérations Azure IoT composants. Si vous avez choisi d’utiliser un registre de schémas existant, cette commande n’est pas affichée sous l’onglet Automation .

4. Préparez le cluster pour le déploiement Opérations Azure IoT. Copiez et exécutez la commande init az iot ops fournie.

   Conseil / Astuce

   La commande init ne doit être exécutée qu’une seule fois par cluster. Si vous avez suivi la configuration facultative requise pour configurer votre propre émetteur d’autorité de certification, suivez les étapes décrites dans Apportez votre propre émetteur.

   L’exécution de cette commande peut prendre plusieurs minutes. Vous pouvez observer la progression grâce à l’affichage de la progression du déploiement dans le terminal.

5. Pour déployer Opérations Azure IoT, copiez et exécutez la commande az iot ops create fournie. L’exécution de cette commande peut prendre plusieurs minutes. Vous pouvez observer la progression grâce à l’affichage de la progression du déploiement dans le terminal.

6. Une fois toutes les commandes Azure CLI terminées, vous pouvez fermer l’Assistant Install Opérations Azure IoT.

Une fois la commande create terminée avec succès, vous disposez d’une instance de Opérations Azure IoT opérationnelle s’exécutant sur votre cluster. À ce stade, votre instance est configurée pour la plupart des scénarios de test et d’évaluation.

Vérifier le déploiement

Une fois le déploiement terminé, utilisez az iot ops check pour évaluer le déploiement du service IoT Operations pour l’intégrité, la configuration et la facilité d’utilisation. La check commande vous aide à trouver des problèmes dans votre déploiement et votre configuration.

az iot ops check

La check commande rapporte que les contrôles de flux de données sont sautés lorsqu’il n’y a pas encore de flux de données, ce qui est normal et attendu jusqu’à ce que vous créiez un flux de données. Pour plus d’informations, consultez Traiter et router des données avec des flux de données.

Pour vérifier les configurations des mappages de sujets, de la QoS et des routes de messages, ajoutez le paramètre --detail-level 2 à la commande check pour afficher une vue détaillée.

Pour afficher toutes les versions de l’extension CLI Opérations Azure IoT disponibles, exécutez la commande suivante :

az iot ops get-versions

Étapes suivantes

• Configurez l’observabilité pour configurer la surveillance et les tableaux de bord.
• L’instance Opérations Azure IoT que vous avez déployée est configurée pour les scénarios de test. Si vous souhaitez activer les paramètres sécurisés et préparer l’instance pour les scénarios de production, suivez les étapes décrites dans Activer les paramètres sécurisés sur une instance de Opérations Azure IoT existante.