Índice del manual

🔄 Actualizar el agente

Cuando sale una versión nueva del agente local, BolloPrint te avisa, pero la actualización se hace en tu equipo, no desde BolloPrint: el agente corre en tu red y solo tú puedes cambiarlo. Es cambiar un número en tu fichero y volver a desplegar. Tus impresoras, su historial y las claves del agente no se tocan.

Cómo sabes que toca

Encima de las pestañas de Configuración → Impresoras aparece un aviso: «Tu agente usa la versión 0.4.7. Ya está disponible la 0.4.9», con el botón Cómo actualizar, que trae aquí.
En la pestaña Agente local, el número de versión de ese agente sale en naranja. Si sale en rojo, esa versión ya no está soportada y conviene actualizar cuanto antes.

La versión nueva la ves siempre en la pestaña Despliegue del agente (menú ⋮ → Editar): es el número que hay al final de la línea image:.

Qué cambia

Solo cambia la línea image:, y dentro de ella solo el número de versión. Todo lo demás se queda exactamente igual: el código, la identidad, el volumen y el resto de la configuración.

Así quedaría un docker-compose.yml al pasar de la 0.4.7 a la 0.4.9 (las claves aparecen con puntos, pero en tu fichero son las tuyas):

Antes

services:
  bolloprint-agent:
    image: ghcr.io/bolloprint/bolloprint-agent:0.4.7
    container_name: bolloprint_agent
    restart: unless-stopped
    network_mode: host
    environment:
      BP_AGENT_CODE: ••••••••••••••••
      BP_AGENT_INSTANCE_ID: ••••••••••••••••
    volumes:
      - identity:/var/lib/bolloprint

volumes:
  identity:
    name: bolloprint_agent_identity

Después

services:
  bolloprint-agent:
    image: ghcr.io/bolloprint/bolloprint-agent:0.4.9
    container_name: bolloprint_agent
    restart: unless-stopped
    network_mode: host
    environment:
      BP_AGENT_CODE: ••••••••••••••••
      BP_AGENT_INSTANCE_ID: ••••••••••••••••
    volumes:
      - identity:/var/lib/bolloprint

volumes:
  identity:
    name: bolloprint_agent_identity

(Tu fichero tiene algunas líneas más, como los límites de memoria y los registros; se quedan tal cual. Aquí se han quitado para que se vea la diferencia.)

⚠️ No copies la plantilla de la pestaña Despliegue encima de tu fichero

En un agente que ya existe, BolloPrint enseña las claves tapadas con puntos, porque no las guarda. Si pegas esa plantilla entera sobre la tuya, borras tus claves y el agente deja de conectar. Cambia solo el número de la línea image: en el fichero que ya tienes.

Paso a paso

Docker Compose

Abre el docker-compose.yml del agente y cambia el número de la línea image:.
Desde la carpeta de ese fichero, descarga la versión nueva y vuelve a arrancarlo:

docker compose pull
docker compose up -d

Docker sustituye el contenedor por uno nuevo con la misma configuración y el mismo volumen.

Portainer

Ve a Stacks y abre el stack del agente.
Pulsa Editor, cambia el número de la línea image:.
Activa Re-pull image and redeploy (o Pull latest image, según tu versión de Portainer) y pulsa Update the stack.

Kubernetes

Cambia el número de la línea image: en tu fichero y vuelve a aplicarlo:

kubectl apply -f bolloprint-agent.yaml

O, sin tocar el fichero, cambia directamente la imagen del despliegue:

kubectl set image deployment/bolloprint-agent agent=ghcr.io/bolloprint/bolloprint-agent:0.4.9

Si lo haces así, cambia también el fichero, o la próxima vez que lo apliques volverás a la versión antigua.

Comprobar que ha ido bien

En menos de un minuto el agente vuelve a salir En línea en la pestaña Agente local, con el número de versión nuevo y sin color de aviso. El aviso de encima de las pestañas desaparece solo.

Mientras el contenedor se reinicia, las impresoras pueden salir unos segundos sin conexión. Es normal: vuelven solas, y las impresiones en marcha siguen su curso en la máquina.

Si no vuelve a aparecer, mira su registro:

docker logs bolloprint_agent --tail 50

Lo que NO hay que hacer

No regeneres las claves para actualizar. Regenerar sirve cuando alguien tiene tus claves o perdiste la plantilla, y corta el agente hasta que lo despliegues otra vez.
No borres el volumen (bolloprint_agent_identity). No hace falta para actualizar, y en agentes desplegados con una plantilla antigua es donde guarda su identidad: sin él tendrías que autorizarlo otra vez.
No crees un agente nuevo. Actualizar es el mismo agente con otra versión; uno nuevo tendría otro código y sus impresoras no pasarían solas.

Preguntas frecuentes

¿Pierdo impresoras o historial al actualizar? No. Las impresoras y todo lo que imprimieron están en BolloPrint, no en el agente.

¿Puedo saltarme versiones? Sí. Pasa directamente a la última que te indique BolloPrint.

¿Y si la versión nueva me da problemas? Vuelve a poner el número anterior en la línea image: y despliega igual. Después escríbenos por Discord para que lo miremos.

¿Se actualiza solo? No, a propósito: el agente corre en tu equipo y decides tú cuándo cambia.