Administración de puntos de conexión del dispositivo principal - AWS IoT Greengrass
Uso del detector de IP para administrar automáticamente los puntos de conexiónAdministración manual de los puntos de conexión

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.

Administración de puntos de conexión del dispositivo principal

Cuando utiliza la detección en la nube, almacena los puntos de conexión del agente de MQTT para los dispositivos principales en el servicio en la nube de AWS IoT Greengrass. Los dispositivos de cliente se conectan a AWS IoT Greengrass para recuperar estos puntos de conexión y otra información para sus dispositivos principales asociados.

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

  • Administración automática de los puntos de conexión con un detector de IP

    Puede implementar el componente detector de IP para administrar automáticamente los puntos de conexión 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 enrutador que reenvía el puerto agente de MQTT al dispositivo principal, por ejemplo.

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

  • Administración manual de los puntos de conexión

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

Uso del detector de IP para administrar automáticamente los puntos de conexión

Si tiene una configuración de red sencilla, como los dispositivos de 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 de conexión de la red del dispositivo principal y el puerto en el que opera el agente de MQTT.

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

El componente detector de IP sobrescribe los puntos de conexión que se configuran manualmente.

importante

La política AWS IoT del dispositivo principal debe permitir el permiso greengrass:UpdateConnectivityInfo 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 Configuración de la política de objetos AWS IoT.

Puede realizar uno de los siguientes procedimientos para implementar el componente detector de IP:

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

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

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

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

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

  4. En Agregar 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 objetos de destino para la implementación. En la página Especificar el destino, en Destino de la implementación, elija un dispositivo principal o un grupo de objetos y, a continuación, elija Siguiente.

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

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

    1. Seleccione Configurar componente.

    2. En el cuadro Configurar aws.greengrass.clientdevices.IPDetector, en Actualizar configuración, en Configuración para combinar, puede introducir una actualización de configuración para configurar el componente detector de IP. Puede especificar una de las siguientes opciones de configuración:

      • defaultPort: (opcional) el puerto del agente MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el agente 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. Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema.

      • includeIPv4LinkLocalAddrs: (opcional) puede habilitar esta opción para detectar e informar sobre las direcciones de enlace local de IPv4. 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.

      • includeIPv6LoopbackAddrs: (opcional) puede activar esta opción para detectar e informar sobre las direcciones de bucle invertido de IPv6. Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema. Debe configurar includeIPv4Addrs en false y includeIPv6Addrs en true para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

      • includeIPv6LinkLocalAddrs: (opcional) puede habilitar esta opción para detectar e informar sobre las direcciones de enlace local de IPv6. 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. Debe configurar includeIPv4Addrs en false y includeIPv6Addrs en true para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

      • includeIPv4Addrs: (opcional) el valor predeterminado está establecido en verdadero. Puede activar esta opción para publicar las direcciones IPv4 que se encuentran en el dispositivo principal. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

      • includeIPv6Addrs: (opcional) puede habilitar esta opción para publicar las direcciones IPv6 que se encuentran en el dispositivo principal. Configure includeIPv4Addrs en false para usar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

      La actualización de la configuración podría parecerse al siguiente ejemplo.

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

    3. Elija Confirmar para cerrar el cuadro 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 para completarse.

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

Puede especificar cualquiera de las siguientes opciones para configurar el componente detector de IP cuando cree el documento de implementación:

  • defaultPort: (opcional) el puerto del agente MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el agente 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. Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema.

  • includeIPv4LinkLocalAddrs: (opcional) puede habilitar esta opción para detectar e informar sobre las direcciones de enlace local de IPv4. 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.

  • includeIPv6LoopbackAddrs: (opcional) puede activar esta opción para detectar e informar sobre las direcciones de bucle invertido de IPv6. Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema. Debe configurar includeIPv4Addrs en false y includeIPv6Addrs en true para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

  • includeIPv6LinkLocalAddrs: (opcional) puede habilitar esta opción para detectar e informar sobre las direcciones de enlace local de IPv6. 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. Debe configurar includeIPv4Addrs en false y includeIPv6Addrs en true para utilizar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

  • includeIPv4Addrs: (opcional) el valor predeterminado está establecido en verdadero. Puede activar esta opción para publicar las direcciones IPv4 que se encuentran en el dispositivo principal. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

  • includeIPv6Addrs: (opcional) puede habilitar esta opción para publicar las direcciones IPv6 que se encuentran en el dispositivo principal. Configure includeIPv4Addrs en false para usar esta opción. Debe tener el detector de IP versión 2.2.0 o posterior para usar esta opción.

El siguiente ejemplo de documento de implementación parcial especifica declarar el puerto 8883 como puerto agente de MQTT.

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

Administración manual de los puntos de conexión

Puede administrar manualmente los puntos de conexión del agente de MQTT para los dispositivos principales.

Cada punto de conexión del agente de MQTT tiene la siguiente información:

Punto de conexión (HostAddress)

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

Port (PortNumber)

El puerto en el que opera el agente de MQTT en el dispositivo principal.

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

Metadatos (Metadata)

Metadatos adicionales para proporcionarlos a los dispositivos de cliente que se conectan a este punto de conexión.

Administración de los puntos de conexión (consola)

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

Cómo administrar los puntos de conexión 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 de conexión del agente de MQTT, puede ver los puntos de conexión del agente de MQTT del dispositivo principal. Seleccione Administrar puntos de conexión.

  5. En el cuadro Administrar puntos de conexión, agregue o elimine los puntos de conexión del agente de MQTT para el dispositivo principal.

  6. Elija Actualizar.

Administración de puntos de conexión (AWS CLI)

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

nota

Como la compatibilidad con dispositivos de cliente en AWS IoT Greengrass V2 es retrocompatible con AWS IoT Greengrass V1, puede utilizar operaciones de API AWS IoT Greengrass V2 o AWS IoT Greengrass V1 para administrar los puntos de conexión de los dispositivos principales.

Cómo obtener puntos de conexión para un dispositivo principal (AWS CLI)
Cómo actualizar los puntos de conexión de un dispositivo principal (AWS CLI)

Administración de puntos de conexión (API)

Puede usar la API AWS para administrar los puntos de conexión de un dispositivo principal.

nota

Como la compatibilidad con dispositivos de cliente en AWS IoT Greengrass V2 es retrocompatible con AWS IoT Greengrass V1, puede utilizar operaciones de API AWS IoT Greengrass V2 o AWS IoT Greengrass V1 para administrar los puntos de conexión de los dispositivos principales.

Cómo obtener puntos de conexión para un dispositivo principal (API de AWS)
Cómo actualizar los puntos de conexión de un dispositivo principal (API AWS)