View a markdown version of this page

rilevatore IP - AWS IoT Greengrass

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à.

rilevatore IP

Il componente IP detector (aws.greengrass.clientdevices.IPDetector) esegue le seguenti operazioni:

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

  • Aggiorna le informazioni di connettività del dispositivo principale nel servizio cloud. AWS IoT Greengrass

I dispositivi client possono utilizzare Greengrass cloud discovery per recuperare le informazioni di connettività dei dispositivi principali associati. Quindi, i dispositivi client possono provare a connettersi a ciascun dispositivo principale finché non si connettono correttamente.

Nota

I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo principale di Greengrass per inviare messaggi e dati MQTT da elaborare. Per ulteriori informazioni, consulta Interagisci con dispositivi IoT locali.

Il componente IP detector sostituisce le informazioni di connettività esistenti di un dispositivo principale con le informazioni rilevate. Poiché questo componente rimuove le informazioni esistenti, è possibile utilizzare il componente rilevatore IP o gestire manualmente le informazioni di connettività.

Versioni

Questo componente ha le seguenti versioni:

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Questo componente è un componente plug-in (aws.greengrass.plugin). Il nucleo di Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

Questo componente utilizza lo stesso file di registro del nucleo di Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

Requisiti

Questo componente ha i seguenti requisiti:

  • Il ruolo del servizio Greengrass deve essere associato all'utente Account AWS e consentire le iot:GetThingShadow iot:UpdateThingShadow autorizzazioni.

  • La AWS IoT politica del dispositivo principale deve consentire l'greengrass:UpdateConnectivityInfoautorizzazione. Per ulteriori informazioni, consulta AWS IoT politiche per le operazioni sul piano dati e AWS IoT Politica minima per il supporto dei dispositivi client.

  • Se si configura il componente broker MQTT del dispositivo principale per utilizzare una porta diversa dalla porta predefinita 8883, è necessario utilizzare IP detector v2.1.0 o successivo. Configuralo per segnalare la porta su cui opera il broker.

  • Se hai una configurazione di rete complessa, il componente del rilevatore IP potrebbe non essere in grado di identificare gli endpoint in cui i dispositivi client possono connettersi al dispositivo principale. Se il componente del rilevatore IP non è in grado di gestire gli endpoint, è necessario invece gestire manualmente gli endpoint principali del dispositivo. Ad esempio, se il dispositivo principale si trova dietro un router che gli inoltra la porta del broker MQTT, è necessario specificare l'indirizzo IP del router come endpoint per il dispositivo principale. Per ulteriori informazioni, consulta Gestisci gli endpoint principali dei dispositivi.

  • Il componente IP detector è supportato per l'esecuzione in un VPC.

Dipendenze

Quando si distribuisce un componente, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

2.2.3

La tabella seguente elenca le dipendenze per la versione 2.2.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2,2.0 <2,17,0 Flessibili
2.2.2

La tabella seguente elenca le dipendenze per la versione 2.2.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.16.0 Flessibili
2.2.1

La tabella seguente elenca le dipendenze per la versione 2.2.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2,2.0 <2,15,0 Flessibili
2.2.0

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.14.0 Flessibili
2.1.8 – 2.1.9

La tabella seguente elenca le dipendenze per le versioni 2.1.8 e 2.1.9 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.13.0 Flessibili
2.1.7

La tabella seguente elenca le dipendenze per la versione 2.1.7 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.12.0 Flessibili
2.1.6

La tabella seguente elenca le dipendenze per la versione 2.1.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.11.0 Flessibili
2.1.5

La tabella seguente elenca le dipendenze per la versione 2.1.5 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.10.0 Flessibili
2.1.4

La tabella seguente elenca le dipendenze per la versione 2.1.4 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.9.0 Flessibili
2.1.3

La tabella seguente elenca le dipendenze per la versione 2.1.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.8.0 Flessibili
2.1.2

La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2,2.0 <2,7,0 Flessibili
2.1.1

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.6.0 Flessibili
2.1.0 and 2.0.2

La tabella seguente elenca le dipendenze per le versioni 2.1.0 e 2.0.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.5.0 Flessibili
2.0.1

La tabella seguente elenca le dipendenze per la versione 2.0.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.4.0 Flessibili
2.0.0

La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.2.0 <2.3.0 Flessibili

Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti. ComponentDependencies

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

2.2.x
defaultPort

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

Impostazione predefinita: 8883

includeIPv4LoopbackAddrs

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di loopback IPv4. Si tratta di indirizzi IP, ad esempiolocalhost, dove 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.

Impostazione predefinita: false

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

Impostazione predefinita: false

includeIPv6LoopbackAddrs

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di loopback IPv6. Si tratta di indirizzi IP, ad esempiolocalhost, dove 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 impostare su false e includeIPv4Addrs includeIPv6Addrs to true per utilizzare questa opzione.

Impostazione predefinita: false

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi IPv6 link-local. Utilizzate questa opzione se la rete del dispositivo principale non dispone del Dynamic Host Configuration Protocol (DHCP) o di indirizzi IP assegnati staticamente. È necessario impostare su false e includeIPv4Addrs includeIPv6Addrs per true utilizzare questa opzione.

Impostazione predefinita: false

includeIPv4Addrs

(Facoltativo) L'impostazione predefinita ètrue. Puoi abilitare questa opzione per pubblicare gli indirizzi IPv4 presenti sul dispositivo principale.

Impostazione predefinita: true

includeIPv6Addrs

(Facoltativo) È possibile abilitare questa opzione per pubblicare gli indirizzi IPv6 presenti sul dispositivo principale. includeIPv4AddrsImpostare false su per utilizzare questa opzione.

Impostazione predefinita: false

2.1.x
defaultPort

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

Impostazione predefinita: 8883

includeIPv4LoopbackAddrs

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di loopback IPv4. Si tratta di indirizzi IP, ad esempiolocalhost, dove 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.

Impostazione predefinita: false

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

Impostazione predefinita: false

2.0.x
includeIPv4LoopbackAddrs

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di loopback IPv4. Si tratta di indirizzi IP, ad esempiolocalhost, dove 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.

Impostazione predefinita: false

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

Impostazione predefinita: false

File di registro locale

Questo componente utilizza lo stesso file di registro del componente Greengrass nucleus.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente
  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

La tabella seguente descrive le modifiche in ciascuna versione del componente.

Versione

Modifiche

2.2.5

Aggiorna la versione del componente per la versione 2.18.0 di Greengrass nucleus.

2.2.4

Aggiorna la versione del componente per la versione 2.17.0 di Greengrass nucleus.

2.2.3

Versione aggiornata per Greengrass nucleus versione 2.16.0.

2.2.2

Versione aggiornata per la versione 2.15.0 di Greengrass nucleus.

2.2.1

Versione aggiornata per la versione 2.14.0 di Greengrass nucleus.

2.2.0

Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.

Nuove funzionalità
  • Aggiunge il supporto per IPv6. È ora possibile utilizzare IPv6 per la messaggistica locale.

2.1.9

Correzioni di bug e miglioramenti
  • Regola la fase di acquisizione dell'IP in modo da inviare i log solo a livello di registro di debug.

2.1.8

Versione aggiornata per Greengrass nucleus versione 2.12.0.

2.1.7

Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.

2.1.6

Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.

2.1.5

Versione aggiornata per la versione 2.9.0 di Greengrass nucleus.

2.1.4

Versione aggiornata per la versione 2.8.0 di Greengrass nucleus.

2.1.3

Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.

2.1.2

Correzioni di bug e miglioramenti
  • Migliora i messaggi di errore che questo componente registra in determinati scenari.

  • Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.

2.1.1

Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.

2.1.0

Miglioramenti
  • Aggiunge il defaultPort parametro, che consente di utilizzare una porta broker MQTT non predefinita.

  • Aggiornamenti per rendere più chiari i messaggi di registro.

2.0.2

Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.

2.0.1

Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.

2.0.0

Versione iniziale.