🚀 Installare l'agente
Come mettere in funzione un agente locale per la prima volta: dove installarlo, come crearlo in BolloPrint e come avviarlo sul tuo computer. Se lo hai già funzionante e BolloPrint ti avvisa che c'è una versione nuova, quello che cerchi è Aggiornare l'agente.
Dove metterlo
Su qualsiasi computer del laboratorio che sia sempre acceso e nella stessa rete delle stampanti:
- un NAS (Synology, QNAP…),
- un mini-PC o un PC del laboratorio,
- un Raspberry Pi,
- un server che hai già.
Ha bisogno di Docker (o Portainer, che è Docker con l'interfaccia). Consuma pochissimo: tra 10 e 20 MB di memoria.
💡 L'ideale è che stia nella STESSA rete delle stampanti
Se l'agente sta su una rete e le stampanti su un'altra (VLAN separate, rete ospiti, wifi a parte), non è che smetta di funzionare: quello che si perde è la scoperta automatica, perché quell'annuncio di «sono qui» non passa da una rete all'altra.
Le stampanti si aggiungono allora a mano, tramite il loro IP, e funzionano lo stesso — con tutte le loro prestazioni, di qualunque marca siano. L'unica cosa indispensabile è che le due reti possano parlarsi (che il router o il firewall lascino passare il traffico tra loro).
Su Docker Desktop (Windows e Mac) non c'è scoperta automatica. Quei sistemi non lasciano che il contenitore veda la rete del computer, quindi le stampanti vanno aggiunte a mano, tramite IP. Come nel caso delle reti separate: funzionano esattamente uguale, c'è solo un passaggio in più al momento di registrarle.
Crearlo in BolloPrint
- Vai su Impostazioni → Stampanti e apri la scheda Agente locale.
- Premi Nuovo agente e dagli un nome che riconosci. Meglio dov'è che cos'è: «Piano terra», «Capannone 2».
- Premi Crea agente.
- Nel secondo passo compare il manifesto di installazione, con il codice dell'agente e la sua identità già scritti dentro. Scegli Docker Compose o Kubernetes e premi Copia. Non c'è nulla da sostituire.
🔐 Le chiavi si mostrano una volta sola
Copia il manifesto in quel momento. Le chiavi non scadono, ma non te le mostreremo di nuovo. Se lo perdi, apri l'agente con Modifica e, in Installazione, usa Rigenera le chiavi.
Copia sempre il blocco dalla schermata, non da una vecchia email né da un appunto: lì c'è la versione dell'agente corretta in ogni momento.
Avviarlo sul tuo computer
Scegli il modo che usi. In tutti e tre, il manifesto va così com'è, senza toccare nulla.
Docker Compose
- Crea una cartella per l'agente, per esempio
bolloprint-agent. - Dentro, salva il manifesto come
docker-compose.yml. - Da quella cartella, avvialo:
docker compose up -d
Portainer
- Vai su Stacks → Add stack e dagli un nome, per esempio
bolloprint-agent. - In Web editor, incolla il manifesto di Docker Compose così com'è.
- Premi Deploy the stack.
Kubernetes
- Salva il manifesto di Kubernetes in un file, per esempio
bolloprint-agent.yaml. - Applicalo:
kubectl apply -f bolloprint-agent.yaml
Torna poi in BolloPrint e premi Salva nella finestra dell'agente.
Verificare che funzioni
In meno di un minuto, l'agente compare Online nella scheda Agente locale. Non ti chiederà l'autorizzazione: quell'installazione è già autorizzata.
Se non compare, guarda il suo registro sul computer dove gira:
docker logs bolloprint_agent --tail 50
| Cosa succede | Cosa guardare |
|---|---|
| Non compare mai | Il manifesto è stato incollato per intero, senza modifiche? Il computer arriva a internet? C'è un firewall che blocca l'uscita? |
| Compare, ma chiede l'autorizzazione | Il manifesto non contiene BP_AGENT_INSTANCE_ID (è stato modificato a mano o è di prima). Rigenera le chiavi e installa il nuovo manifesto così com'è. |
| È online ma non trova stampanti | Se sta su un'altra rete rispetto alle stampanti o usi Docker Desktop, è quello che ci si aspetta: aggiungile con Aggiungi per IP. |
Non bisogna aprire porte sul router, né chiedere un IP fisso, né toccare il firewall: l'agente chiama BolloPrint, non il contrario.
Con l'agente online, il passo successivo è collegare le tue stampanti: lo trovi in Stampanti in rete locale.