🚀 Déployer l'agent
Comment mettre en marche un agent local pour la première fois : où l'installer, comment le créer dans BolloPrint et comment le démarrer sur votre poste. Si vous l'avez déjà en fonctionnement et que BolloPrint vous avertit qu'une nouvelle version est disponible, ce que vous cherchez, c'est Mettre à jour l'agent.
Où le placer
Sur n'importe quel poste de l'atelier qui reste toujours allumé et se trouve sur le même réseau que les imprimantes :
- un NAS (Synology, QNAP…),
- un mini-PC ou un PC de l'atelier,
- un Raspberry Pi,
- un serveur que vous avez déjà.
Il a besoin de Docker (ou de Portainer, qui est Docker avec une interface). Il consomme très peu : entre 10 et 20 Mo de mémoire.
💡 L'idéal est qu'il soit sur le MÊME réseau que les imprimantes
Si l'agent est sur un réseau et les imprimantes sur un autre (VLAN séparés, réseau invité, wifi à part), ce n'est pas qu'il cesse de fonctionner : ce que l'on perd, c'est la découverte automatique, parce que cette annonce « je suis là » ne traverse pas d'un réseau à l'autre.
Les imprimantes s'ajoutent alors à la main, par leur IP, et fonctionnent pareil — avec toutes leurs fonctionnalités, quelle que soit la marque. La seule chose indispensable est que les deux réseaux puissent se parler (que le routeur ou le pare-feu laisse passer le trafic entre eux).
Sur Docker Desktop (Windows et Mac), il n'y a pas de découverte automatique. Ces systèmes ne laissent pas le conteneur voir le réseau du poste : les imprimantes doivent donc être ajoutées à la main, par IP. Comme dans le cas des réseaux séparés : elles fonctionnent exactement pareil, il y a juste une étape de plus au moment de les enregistrer.
Le créer dans BolloPrint
- Allez dans Paramètres → Imprimantes et ouvrez l'onglet Agent local.
- Appuyez sur Nouvel agent et donnez-lui un nom que vous reconnaîtrez. Mieux vaut où il est que ce qu'il est : « Rez-de-chaussée », « Atelier 2 ».
- Appuyez sur Créer l'agent.
- À la deuxième étape apparaît le manifeste de déploiement, avec le code de l'agent et son identité déjà écrits dedans. Choisissez Docker Compose ou Kubernetes et appuyez sur Copier. Il n'y a rien à remplacer.
🔐 Les clés ne sont affichées qu'une seule fois
Copiez le manifeste à ce moment-là. Les clés n'expirent pas, mais nous ne les montrerons plus. Si vous le perdez, ouvrez l'agent avec Modifier et, dans Déploiement, utilisez Régénérer les clés.
Copiez toujours le bloc depuis l'écran, pas depuis un vieil e-mail ni depuis une note : c'est là que figure la version de l'agent qui convient à chaque instant.
Le démarrer sur votre poste
Choisissez la méthode que vous utilisez. Dans les trois, le manifeste s'utilise tel quel, sans rien changer.
Docker Compose
- Créez un dossier pour l'agent, par exemple
bolloprint-agent. - À l'intérieur, enregistrez le manifeste sous le nom
docker-compose.yml. - Depuis ce dossier, démarrez-le :
docker compose up -d
Portainer
- Allez dans Stacks → Add stack et donnez-lui un nom, par exemple
bolloprint-agent. - Dans Web editor, collez le manifeste de Docker Compose tel quel.
- Appuyez sur Deploy the stack.
Kubernetes
- Enregistrez le manifeste de Kubernetes dans un fichier, par exemple
bolloprint-agent.yaml. - Appliquez-le :
kubectl apply -f bolloprint-agent.yaml
Revenez ensuite dans BolloPrint et appuyez sur Enregistrer dans la fenêtre de l'agent.
Vérifier que ça fonctionne
En moins d'une minute, l'agent apparaît En ligne dans l'onglet Agent local. Il ne vous demandera pas d'autorisation : cette installation est déjà autorisée.
S'il n'apparaît pas, regardez son journal sur le poste où il tourne :
docker logs bolloprint_agent --tail 50
| Ce qui se passe | Que regarder |
|---|---|
| Il n'apparaît jamais | Le manifeste a-t-il été collé en entier, sans modification ? Le poste atteint-il internet ? Un pare-feu bloque-t-il la sortie ? |
| Il apparaît, mais demande une autorisation | Le manifeste ne contient pas BP_AGENT_INSTANCE_ID (il a été modifié à la main ou il est ancien). Régénérez les clés et déployez le nouveau manifeste tel quel. |
| Il est en ligne mais ne trouve aucune imprimante | S'il est sur un réseau différent des imprimantes ou si vous utilisez Docker Desktop, c'est le comportement attendu : ajoutez-les avec Ajouter par IP. |
Il n'y a pas de ports à ouvrir sur le routeur, ni d'IP fixe à demander, ni de pare-feu à configurer : c'est l'agent qui appelle BolloPrint, et non l'inverse.
Une fois l'agent en ligne, l'étape suivante consiste à connecter vos imprimantes : c'est dans Imprimantes en réseau local.