💾 Agent na TrueNAS

Pokud máte v dílně TrueNAS, máte už kam umístit místního agenta: je zapnutý celý den a ve stejné síti jako vaše tiskárny. Agent běží jako další aplikace TrueNAS, vedle těch, které už máte.

Tato stránka vysvětluje, jak ho nainstalovat, propojit s dílnou, aktualizovat, přesunout a odebrat. Co je agent a které tiskárny připojuje, najdete na stránce Místní agent.

---

Než začnete

Co potřebujete	Jak to ověříte
TrueNAS 24.10 nebo novější (Community Edition)	V TrueNAS: Dashboard → System Information → Version. Starší verze Install via YAML nemají.
Zapnuté aplikace TrueNAS	V Apps je nahoře vidět Apps Service Running. Pokud to děláte poprvé, TrueNAS vás požádá o výběr poolu, kam je ukládat.
Přihlášení do TrueNAS jako správce	Aplikace může instalovat jen správce.
Jste vlastníkem dílny v BolloPrint	Při propojování se zobrazí jen dílny, jejichž jste vlastníkem.
TrueNAS a tiskárny jsou ve stejné síti	Pokud jsou v oddělených sítích, agent funguje stejně, ale tiskárny budete muset přidat podle IP adresy.
TrueNAS má přístup k internetu	Nic dalšího: není potřeba otevírat porty ani mít pevnou IP adresu.

---

1. Zkopírujte YAML z BolloPrint

V BolloPrint přejděte do Nastavení → Tiskárny → Místní agent → Nový agent a zvolte TrueNAS.

Uvidíte postup a pod ním rámeček s YAML: textem, který TrueNAS říká, co má nainstalovat. Klikněte na Kopírovat.

Na této obrazovce není potřeba nic vytvářet: YAML je stejný pro všechny dílny a neobsahuje žádné klíče. Agent vznikne, až ho propojíte, v kroku 3.

Pokud vás zajímá, co dělá, YAML vypadá takto (kopírujte vždy ten z BolloPrint, který má na řádku image: správnou verzi):

services:
  bolloprint-agent:
    image: ghcr.io/bolloprint/bolloprint-agent:XXXX
    restart: unless-stopped
    network_mode: host
    mem_limit: 512m
    pids_limit: 512
    ulimits:
      nofile:
        soft: 65536
        hard: 65536
    environment:
      BP_PLATFORM: truenas
      BP_LINK_LISTEN: ":8257"
    volumes:
      - data:/var/lib/bolloprint

volumes:
  data:

x-portals:
  - name: Web UI
    scheme: http
    host: 0.0.0.0
    port: 8257
    path: /

• network_mode: host umístí agenta do sítě vašeho TrueNAS: díky tomu najde tiskárny.
• BP_LINK_LISTEN otevře jeho stránku na portu 8257 a x-portals přidá v TrueNAS tlačítko Web UI.
• data je složka, kam agent ukládá svou identitu a své propojení. Přežije restarty i aktualizace.

---

2. Nainstalujte ho v TrueNAS

1. Přihlaste se do TrueNAS a otevřete Apps.
2. Klikněte na Discover Apps.
3. Vpravo nahoře vedle Custom App otevřete nabídku ⋮ a zvolte Install via YAML.
4. Do pole Name napište bolloprint-agent.
5. Do pole Custom Config vložte zkopírovaný YAML.
6. Klikněte na Save.

TrueNAS agenta stáhne a spustí. Do minuty se objeví v Apps → Installed jako Running.

---

3. Propojte ho se svou dílnou

1. V Apps → Installed klikněte na bolloprint-agent. Vpravo v Application Info klikněte na Web UI. Stránka agenta se otevře na nové kartě.
2. Na stránce je text „Tento agent zatím nepatří k žádné dílně“ a osmiznakový kód, například 6E7B-9DEF. Klikněte na Propojit s BolloPrint.
3. Otevře se BolloPrint. Pokud nejste přihlášeni, přihlaste se. Zvolte dílnu, do které agenta přidáváte.
4. BolloPrint vám ukáže zařízení (název vašeho TrueNAS a „TrueNAS“) a kód. Zkontrolujte, že je stejný jako na stránce agenta, pojmenujte agenta a klikněte na Přidat do dílny.
5. Vrátíte se do BolloPrint, na seznam agentů. Stránka agenta teď ukazuje Propojeno s a název vaší dílny.

Hotovo. V Nastavení → Tiskárny → Místní agent uvidíte agenta s logem TrueNAS ve stavu Online.

---

4. Dejte mu tiskárny

Agent začne hledat tiskárny ve vaší síti hned po propojení. Co najde, se zobrazí v části Tiskárny v místní síti pod seznamem agentů a odtud je přidáte. Ty, které se neobjeví samy, přidáte přes Přidat podle IP.

Jak na to u jednotlivých značek, najdete na stránce Tiskárny v místní síti.

---

Aktualizace

Nemusíte nic dělat. Agent se aktualizuje sám: když vyjde nová verze, stáhne ji, ověří, že je od nás, a restartuje se s ní. Ukládá ji do své datové složky, takže na této verzi zůstane, i když restartujete aplikaci nebo TrueNAS.

Proto aplikace v TrueNAS dál ukazuje Up to date a řádek image: v jejím YAML se nemění: je to verze, se kterou byla nainstalována, ne ta, která právě běží. Tu, která běží, uvidíte v BolloPrint u agenta.

Jen pokud vás BolloPrint upozorní, že tento agent potřebuje ruční aktualizaci:

1. V Apps → Installed klikněte na bolloprint-agent a pak na Edit.
2. V Custom Config změňte jen verzi na konci řádku image: na tu, kterou BolloPrint ukazuje v Nový agent → TrueNAS. Nic jiného neměňte.
3. Klikněte na Save.

Agent zůstane propojený se stejnou dílnou, se stejnými tiskárnami i jejich historií. Nic není potřeba propojovat znovu.

---

Přesun na jiné zařízení nebo přeinstalace

Agent nainstalovaný od nuly, na jiném zařízení nebo na stejném po smazání, je nový agent:

1. Nainstalujte a propojte ho jako v krocích 1 až 3.
2. Přidejte své tiskárny k novému agentovi: přejdou k němu i se svou historií.
3. Starého agenta v BolloPrint smažte (Nastavení → Tiskárny → Místní agent, nabídka ⋮ agenta → Smazat).

---

Odebrání

1. V BolloPrint agenta smažte: Nastavení → Tiskárny → Místní agent, nabídka ⋮ agenta → Smazat. Během několika sekund se to agent dozví a jeho stránka znovu nabídne Propojit s BolloPrint.
2. V TrueNAS: Apps → Installed → bolloprint-agent → Delete.

Pokud ho smažete jen v TrueNAS, v BolloPrint se bude dál zobrazovat jako Odpojeno, dokud ho nesmažete i tam.

---

Když něco nefunguje

Co vidíte	Co udělat
Nemůžete najít Install via YAML	Váš TrueNAS je starší než 24.10, nebo nejsou zapnuté aplikace (v Apps zvolte pool, o který vás požádá).
Aplikace se nedostane dál než do stavu Deploying nebo zůstane ve stavu Stopped	TrueNAS se nedostane na internet, aby agenta stáhl. Zkontrolujte síť TrueNAS a aplikaci znovu spusťte z Apps → Installed.
Web UI otevře stránku, která se nenačte	Port 8257 už používá jiná aplikace. V Edit změňte ":8257" na ":8364" a níže port: 8257 na port: 8364, obojí, a klikněte na Save.
Kód v BolloPrint se neshoduje s kódem na stránce	Nepotvrzujte. Vraťte se na stránku agenta a znovu klikněte na Propojit s BolloPrint.
Agent je v BolloPrint ve stavu Odpojeno	Zkontrolujte v TrueNAS, že aplikace je ve stavu Running a že TrueNAS má přístup k internetu. Její protokol najdete v Apps → Installed → bolloprint-agent → Workloads pod ikonou protokolů.
Je propojený, ale nenachází tiskárny	TrueNAS a tiskárny musí být ve stejné síti. Pokud nejsou, přidejte je přes Přidat podle IP.