Administre los puntos finales de los dispositivos principales - AWS IoT Greengrass
Utilice el detector de IP para gestionar automáticamente los puntos finalesAdministre manualmente los puntos finales

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Administre los puntos finales de los dispositivos principales

Al utilizar la detección en la nube, se almacenan los puntos finales del broker MQTT para los dispositivos principales en el servicio en la nube. AWS IoT Greengrass Los dispositivos cliente se conectan AWS IoT Greengrass para recuperar estos puntos finales y otra información para sus dispositivos principales asociados.

Para cada dispositivo principal, puede administrar los puntos finales de forma automática o manual.

  • Administre automáticamente los puntos finales con un detector de IP

    Puede implementar el componente detector de IP para administrar automáticamente los puntos finales de los dispositivos principales si tiene una configuración de red no compleja, por ejemplo, si los dispositivos cliente están en la misma red que el dispositivo principal. No puede utilizar el componente detector de IP si el dispositivo principal está detrás de un router que reenvía el puerto intermediario MQTT al dispositivo principal, por ejemplo.

    El componente detector de IP también es útil si se implementa en grupos de cosas, ya que administra los puntos finales de todos los dispositivos principales del grupo de cosas. Para obtener más información, consulte Utilice el detector de IP para gestionar automáticamente los puntos finales.

  • Administre manualmente los puntos finales

    Si no puede utilizar el componente detector de IP, debe administrar manualmente los puntos finales de los dispositivos principales. Puede actualizar estos puntos finales con la consola o la API. Para obtener más información, consulte Administre manualmente los puntos finales.

Utilice el detector de IP para gestionar automáticamente los puntos finales

Si tiene una configuración de red sencilla, como los dispositivos cliente en la misma red que el dispositivo principal, puede implementar el componente detector de IP para hacer lo siguiente:

  • Supervise la información de conectividad de red local del dispositivo principal de Greengrass. Esta información incluye los puntos finales de la red del dispositivo principal y el puerto en el que opera el intermediario MQTT.

  • Informe la información de conectividad del dispositivo principal al servicio en la AWS IoT Greengrass nube.

El componente del detector de IP sobrescribe los puntos finales que se configuran manualmente.

importante

La AWS IoT política del dispositivo principal debe permitir el greengrass:UpdateConnectivityInfo permiso para usar el componente detector de IP. Para obtener más información, consulte Políticas de AWS IoT para operaciones de plano de datos y Configure la política de AWS IoT cosas.

Puede realizar una de las siguientes acciones para implementar el componente del detector de IP:

  • Utilice la página Configurar la detección de la consola. Para obtener más información, consulte Configure la detección en la nube (consola).

  • Cree y revise las implementaciones para incluir el detector de IP. Puede usar la consola o la AWS CLI AWS API para administrar las implementaciones. Para obtener más información, consulte Crear implementaciones.

  1. En el menú de navegación de la AWS IoT Greengrassconsola, elija Componentes.

  2. En la página Componentes, seleccione la pestaña Componentes públicos y, a continuación, elija aws.greengrass.clientdevices.IPDetector.

  3. En la página aws.greengrass.clientdevices.IPDetector, elija Implementar.

  4. En Añadir a la implementación, elija una implementación existente para revisarla o cree una nueva y, a continuación, elija Siguiente.

  5. Si opta por crear una nueva implementación, elija el dispositivo principal o el grupo de cosas de destino para la implementación. En la página Especificar el destino, en Destino del despliegue, elija un dispositivo principal o un grupo de cosas y, a continuación, elija Siguiente.

  6. En la página Seleccionar componentes, compruebe que el aws.greengrass.clientdevices.IPDetectorcomponente esté seleccionado y seleccione Siguiente.

  7. En la página Configurar componentes, seleccione y aws.greengrass.clientdevices.IPDetector, a continuación, haga lo siguiente:

    1. Seleccione Configurar componente.

    2. En el aws.greengrass.clientdevices.IPDetector modo Configurar, en Actualización de configuración, en Configuración para fusionar, puede introducir una actualización de configuración para configurar el componente del detector de IP. Puede especificar cualquiera de las siguientes opciones de configuración:

      • defaultPort— (Opcional) El puerto del broker MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el broker MQTT para que utilice un puerto diferente al puerto predeterminado 8883.

      • includeIPv4LoopbackAddrs— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones de bucle invertido de IPv4. Se trata de direcciones IP, por ejemplolocalhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo cliente se ejecuten en el mismo sistema.

      • includeIPv4LinkLocalAddrs— (Opcional) Puede habilitar esta opción para detectar e informar sobre las direcciones IPv4 de enlace local. Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática.

      La actualización de la configuración puede tener un aspecto similar al del siguiente ejemplo.

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

    3. Elija Confirmar para cerrar el modal y, a continuación, elija Siguiente.

  8. En la página Configurar ajustes avanzados, mantenga los ajustes de configuración predeterminados y seleccione Siguiente.

  9. En la página Revisar, elija Implementar.

    La implementación puede tardar hasta un minuto en completarse.

Para implementar el componente detector de IP, cree un documento de despliegue que lo incluya aws.greengrass.clientdevices.IPDetector en el components objeto y especifique la actualización de configuración del componente. Siga las instrucciones Crear implementaciones para crear una nueva implementación o revisar una implementación existente.

Puede especificar cualquiera de las siguientes opciones para configurar el componente del detector de IP al crear el documento de despliegue:

  • defaultPort— (Opcional) El puerto del broker MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el broker MQTT para que utilice un puerto diferente al puerto predeterminado 8883.

  • includeIPv4LoopbackAddrs— (Opcional) Puede activar esta opción para detectar e informar sobre las direcciones de bucle invertido de IPv4. Se trata de direcciones IP, por ejemplolocalhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo cliente se ejecuten en el mismo sistema.

  • includeIPv4LinkLocalAddrs— (Opcional) Puede habilitar esta opción para detectar e informar sobre las direcciones IPv4 de enlace local. Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática.

En el siguiente ejemplo de documento de despliegue parcial, se especifica que el puerto 8883 es el puerto intermediario de MQTT.

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

Administre manualmente los puntos finales

Puede administrar manualmente los puntos finales de MQTT Broker para los dispositivos principales.

Cada punto final del broker MQTT tiene la siguiente información:

Punto final () HostAddress

Una dirección IP o una dirección DNS donde los dispositivos cliente pueden conectarse a un intermediario MQTT en el dispositivo principal.

Port (PortNumber)

El puerto en el que opera el broker MQTT en el dispositivo principal.

Puede configurar este puerto en el componente broker MQTT de Moquette, que utiliza de forma predeterminada el puerto 8883.

Metadatos () Metadata

Metadatos adicionales para proporcionarlos a los dispositivos cliente que se conectan a este punto final.

Administre los puntos finales (consola)

Puede usar la AWS IoT Greengrass consola para ver, actualizar y eliminar los puntos finales de un dispositivo principal.

Para administrar los puntos finales de un dispositivo principal (consola)

  1. Elija dispositivos principales.

  2. Elija el dispositivo principal que desee administrar.

  3. En la página de detalles del dispositivo principal, elija la pestaña Client devices (Dispositivos cliente).

  4. En la sección de puntos finales del corredor MQTT, puede ver los puntos finales del corredor MQTT del dispositivo principal. Seleccione Administrar puntos de conexión.

  5. En el modal Administrar puntos de conexión, añada o elimine los puntos de conexión de intermediación MQTT para el dispositivo principal.

  6. Seleccione Actualizar.

Gestione los puntos finales () AWS CLI

Puede usar AWS Command Line Interface (AWS CLI) para administrar los puntos finales de un dispositivo principal.

nota

Como la compatibilidad con dispositivos cliente AWS IoT Greengrass V2 es retrocompatibleAWS IoT Greengrass V1, puedes utilizar AWS IoT Greengrass V2 nuestras operaciones de AWS IoT Greengrass V1 API para gestionar los puntos finales principales de los dispositivos.

Para obtener puntos finales para un dispositivo principal () AWS CLI
Para actualizar los puntos finales de un dispositivo principal () AWS CLI

Gestione los puntos finales (API)

Puede usar la AWS API para administrar los puntos finales de un dispositivo principal.

nota

Como la compatibilidad con dispositivos cliente AWS IoT Greengrass V2 es retrocompatibleAWS IoT Greengrass V1, puedes utilizar AWS IoT Greengrass V2 nuestras operaciones de AWS IoT Greengrass V1 API para gestionar los puntos finales principales de los dispositivos.

Para obtener puntos finales para un dispositivo principal (API) AWS
Para actualizar los puntos finales de un dispositivo principal (AWSAPI)