Dispositivi edge

Aggiungere Dispositivi Edge

Con dispositivi edge aggiuntivi (ovvero PC industriali) puoi distribuire app IronFlock a più macchine e alleggerire le operazioni delle app dall’Appliance. L’Appliance stesso funge già da dispositivo edge, ma puoi collegare ulteriori dispositivi edge nello stesso modo in cui distribuiresti dispositivi edge nel cloud IronFlock. Vai semplicemente su Impostazioni Progetto -> Dispositivi -> Nuovo Dispositivo e segui le istruzioni.

Aggiornamenti dell’Agent del Dispositivo

I dispositivi edge collegati all’Appliance ricevono gli aggiornamenti dell’agent del dispositivo IronFlock dall’Appliance stessa — non contattano mai instance-registry.ironflock.com e non hanno bisogno di accesso a internet per questo:

• Modalità semplice (IP): http://<appliance-host>:15002/dl — la stessa porta che i dispositivi usano già per i token del registro.
• Modalità dominio/TLS: https://registry.<appliance-domain>/dl sulla porta 443.

L’Appliance mantiene una copia locale (mirror) dei binari dell’agent e la aggiorna da https://instance-registry.ironflock.com (già incluso nella lista di autorizzazione del firewall) ogni 6 ore, oppure su richiesta in Impostazioni → Licenza/Appliance → Aggiornamenti dell’agent del dispositivo → Sincronizza ora. Puoi aggiornare il mirror di un’Appliance anche dal cloud IronFlock, senza aprire l’istanza e senza accedere all’Appliance stessa: nello Studio cloud vai su Profilo → Istanze, dove ogni Appliance di tua proprietà ha una colonna Aggiornamenti dell’agent del dispositivo che mostra la versione dell’agent che il suo mirror offre attualmente ai dispositivi (con sotto la versione dell’installer del dispositivo) e la stessa azione Sincronizza ora in quella cella. Il mirror segue il manifesto delle release del cloud: viene conservata ogni versione dell’agent a cui il manifesto del cloud fa attualmente riferimento — per tutti i target Linux e per Windows — e una versione viene offerta ai dispositivi solo quando è completamente presente sull’Appliance. Se il cloud pubblica una versione non ancora completa sull’Appliance, i dispositivi continuano a vedere quella precedente.

L’agent scarica dall’albero firmato <base>/device-agent/ (un manifest.json firmato e i binari con le relative firme .sig), verifica ogni aggiornamento prima di applicarlo e torna automaticamente indietro se la nuova versione non si avvia. Gli aggiornamenti vengono applicati solo all’avvio dell’agent o quando un utente avvia l’aggiornamento in Studio.

Un dispositivo apprende la posizione degli aggiornamenti dal proprio file .flock (update_url) e, a partire dalla versione 0.21.2 dell’agent, anche dall’Appliance a ogni heartbeat — un cambio di IP dell’Appliance o il passaggio alla modalità dominio si propaga quindi ai dispositivi automaticamente.

I dispositivi configurati prima di questa funzionalità che eseguono ancora un agent più vecchio devono scaricare di nuovo, una sola volta, il proprio file .flock. Su Windows: arresta il servizio (device-agent.exe service stop), sostituisci %ProgramData%\IronFlock\DeviceAgent\device.flock con il nuovo file (salvato senza BOM) — sui dispositivi installati prima dell’agente 1.4.0 la cartella è %ProgramData%\IronFlock\Reagent — e riavvialo (device-agent.exe service start).

Registrare Dispositivi senza Accesso a Internet

L’Appliance esegue il mirror anche dell’installer del dispositivo (ironflock-init) e del relativo script di installazione: un nuovo dispositivo edge che raggiunge soltanto l’Appliance può quindi essere comunque registrato. In Impostazioni Progetto → Dispositivi → Nuovo Dispositivo i comandi mostrati puntano già all’Appliance — http://<appliance-host>:15002/dl/... in modalità semplice (IP), https://registry.<appliance-domain>/dl/... in modalità dominio:

• Linux: il comando su una riga ha la forma curl -fsSL <base>/device-init/install.sh | sudo IRONFLOCK_DL_BASE=<base> bash -s -- -c <file>.flock. Copia prima sul dispositivo il suo file .flock. ironflock-init ricava la base di download dal file .flock; --download-base la sovrascrive.
• Windows: scarica device-agent.exe da <base>/device-agent/windows/amd64/latest/device-agent.exe e installa il servizio come descritto in Collegare i Dispositivi.

Prerequisito per un dispositivo senza accesso a internet: Docker (Engine + plugin Compose) e i pacchetti di base devono essere già installati. L’Appliance esegue il mirror dei binari propri di IronFlock, non dei pacchetti della distribuzione — ironflock-init prova a raggiungere get.docker.com solo se Docker manca.

L’archivio dell’installer viene aggiornato insieme al mirror dell’agent — stesso ciclo di 6 ore, stesso pulsante Sincronizza ora.