Gérez les principaux points de terminaison des appareils - AWS IoT Greengrass
Utiliser le détecteur IP pour gérer automatiquement les points de terminaisonGérer manuellement les points de terminaison

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gérez les principaux points de terminaison des appareils

Lorsque vous utilisez la découverte du cloud, vous stockez les points de terminaison du broker MQTT pour les appareils principaux dans le service AWS IoT Greengrass cloud. Les appareils clients se connectent AWS IoT Greengrass pour récupérer ces points de terminaison et d'autres informations relatives à leurs périphériques principaux associés.

Pour chaque appareil principal, vous pouvez gérer les points de terminaison automatiquement ou manuellement.

  • Gérez automatiquement les points de terminaison avec le détecteur d'adresses IP

    Vous pouvez déployer le composant de détection IP pour gérer automatiquement les points de terminaison des appareils principaux à votre place si votre configuration réseau n'est pas complexe, par exemple si les appareils clients se trouvent sur le même réseau que le périphérique principal. Vous ne pouvez pas utiliser le composant de détection IP si le périphérique principal se trouve derrière un routeur qui transmet le port du broker MQTT au périphérique principal, par exemple.

    Le composant de détection IP est également utile si vous déployez dans des groupes d'objets, car il gère les points de terminaison de tous les appareils principaux du groupe d'objets. Pour plus d’informations, consultez Utiliser le détecteur IP pour gérer automatiquement les points de terminaison.

  • Gérer manuellement les points de terminaison

    Si vous ne pouvez pas utiliser le composant de détection IP, vous devez gérer manuellement les principaux points de terminaison de l'appareil. Vous pouvez mettre à jour ces points de terminaison à l'aide de la console ou de l'API. Pour plus d’informations, consultez Gérer manuellement les points de terminaison.

Utiliser le détecteur IP pour gérer automatiquement les points de terminaison

Si vous disposez d'une configuration réseau simple, telle que les appareils clients sur le même réseau que le périphérique principal, vous pouvez déployer le composant de détection IP pour effectuer les opérations suivantes :

  • Surveillez les informations de connectivité au réseau local de l'appareil central Greengrass. Ces informations incluent les points de terminaison réseau du périphérique principal et le port sur lequel fonctionne le broker MQTT.

  • Signalez les informations de connectivité de l'appareil principal au service AWS IoT Greengrass cloud.

Le composant du détecteur IP remplace les points de terminaison que vous avez définis manuellement.

Important

La AWS IoT politique de l'appareil principal doit greengrass:UpdateConnectivityInfo autoriser l'utilisation du composant de détection IP. Pour plus d’informations, consultez Stratégies AWS IoT pour les opérations de plan de données et Configuration de la AWS IoT politique des objets.

Vous pouvez effectuer l'une des opérations suivantes pour déployer le composant de détection IP :

  1. Dans le menu de navigation de la AWS IoT Greengrassconsole, sélectionnez Composants.

  2. Sur la page Composants, choisissez l'onglet Composants publics, puis sélectionnez aws.greengrass.clientdevices.IPDetector.

  3. Sur la page aws.greengrass.clientdevices.IPDetector, choisissez Deploy (Déployer).

  4. Dans Ajouter au déploiement, choisissez un déploiement existant à réviser ou choisissez de créer un nouveau déploiement, puis choisissez Suivant.

  5. Si vous avez choisi de créer un nouveau déploiement, choisissez le périphérique principal ou le groupe d'objets cible pour le déploiement. Sur la page Spécifier la cible, sous Cible de déploiement, choisissez un périphérique principal ou un groupe d'objets, puis cliquez sur Suivant.

  6. Sur la page Sélectionner les composants, vérifiez que le aws.greengrass.clientdevices.IPDetectorcomposant est sélectionné, puis choisissez Next.

  7. Sur la page Configurer les composants, sélectionnez aws.greengrass.clientdevices.IPDetector, puis effectuez les opérations suivantes :

    1. Choisissez Configure component (Configurer un composant).

    2. Dans le aws.greengrass.clientdevices.IPDetector mode Configurer, sous Mise à jour de la configuration, dans Configuration à fusionner, vous pouvez saisir une mise à jour de configuration pour configurer le composant du détecteur IP. Vous pouvez définir l'une des options de configuration suivantes :

      • defaultPort— (Facultatif) Le port du broker MQTT à signaler lorsque ce composant détecte des adresses IP. Vous devez spécifier ce paramètre si vous configurez le broker MQTT pour utiliser un port différent du port par défaut 8883.

      • includeIPv4LoopbackAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de boucle IPv4. Il s'agit d'adresses IP, par exemplelocalhost, où un appareil peut communiquer avec lui-même. Utilisez cette option dans les environnements de test dans lesquels le périphérique principal et le périphérique client s'exécutent sur le même système.

      • includeIPv4LinkLocalAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses locales de liens IPv4. Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole DHCP (Dynamic Host Configuration Protocol) ou d'adresses IP attribuées de manière statique.

      La mise à jour de configuration peut ressembler à l'exemple suivant.

      {
  "defaultPort": "8883",
  "includeIPv4LoopbackAddrs": false,
  "includeIPv4LinkLocalAddrs": false
}

    3. Choisissez Confirmer pour fermer le modal, puis cliquez sur Suivant.

  8. Sur la page Configure advanced settings (Configurer les paramètres avancés), conservez les paramètres de configuration par défaut et choisissez Next (Suivant).

  9. Sur la page Review (Révision), choisissez Deploy (Déployer).

    Le déploiement peut prendre jusqu'à une minute.

Pour déployer le composant du détecteur IP, créez un document de déploiement qui inclut aws.greengrass.clientdevices.IPDetector l'componentsobjet et spécifiez la mise à jour de configuration du composant. Suivez les instructions Créer des déploiements pour créer un nouveau déploiement ou modifier un déploiement existant.

Vous pouvez spécifier l'une des options suivantes pour configurer le composant du détecteur IP lorsque vous créez le document de déploiement :

  • defaultPort— (Facultatif) Le port du broker MQTT à signaler lorsque ce composant détecte des adresses IP. Vous devez spécifier ce paramètre si vous configurez le broker MQTT pour utiliser un port différent du port par défaut 8883.

  • includeIPv4LoopbackAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de boucle IPv4. Il s'agit d'adresses IP, par exemplelocalhost, où un appareil peut communiquer avec lui-même. Utilisez cette option dans les environnements de test dans lesquels le périphérique principal et le périphérique client s'exécutent sur le même système.

  • includeIPv4LinkLocalAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses locales de liens IPv4. Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole DHCP (Dynamic Host Configuration Protocol) ou d'adresses IP attribuées de manière statique.

L'exemple de document de déploiement partiel suivant indique de signaler le port 8883 comme port du broker MQTT.

{
  ...,
  "components": {
    ...,
    "aws.greengrass.clientdevices.IPDetector": {
      "componentVersion": "2.1.1",
      "configurationUpdate": {
        "merge": "{\"defaultPort\":\"8883\",}"
      }
    }
  }
}

Gérer manuellement les points de terminaison

Vous pouvez gérer manuellement les points de terminaison du broker MQTT pour les appareils principaux.

Chaque point de terminaison du broker MQTT possède les informations suivantes :

Point de terminaison (HostAddress)

Adresse IP ou adresse DNS à laquelle les appareils clients peuvent se connecter à un courtier MQTT sur le périphérique principal.

Port (PortNumber)

Port sur lequel le broker MQTT fonctionne sur le périphérique principal.

Vous pouvez configurer ce port sur le composant du broker Moquette MQTT, qui utilise par défaut le port 8883.

Métadonnées (Metadata)

Métadonnées supplémentaires à fournir aux appareils clients qui se connectent à ce point de terminaison.

Gérer les points de terminaison (console)

Vous pouvez utiliser la AWS IoT Greengrass console pour afficher, mettre à jour et supprimer les points de terminaison d'un appareil principal.

Pour gérer les points de terminaison d'un appareil principal (console)

  1. Choisissez les appareils Core.

  2. Choisissez l'appareil principal à gérer.

  3. Sur la page de détails de l'appareil principal, choisissez l'onglet Appareils clients.

  4. Dans la section Points de terminaison du broker MQTT, vous pouvez voir les points de terminaison du broker MQTT du périphérique principal. Choisissez Gérer les points de terminaison.

  5. Dans le mode Gérer les points de terminaison, ajoutez ou supprimez des points de terminaison du broker MQTT pour le périphérique principal.

  6. Choisissez Mettre à jour.

Gérer les points de terminaison () AWS CLI

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour gérer les points de terminaison d'un appareil principal.

Note

La prise en charge des appareils clients AWS IoT Greengrass V2 étant rétrocompatible avecAWS IoT Greengrass V1, vous pouvez utiliser les opérations AWS IoT Greengrass V2 d'AWS IoT Greengrass V1API pour gérer les principaux points de terminaison des appareils.

Pour obtenir des points de terminaison pour un appareil principal () AWS CLI
Pour mettre à jour les points de terminaison d'un appareil principal () AWS CLI

Gérer les points de terminaison (API)

Vous pouvez utiliser l'AWSAPI pour gérer les points de terminaison d'un appareil principal.

Note

La prise en charge des appareils clients AWS IoT Greengrass V2 étant rétrocompatible avecAWS IoT Greengrass V1, vous pouvez utiliser les opérations AWS IoT Greengrass V2 d'AWS IoT Greengrass V1API pour gérer les principaux points de terminaison des appareils.

Pour obtenir des points de terminaison pour un appareil principal (AWSAPI)
Pour mettre à jour les points de terminaison d'un appareil principal (AWSAPI)