Gestisci gli endpoint principali dei dispositivi - AWS IoT Greengrass
Usa il rilevatore IP per gestire automaticamente gli endpointGestisci manualmente gli endpoint

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestisci gli endpoint principali dei dispositivi

Quando utilizzi il cloud discovery, archivi gli endpoint del MQTT broker per i dispositivi principali nel AWS IoT Greengrass servizio cloud. I dispositivi client si connettono AWS IoT Greengrass per recuperare questi endpoint e altre informazioni per i dispositivi principali associati.

Per ogni dispositivo principale, puoi gestire automaticamente o manualmente gli endpoint.

  • Gestisci automaticamente gli endpoint con il rilevatore IP

    Puoi implementare il componente IP Detector per gestire automaticamente gli endpoint dei dispositivi principali al posto tuo se disponi di una configurazione di rete non complessa, ad esempio dove i dispositivi client si trovano sulla stessa rete del dispositivo principale. Non è possibile utilizzare il componente del rilevatore IP se il dispositivo principale si trova dietro un router che inoltra la porta del MQTT broker al dispositivo principale, ad esempio.

    Il componente del rilevatore IP è utile anche se si esegue la distribuzione su gruppi di oggetti, poiché gestisce gli endpoint per tutti i dispositivi principali del gruppo di oggetti. Per ulteriori informazioni, consulta Usa il rilevatore IP per gestire automaticamente gli endpoint.

  • Gestisci manualmente gli endpoint

    Se non puoi utilizzare il componente del rilevatore IP, devi gestire manualmente gli endpoint principali dei dispositivi. Puoi aggiornare questi endpoint con la console o il. API Per ulteriori informazioni, consulta Gestisci manualmente gli endpoint.

Usa il rilevatore IP per gestire automaticamente gli endpoint

Se disponi di una configurazione di rete semplice, ad esempio i dispositivi client sulla stessa rete del dispositivo principale, puoi implementare il componente del rilevatore IP per eseguire le seguenti operazioni:

  • Monitora le informazioni sulla connettività di rete locale del dispositivo Greengrass core. Queste informazioni includono gli endpoint di rete del dispositivo principale e la porta su cui opera il MQTT broker.

  • Segnala le informazioni sulla connettività del dispositivo principale al servizio AWS IoT Greengrass cloud.

Il componente del rilevatore IP sovrascrive gli endpoint impostati manualmente.

Importante

La AWS IoT politica del dispositivo principale deve consentire l'greengrass:UpdateConnectivityInfoautorizzazione all'uso del componente del rilevatore IP. Per ulteriori informazioni, consulta Policy AWS IoT per operazioni del piano dei dati e Configura la policy relativa agli AWS IoT oggetti.

È possibile effettuare una delle seguenti operazioni per distribuire il componente del rilevatore IP:

  • Utilizza la pagina Configure Discovery nella console. Per ulteriori informazioni, consulta Configura cloud discovery (console).

  • Crea e modifica le distribuzioni per includere il rilevatore IP. È possibile utilizzare la console o AWS API gestire le AWS CLI distribuzioni. Per ulteriori informazioni, consulta Creare distribuzione.

  1. Nel menu di navigazione della AWS IoT Greengrass console, scegli Componenti.

  2. Nella pagina Componenti, scegli la scheda Componenti pubblici, quindi scegli aws.greengrass.clientdevices.IPDetector.

  3. Nella pagina aws.greengrass.clientdevices.IPDetector, scegli (Distribuisci).

  4. Da Aggiungi alla distribuzione, scegli una distribuzione esistente da modificare oppure scegli di creare una nuova distribuzione, quindi scegli Avanti.

  5. Se hai scelto di creare una nuova distribuzione, scegli il dispositivo principale o il gruppo di oggetti di destinazione per la distribuzione. Nella pagina Specificare la destinazione, in Obiettivo di distribuzione, scegli un dispositivo principale o un gruppo di oggetti, quindi scegli Avanti.

  6. Nella pagina Seleziona componenti, verifica che il aws.greengrass.clientdevices.IPDetectorcomponente sia selezionato, scegli Avanti.

  7. Nella pagina Configura componenti aws.greengrass.clientdevices.IPDetector, selezionate e quindi effettuate le seguenti operazioni:

    1. Scegli Configura componente.

    2. Nella aws.greengrass.clientdevices.IPDetector modalità Configura, in Aggiornamento della configurazione, in Configurazione da unire, è possibile inserire un aggiornamento della configurazione per configurare il componente del rilevatore IP. È possibile specificare una delle seguenti opzioni di configurazione:

      • defaultPort— (Facoltativo) La porta del MQTT broker da segnalare quando questo componente rileva gli indirizzi IP. È necessario specificare questo parametro se si configura il MQTT broker per utilizzare una porta diversa dalla porta predefinita 8883.

      • includeIPv4LoopbackAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv4 loopback. Si tratta di indirizzi IP, ad esempio quelli localhost in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema.

      • includeIPv4LinkLocalAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi IPv4 locali del collegamento. Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente.

      • includeIPv6LoopbackAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv6 loopback. Si tratta di indirizzi IP, ad esempio quelli localhost in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema. È necessario includeIPv4Addrs impostare false e includeIPv6Addrs true utilizzare questa opzione. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

      • includeIPv6LinkLocalAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e IPv6 segnalare gli indirizzi locali dei collegamenti. Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente. È necessario includeIPv4Addrs impostare false e includeIPv6Addrs true utilizzare questa opzione. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

      • includeIPv4Addrs— (Facoltativo) L'impostazione predefinita è true. È possibile abilitare questa opzione per pubblicare IPv4 gli indirizzi trovati sul dispositivo principale. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

      • includeIPv6Addrs— (Facoltativo) È possibile abilitare questa opzione per pubblicare IPv6 gli indirizzi trovati sul dispositivo principale. Imposta includeIPv4Addrs false per utilizzare questa opzione. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

      L'aggiornamento della configurazione potrebbe essere simile all'esempio seguente.

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

    3. Scegli Conferma per chiudere la modalità, quindi scegli Avanti.

  8. Nella pagina Configura impostazioni avanzate, mantieni le impostazioni di configurazione predefinite e scegli Avanti.

  9. Nella pagina Review (Verifica), scegli Deploy (Distribuisci).

    Il completamento della distribuzione può richiedere fino a un minuto.

Per distribuire il componente del rilevatore IP, create un documento di distribuzione che aws.greengrass.clientdevices.IPDetector includa l'componentsoggetto e specificate l'aggiornamento della configurazione per il componente. Segui le istruzioni riportate in Creare distribuzione basso per creare una nuova distribuzione o modificare una distribuzione esistente.

È possibile specificare una delle seguenti opzioni per configurare il componente del rilevatore IP quando si crea il documento di distribuzione:

  • defaultPort— (Facoltativo) La porta del MQTT broker da segnalare quando questo componente rileva gli indirizzi IP. È necessario specificare questo parametro se si configura il MQTT broker per utilizzare una porta diversa dalla porta predefinita 8883.

  • includeIPv4LoopbackAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv4 loopback. Si tratta di indirizzi IP, ad esempio quelli localhost in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema.

  • includeIPv4LinkLocalAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi IPv4 locali del collegamento. Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente.

  • includeIPv6LoopbackAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di IPv6 loopback. Si tratta di indirizzi IP, ad esempio quelli localhost in cui un dispositivo può comunicare con se stesso. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema. È necessario includeIPv4Addrs impostare false e includeIPv6Addrs true utilizzare questa opzione. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

  • includeIPv6LinkLocalAddrs— (Facoltativo) È possibile abilitare questa opzione per rilevare e IPv6 segnalare gli indirizzi locali dei collegamenti. Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente. È necessario includeIPv4Addrs impostare false e includeIPv6Addrs true utilizzare questa opzione. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

  • includeIPv4Addrs— (Facoltativo) L'impostazione predefinita è true. È possibile abilitare questa opzione per pubblicare IPv4 gli indirizzi trovati sul dispositivo principale. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

  • includeIPv6Addrs— (Facoltativo) È possibile abilitare questa opzione per pubblicare IPv6 gli indirizzi trovati sul dispositivo principale. Imposta includeIPv4Addrs false per utilizzare questa opzione. È necessario disporre del rilevatore IP v2.2.0 o successivo per utilizzare questa opzione.

Il seguente esempio di documento di distribuzione parziale specifica di segnalare la porta 8883 come porta del broker. MQTT

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

Gestisci manualmente gli endpoint

Puoi gestire manualmente gli endpoint del MQTT broker per i dispositivi principali.

Ogni endpoint del MQTT broker contiene le seguenti informazioni:

Punto finale () HostAddress

Un indirizzo IP o un DNS indirizzo a cui i dispositivi client possono connettersi a un MQTT broker sul dispositivo principale.

Porta (PortNumber)

La porta su cui opera il MQTT broker sul dispositivo principale.

È possibile configurare questa porta sul componente del MQTT broker Moquette, che per impostazione predefinita utilizza la porta 8883.

Metadati () Metadata

Metadati aggiuntivi da fornire ai dispositivi client che si connettono a questo endpoint.

Gestisci gli endpoint (console)

Puoi utilizzare la AWS IoT Greengrass console per visualizzare, aggiornare e rimuovere gli endpoint per un dispositivo principale.

Per gestire gli endpoint per un dispositivo principale (console)

  1. Scegli Dispositivi principali.

  2. Scegli il dispositivo principale da gestire.

  3. Nella pagina dei dettagli del dispositivo principale, scegli la scheda Dispositivi client.

  4. Nella sezione endpoint del MQTT broker, puoi vedere gli endpoint del MQTT broker del dispositivo principale. Scegli Gestisci gli endpoint.

  5. Nella modalità Gestisci gli endpoint, aggiungi o rimuovi gli endpoint del MQTT broker per il dispositivo principale.

  6. Scegli Aggiorna.

Gestisci gli endpoint ()AWS CLI

Puoi usare il AWS Command Line Interface (AWS CLI) per gestire gli endpoint per un dispositivo principale.

Nota

Poiché il supporto per i dispositivi client in AWS IoT Greengrass V2 è retrocompatibile con AWS IoT Greengrass V1, puoi utilizzare AWS IoT Greengrass V2 le nostre AWS IoT Greengrass V1 API operazioni per gestire gli endpoint principali dei dispositivi.

Per ottenere endpoint per un dispositivo principale ()AWS CLI
Per aggiornare gli endpoint per un dispositivo principale ()AWS CLI

Gestisci gli endpoint () API

Puoi utilizzarli AWS API per gestire gli endpoint per un dispositivo principale.

Nota

Poiché il supporto per i dispositivi client in AWS IoT Greengrass V2 è retrocompatibile con AWS IoT Greengrass V1, puoi utilizzare AWS IoT Greengrass V2 le nostre AWS IoT Greengrass V1 API operazioni per gestire gli endpoint principali dei dispositivi.

Per ottenere endpoint per un dispositivo principale ()AWS API
Per aggiornare gli endpoint per un dispositivo principale ()AWS API