Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
Edge 1.5
Importante
IoT Edge 1.5 LTS è la versione supportata. IoT Edge 1.4 LTS è di fine vita a partire dal 12 novembre 2024. Se si usa una versione precedente, vedere Aggiornare IoT Edge.
L'agente di IoT Edge e l'hub di IoT Edge sono due moduli che costituiscono il runtime di IoT Edge. Per altre informazioni sulle responsabilità di ogni modulo di runtime, vedere Comprendere il runtime di Azure IoT Edge e la relativa architettura.
Questo articolo descrive le proprietà desiderate e quelle segnalate dei moduli gemelli del runtime. Per altre informazioni su come distribuire moduli nei dispositivi IoT Edge, vedere Come distribuire moduli e stabilire route in IoT Edge.
Un modulo gemello include:
Proprietà desiderate. Il back-end della soluzione imposta le proprietà desiderate e il modulo le legge. Il modulo riceve anche notifiche di modifiche nelle proprietà desiderate. Le proprietà desiderate vengono usate insieme alle proprietà segnalate per sincronizzare la configurazione o le condizioni del modulo.
Proprietà segnalate. Il modulo imposta le proprietà segnalate e il back-end della soluzione le legge ed esegue query. Le proprietà segnalate vengono usate insieme alle proprietà desiderate per sincronizzare la configurazione o le condizioni del modulo.
Proprietà desiderate di EdgeAgent
Il modulo gemello per l'agente IoT Edge è denominato $edgeAgent. Coordina le comunicazioni tra l'agente IoT Edge in esecuzione in un dispositivo e l'hub IoT. Le proprietà desiderate vengono impostate durante l'applicazione di un manifesto della distribuzione in un dispositivo specifico nell'ambito di una distribuzione di un singolo dispositivo o su larga scala.
| Proprietà | Descrizione | Richiesto |
|---|---|---|
| Politica di estrazione delle immagini (imagePullPolicy) | Specifica quando eseguire il pull dell'immagine: OnCreate o Never. Usare Mai se l'immagine è già presente nel dispositivo. | Sì |
| politica di riavvio | Quando il modulo deve essere riavviato. I valori possibili sono: Mai: non riavviare il modulo se non è in esecuzione, Always: riavvia sempre il modulo se non è in esecuzione, On-Unhealthy: restart module if unhealthy. Unhealthy è ciò che Docker segnala in base a un controllo di integrità, ad esempio "Unhealthy - il container non è funzionante correttamente", On-Failed: riavvia se non riuscito (Non riuscito). | Sì |
| runtime.type | Deve essere docker. | Sì |
| runtime.settings.minDockerVersion | Specifica la versione minima di Docker richiesta dal manifesto della distribuzione. | Sì |
| runtime.impostazioni.opzioni di registrazione | Specifica un codice JSON stringato con le opzioni di registrazione per il contenitore dell'agente IoT Edge. Altre informazioni sulle opzioni di registrazione di Docker. | NO |
| runtime.settings.registryCredentials. {registryId}.username | Specifica il nome utente del registro contenitori. Per Registro Azure Container, il nome utente corrisponde in genere al nome del registro. Le credenziali del Registro di sistema sono necessarie per le immagini del modulo privato. | NO |
| runtime.settings.registryCredentials. {registryId}.password | Password del registro contenitori. | NO |
| runtime.settings.registryCredentials. {registryId}.address | Indirizzo del registro contenitori. Per Registro Azure Container, l'indirizzo è in genere {nome registro}.azurecr.io. | NO |
| schemaVersion | Specifica 1.0 o 1.1. È consigliata la versione 1.1, introdotta con IoT Edge versione 1.0.10. | Sì |
| stato | Stato desiderato del modulo: in esecuzione o arrestato. | Richiesto |
| systemModules.edgeAgent.type | Deve essere docker. | Sì |
| systemModules.edgeAgent.startupOrder | Specifica un numero intero per la posizione del modulo nell'ordine di avvio. 0 è primo e numero intero massimo (4294967295) è l'ultimo. Se non viene specificato alcun valore, il valore predefinito è max integer. | NO |
| systemModules.edgeAgent.settings.image | Specifica l'URI dell'immagine dell'agente IoT Edge. L'agente IoT Edge non può aggiornarsi. | Sì |
| systemModules.edgeAgent.settings.createOptions | Specifica un codice JSON stringato con opzioni per la creazione del contenitore dell'agente IoT Edge. Altre informazioni sulle opzioni di creazione di Docker. | NO |
| systemModules.edgeAgent.configuration.id | ID della distribuzione che ha distribuito questo modulo. | L'hub IoT imposta questa proprietà quando il manifesto viene applicato tramite una distribuzione. Non fa parte di un manifesto della distribuzione. |
| systemModules.edgeHub.type | Deve essere docker. | Sì |
| systemModules.edgeHub.status | Deve essere in esecuzione. | Sì |
| systemModules.edgeHub.restartPolicy | Deve essere sempre. | Sì |
| systemModules.edgeHub.startupOrder | Valore intero per il cui spot è presente un modulo nell'ordine di avvio. Un valore 0 è il primo e il numero intero massimo (4294967295) è l'ultimo. Se non viene specificato un valore, il valore predefinito è max integer. | NO |
| moduliDiSistema.edgeHub.impostazioni.immagine | URI dell'immagine dell'hub di IoT Edge. | Sì |
| systemModules.edgeHub.settings.createOptions | Un file JSON in formato stringa contenente le opzioni per la creazione del contenitore dell'hub di IoT Edge. Opzioni di creazione di Docker | NO |
| systemModules.edgeHub.configuration.id | ID della distribuzione che ha distribuito questo modulo. | L'hub IoT imposta questa proprietà quando il manifesto viene applicato tramite una distribuzione. Non fa parte di un manifesto della distribuzione. |
| Moduli. {moduleId}.version | Una stringa definita dall'utente che rappresenta la versione di questo modulo. | Sì |
| moduli.{moduleId}.type | Deve essere docker. | Sì |
| moduli.{moduleId}.status | {esecuzione | fermo} | Sì |
| Moduli. {moduleId}.restartPolicy | {mai | sempre} | Sì |
| Moduli.{moduleId}.startupOrder | Un valore intero per la posizione in cui un modulo ha nell'ordine di avvio. Un valore 0 è il primo e il numero intero massimo (4294967295) è l'ultimo. Se non viene specificato un valore, il valore predefinito è max integer. | NO |
| modules.{moduleId}.imagePullPolicy | {on-create | mai} | NO |
| Moduli. {moduleId}.env | Elenco di variabili di ambiente da passare al modulo. Accetta il formato "<name>": {"value": "<value>"}. |
NO |
| moduli.{moduleId}.settings.image | URI dell'immagine del modulo. | Sì |
| moduli.{moduleId}.settings.createOptions | Un file JSON in formato stringa contenente le opzioni per la creazione del contenitore del modulo. Opzioni di creazione di Docker | NO |
| moduli.{moduleId}.configuration.id | ID della distribuzione che ha distribuito questo modulo. | L'hub IoT imposta questa proprietà quando il manifesto viene applicato tramite una distribuzione. Non fa parte di un manifesto della distribuzione. |
| versione | Iterazione corrente con versione, commit e compilazione. | NO |
Proprietà segnalate di EdgeAgent
Le proprietà segnalate dell'agente IoT Edge includono tre informazioni principali:
- Stato dell'applicazione delle proprietà desiderate dell'ultima visualizzazione,
- Stato dei moduli attualmente in esecuzione nel dispositivo come segnalato dall'agente IoT Edge e
- Copia delle proprietà desiderate attualmente in esecuzione nel dispositivo.
La copia delle proprietà desiderate correnti consente di determinare se il dispositivo ha applicato la distribuzione più recente o se sta ancora eseguendo un manifesto della distribuzione precedente.
Nota
È possibile eseguire query sulle proprietà segnalate dell'agente IoT Edge con il linguaggio di query dell'hub IoT per analizzare lo stato della distribuzione su larga scala. Scopri come utilizzare le proprietà dell'agente IoT Edge per controllare lo stato in Comprendere le distribuzioni di IoT Edge per dispositivi singoli o su larga scala.
La tabella seguente non include le informazioni copiate dalle proprietà desiderate.
| Proprietà | Descrizione |
|---|---|
| lastDesiredStatus.code | Codice di stato per le ultime proprietà desiderate visualizzate dall'agente IoT Edge. Valori consentiti: Operazione 200 riuscita, 400 Configurazione non valida, 412 Versione dello schema non valida, 417 Proprietà desiderate sono vuote, 500 Operazione non riuscita. |
| descrizioneStatoDesideratoUltimo | Descrizione di testo dello stato. |
| ultimaVersioneDesiderata | Questo integer si riferisce all'ultima versione delle proprietà desiderate elaborate dall'agente di IoT Edge. |
| runtime.platform.OS | Segnala il sistema operativo in esecuzione nel dispositivo. |
| runtime.platform.architecture | Segnala l'architettura della CPU nel dispositivo. |
| versione dello schema | Versione dello schema delle proprietà segnalate. |
| systemModules.edgeAgent.runtimeStatus | Stato segnalato dell'agente IoT Edge: {in esecuzione | non integro}. |
| Descrizione dello stato del sistema Agent Edge | Descrizione di testo dello stato segnalato dell'agente di IoT Edge. |
| systemModules.edgeAgent.exitCode | Codice di uscita segnalato dal contenitore dell'agente IoT Edge se il contenitore viene chiuso. |
| systemModules.edgeAgent.lastStartTimeUtc | Ora dell'ultimo avvio dell'agente IoT Edge. |
| systemModules.edgeAgent.lastExitTimeUtc | Ora dell'ultima uscita dell'agente IoT Edge. |
| systemModules.edgeHub.runtimeStatus | Stato dell'hub IoT Edge: { | | unhealthy }. |
| systemModules.edgeHub.statusDescription | Descrizione del testo dello stato dell'hub IoT Edge, se non integro. |
| systemModules.edgeHub.exitCode | Codice di uscita segnalato dal contenitore dell'hub IoT Edge, se il contenitore viene chiuso. |
| systemModules.edgeHub.lastStartTimeUtc | Ora dell'ultimo avvio dell'hub di IoT Edge. |
| systemModules.edgeHub.lastExitTimeUtc | Ora dell'ultima uscita dell'hub IoT Edge. |
| systemModules.edgeHub.lastRestartTimeUtc | Ora dell'ultimo riavvio dell'hub di IoT Edge. |
| systemModules.edgeHub.restartCount | Numero di tentativi di riavvio del modulo nell'ambito dei criteri di riavvio. |
| Modulo.{moduleId}.statoDiEsecuzione | Stato del modulo: { | | unhealthy }. |
| moduli.{moduleId}.statusDescription | Descrizione del testo dello stato del modulo, se non integro. |
| Moduli. {moduleId}.exitCode | Codice di uscita segnalato dal contenitore del modulo, se il contenitore viene chiuso. |
| Moduli. {moduleId}.lastStartTimeUtc | Ora dell'ultimo avvio del modulo. |
| modules.{moduleId}.lastExitTimeUtc | Ora dell'ultima uscita del modulo. |
| Moduli. {moduleId}.lastRestartTimeUtc | Ora dell'ultimo riavvio del modulo. |
| Moduli. {moduleId}.restartCount | Numero di tentativi di riavvio del modulo nell'ambito dei criteri di riavvio. |
| versione | Versione dell'immagine. Esempio: "version": { "version": "1.2.7", "build": "50979330", "commit": "d3ec971caa0af0fc39d2c1f91aef21e95bd0c03c" }. |
Proprietà desiderate di EdgeHub
Il dispositivo gemello del modulo per l'hub di IoT Edge è denominato $edgeHub e coordina le comunicazioni tra l'hub di IoT Edge in esecuzione su un dispositivo e l'hub IoT. Le proprietà desiderate vengono impostate durante l'applicazione di un manifesto della distribuzione in un dispositivo specifico nell'ambito di una distribuzione di un singolo dispositivo o su larga scala.
| Proprietà | Descrizione | Obbligatorio nel manifesto della distribuzione |
|---|---|---|
| versione dello schema | 1.0 o 1.1. La versione 1.1 è stata introdotta con IoT Edge versione 1.0.10 ed è consigliata. | Sì |
| Itinerari. {routeName} | Stringa che rappresenta una route dell'hub di IoT Edge. Per altre informazioni, vedere Dichiarare le route. | L'elemento routes può essere presente, ma vuoto. |
| storeAndForwardConfiguration.timeToLiveSecs | Il tempo del dispositivo in secondi in cui l'hub IoT Edge mantiene i messaggi se disconnessi dagli endpoint di routing, sia hub IoT che da un modulo locale. Questo tempo persiste su eventuali spegnimenti o riavvii. Per altre informazioni, vedere Funzionalità offline. | Sì |
Proprietà segnalate di EdgeHub
| Proprietà | Descrizione |
|---|---|
| versioneDesiderataFinale | Questo integer si riferisce all'ultima versione delle proprietà desiderate elaborate dall'hub di IoT Edge. |
| lastDesiredStatus.code | Il codice di stato che fa riferimento alle ultime proprietà desiderate visualizzate dall'hub di IoT Edge. Valori consentiti: 200 Success, 400 Invalid configuration, 500 Failed |
| descrizioneUltimoStatoDesiderato | Descrizione di testo dello stato. |
| client | Tutti i client connessi a edgeHub con lo stato e l'ora dell'ultima connessione. Esempio: "clients": { "device2/SimulatedTemperatureSensor": { "status": "Connected", "lastConnectedTimeUtc": "2022-11-17T21:49:16.4781564Z" } }. |
| clients.{device or moduleId}.stato | Stato di connettività del dispositivo o del modulo. Valori possibili {connected | disconnected}. Solo le identità del modulo possono essere in stato disconnected. I dispositivi downstream che si connettono all'hub di IoT Edge vengono visualizzati solo quando lo stato è connected. |
| clienti.{device or moduleId}.ultimoTempoDiConnessione | Ultima ora di connessione del dispositivo o del modulo. |
| Clienti.{dispositivo o moduloId}.tempoUltimaDisconnessione | Ultima ora di disconnessione del dispositivo o del modulo. |
| versione dello schema | Versione dello schema delle proprietà segnalate. |
| versione | Versione dell'immagine. Esempio: "version": { "version": "1.2.7", "build": "50979330", "commit": "d3ec971caa0af0fc39d2c1f91aef21e95bd0c03c" }. |
Passaggi successivi
Per informazioni su come usare queste proprietà per generare i manifesti di distribuzione, vedere Informazioni su come usare, configurare e riusare i moduli IoT Edge.