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 le cloud discovery, vous stockez les points de terminaison des MQTT courtiers 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 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 MQTT broker 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 de plus amples informations, veuillez consulter 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 duAPI. Pour de plus amples informations, veuillez consulter 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é réseau locale de l'appareil central Greengrass. Ces informations incluent les points de terminaison réseau du périphérique principal et le port sur lequel opère le MQTT courtier.

  • 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 :

  • Utilisez la page Configurer la découverte de la console. Pour de plus amples informations, veuillez consulter Configuration de la découverte du cloud (console).

  • Créez et révisez les déploiements pour inclure le détecteur IP. Vous pouvez utiliser la console ou AWS API pour gérer les déploiements. AWS CLI Pour de plus amples informations, veuillez consulter Créer des déploiements.

  1. Dans le menu de navigation de la AWS IoT Greengrass console, 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 MQTT courtier à signaler lorsque ce composant détecte des adresses IP. Vous devez spécifier ce paramètre si vous configurez le MQTT broker 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 IPv4 boucle. 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 IPv4 locales liées aux liens. Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole Dynamic Host Configuration Protocol (DHCP) ou d'adresses IP attribuées de manière statique.

      • includeIPv6LoopbackAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de IPv6 boucle. 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. Vous devez includeIPv4Addrs définir sur false et includeIPv6Addrs sur true pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

      • includeIPv6LinkLocalAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses IPv6 locales liées aux liens. Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole Dynamic Host Configuration Protocol (DHCP) ou d'adresses IP attribuées de manière statique. Vous devez includeIPv4Addrs définir sur false et includeIPv6Addrs sur true pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

      • includeIPv4Addrs— (Facultatif) La valeur par défaut est définie sur true. Vous pouvez activer cette option pour publier IPv4 les adresses présentes sur l'appareil principal. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

      • includeIPv6Addrs— (Facultatif) Vous pouvez activer cette option pour publier IPv6 les adresses trouvées sur l'appareil principal. Réglez false sur includeIPv4Addrs pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

      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 MQTT courtier à signaler lorsque ce composant détecte des adresses IP. Vous devez spécifier ce paramètre si vous configurez le MQTT broker 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 IPv4 boucle. 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 IPv4 locales liées aux liens. Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole Dynamic Host Configuration Protocol (DHCP) ou d'adresses IP attribuées de manière statique.

  • includeIPv6LoopbackAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses de IPv6 boucle. 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. Vous devez includeIPv4Addrs définir sur false et includeIPv6Addrs sur true pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

  • includeIPv6LinkLocalAddrs— (Facultatif) Vous pouvez activer cette option pour détecter et signaler les adresses IPv6 locales liées aux liens. Utilisez cette option si le réseau du périphérique principal ne dispose pas du protocole Dynamic Host Configuration Protocol (DHCP) ou d'adresses IP attribuées de manière statique. Vous devez includeIPv4Addrs définir sur false et includeIPv6Addrs sur true pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

  • includeIPv4Addrs— (Facultatif) La valeur par défaut est définie sur true. Vous pouvez activer cette option pour publier IPv4 les adresses présentes sur l'appareil principal. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

  • includeIPv6Addrs— (Facultatif) Vous pouvez activer cette option pour publier IPv6 les adresses trouvées sur l'appareil principal. Réglez false sur includeIPv4Addrs pour utiliser cette option. Vous devez disposer du détecteur IP v2.2.0 ou version ultérieure pour utiliser cette option.

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

{
  ...,
  "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 des MQTT courtiers pour les appareils principaux.

Chaque point de terminaison du MQTT courtier contient les informations suivantes :

Point de terminaison (HostAddress)

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

Port (PortNumber)

Port sur lequel le MQTT broker opère sur le périphérique principal.

Vous pouvez configurer ce port sur le composant Moquette MQTT Broker, 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 MQTT courtier, vous pouvez voir les points de terminaison du MQTT courtier de l'appareil 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 de MQTT courtier 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 avec AWS IoT Greengrass V1, vous pouvez utiliser AWS IoT Greengrass V2 nos AWS IoT Greengrass V1 API opérations 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 le AWS API 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 avec AWS IoT Greengrass V1, vous pouvez utiliser AWS IoT Greengrass V2 nos AWS IoT Greengrass V1 API opérations pour gérer les principaux points de terminaison des appareils.

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