🚀 Instalar o agente
Como pôr em funcionamento um agente local pela primeira vez: onde o instalar, como o criar no BolloPrint e como o arrancar no teu equipamento. Se já o tens a funcionar e o BolloPrint te avisa de que há uma versão nova, o que procuras é Atualizar o agente.
Onde o pôr
Em qualquer equipamento da oficina que esteja sempre ligado e na mesma rede que as impressoras:
- um NAS (Synology, QNAP…),
- um mini-PC ou um PC da oficina,
- um Raspberry Pi,
- um servidor que já tenhas.
Precisa de Docker (ou Portainer, que é Docker com ecrã). Consome muito pouco: entre 10 e 20 MB de memória.
💡 O ideal é que esteja na MESMA rede que as impressoras
Se o agente está numa rede e as impressoras noutra (VLAN separadas, rede de convidados, wi-fi à parte), não é que deixe de funcionar: o que se perde é a deteção automática, porque esse aviso de «estou aqui» não atravessa de uma rede para a outra.
As impressoras acrescentam-se então à mão, pelo seu IP, e funcionam na mesma — com todas as suas capacidades, seja qual for a marca. A única coisa imprescindível é que as duas redes se possam falar (que o router ou a firewall deixe passar o tráfego entre elas).
No Docker Desktop (Windows e Mac) não há deteção automática. Esses sistemas não deixam o contentor ver a rede do equipamento, por isso as impressoras têm de ser acrescentadas à mão, por IP. Tal como no caso das redes separadas: funcionam exatamente igual, só há um passo a mais ao registá-las.
Criá-lo no BolloPrint
- Vai a Configurações → Impressoras e abre o separador Agente local.
- Prime Novo agente e dá-lhe um nome que reconheças. Melhor onde está do que o que é: «Rés do chão», «Pavilhão 2».
- Prime Criar agente.
- No segundo passo aparece o manifesto de instalação, com o código do agente e a sua identidade já escritos lá dentro. Escolhe Docker Compose ou Kubernetes e prime Copiar. Não há nada a substituir.
🔐 As chaves são mostradas uma só vez
Copia o manifesto nesse momento. As chaves não expiram, mas não voltamos a mostrá-las. Se o perderes, abre o agente com Editar e, em Instalação, usa Regenerar chaves.
Copia sempre o bloco a partir do ecrã, não de um email antigo nem de um apontamento: aí vai a versão do agente que é a certa em cada momento.
Arrancá-lo no teu equipamento
Escolhe a forma que usas. Nas três, o manifesto vai tal como está, sem tocar em nada.
Docker Compose
- Cria uma pasta para o agente, por exemplo
bolloprint-agent. - Dentro, guarda o manifesto como
docker-compose.yml. - A partir dessa pasta, arranca-o:
docker compose up -d
Portainer
- Vai a Stacks → Add stack e dá-lhe um nome, por exemplo
bolloprint-agent. - Em Web editor, cola o manifesto de Docker Compose tal como está.
- Prime Deploy the stack.
Kubernetes
- Guarda o manifesto de Kubernetes num ficheiro, por exemplo
bolloprint-agent.yaml. - Aplica-o:
kubectl apply -f bolloprint-agent.yaml
Depois volta ao BolloPrint e prime Guardar na janela do agente.
Confirmar que funciona
Em menos de um minuto, o agente aparece Online no separador Agente local. Não te vai pedir autorização: essa instalação já vem autorizada.
Se não aparecer, vê o seu registo no equipamento onde corre:
docker logs bolloprint_agent --tail 50
| O que se passa | O que ver |
|---|---|
| Nunca aparece | O manifesto foi colado por completo, sem alterações? O equipamento chega à internet? Há alguma firewall a bloquear a saída? |
| Aparece, mas pede autorização | O manifesto não leva BP_AGENT_INSTANCE_ID (foi editado à mão ou é antigo). Regenera as chaves e instala o manifesto novo tal como está. |
| Está online mas não encontra impressoras | Se estiver numa rede diferente da das impressoras ou usares o Docker Desktop, é o esperado: acrescenta-as com Adicionar por IP. |
Não é preciso abrir portas no router, nem pedir IP fixo, nem tocar na firewall: é o agente que se liga ao BolloPrint, não o contrário.
Com o agente online, o passo seguinte é ligar as tuas impressoras: tens isso em Impressoras por rede local.