Déployer le module Cache connecté Microsoft sur une seule passerelle (préversion)

Le module Cache connecté Microsoft (MCC) pour les passerelles IoT Edge active Device Update pour les appareils déconnectés derrière la passerelle. Cet article présente deux configurations différentes pour le déploiement du module MCC sur une passerelle IoT Edge.

Si plusieurs passerelles IoT Edge sont chaînées, consultez les instructions fournies dans Déployer le module Cache connecté Microsoft sur des passerelles imbriquées.

Notes

Ces informations concernent une fonctionnalité d’aperçu disponible pour les tests précoces et l’utilisation dans un environnement de production. Cette fonctionnalité est entièrement prise en charge, mais elle est toujours en développement actif et peut recevoir des modifications substantielles jusqu’à ce qu’elle devienne généralement disponible.

Déployer sur une passerelle sans proxy

Le diagramme suivant décrit le scénario où une passerelle Azure IoT Edge a un accès direct aux ressources du réseau de distribution de contenu (CDN) ainsi que le module Cache connecté Microsoft déployé. Derrière la passerelle, il y a un appareil de nœud terminal IoT, de type Raspberry PI, qui est un appareil enfant de la passerelle IoT Edge isolé d’Internet.

Les étapes suivantes illustrent la configuration des variables d’environnement MCC pour se connecter directement au CDN sans proxy :

1. Ajoutez le module Cache connecté Microsoft à votre déploiement d’appareil de passerelle Azure IoT Edge dans Azure IoT Hub (consultez Prise en charge des appareils déconnectés pour plus d’informations sur l’obtention du module).

2. Ajoutez les variables d’environnement pour le déploiement. Le tableau suivant illustre les variables d’environnement :

   Nom	Valeur
   CACHE_NODE_ID	Voir les descriptions de la variable d’environnement
   CUSTOMER_ID	Voir les descriptions de la variable d’environnement
   CUSTOMER_KEY	Voir les descriptions de la variable d’environnement
   STORAGE_1_SIZE_GB	10

3. Ajoutez les options de création de conteneur pour le déploiement. Par exemple :

   {
       "HostConfig": {
           "Binds": [
               "/MicrosoftConnectedCache1/:/nginx/cache1/"
           ],
           "PortBindings": {
               "8081/tcp": [
                   {
                       "HostPort": "80"
                   }
               ],
               "5000/tcp": [
                   {
                       "HostPort": "5100"
                   }
               ]
           }
       }
   }
   

Pour une validation du bon fonctionnement du cache connecté Microsoft, exécutez la commande suivante dans le terminal de l’appareil IoT Edge hébergeant le module ou sur n’importe quel appareil sur le réseau. Remplacez <ID de passerelle Azure IoT Edge> par l’adresse IP ou le nom d’hôte de votre passerelle IoT Edge. Pour plus d’informations sur la visibilité de ce rapport, consultez Rapport de synthèse du Cache connecté Microsoft.

wget http://<IoT Edge Gateway IP>/mscomtest/wuidt.gif?cacheHostOrigin=au.download.windowsupdate.com

Déployer sur une passerelle avec un proxy sortant non authentifié

Dans ce scénario, une passerelle Azure IoT Edge a accès aux ressources du réseau de distribution de contenu (CDN) à travers un proxy sortant non authentifié. Le Cache connecté Microsoft est configuré pour mettre en cache le contenu d’un dépôt personnalisé et le rapport de synthèse est visible pour tous les utilisateurs du réseau.

Les étapes suivantes illustrent la configuration des variables d’environnement MCC pour prendre en charge un proxy sortant non authentifié :

1. Ajoutez le module Cache connecté Microsoft à votre déploiement d’appareil de passerelle Azure IoT Edge dans Azure IoT Hub.

2. Ajoutez les variables d’environnement pour le déploiement. Voici un exemple des variables d’environnement.

   Nom	Valeur
   CACHE_NODE_ID	Voir les descriptions de la variable d’environnement
   CUSTOMER_ID	Voir les descriptions de la variable d’environnement
   CUSTOMER_KEY	Voir les descriptions de la variable d’environnement
   STORAGE_1_SIZE_GB	10
   CACHEABLE_CUSTOM_1_HOST	Packagerepo.com:80
   CACHEABLE_CUSTOM_1_CANONICAL	Packagerepo.com
   IS_SUMMARY_ACCESS_UNRESTRICTED	true
   UPSTREAM_PROXY	IP ou FQDN de votre serveur proxy

3. Ajoutez les options de création de conteneur pour le déploiement. Par exemple :

   {
       "HostConfig": {
           "Binds": [
               "/MicrosoftConnectedCache1/:/nginx/cache1/"
           ],
           "PortBindings": {
               "8081/tcp": [
                   {
                       "HostPort": "80"
                   }
               ],
               "5000/tcp": [
                   {
                       "HostPort": "5100"
                   }
               ]
           }
       }
   }
   

Pour une validation du bon fonctionnement du cache connecté Microsoft, exécutez la commande suivante dans le terminal de l’appareil Azure IoT Edge hébergeant le module ou sur n’importe quel appareil dans le réseau. Remplacez <ID de passerelle Azure IoT Edge> par l’adresse IP ou le nom d’hôte de votre passerelle IoT Edge. Pour plus d’informations sur la visibilité de ce rapport, consultez Rapport de synthèse du Cache connecté Microsoft.

wget http://<Azure IoT Edge Gateway IP>/mscomtest/wuidt.gif?cacheHostOrigin=au.download.windowsupdate.com