💾 Agent na TrueNAS

Jeśli masz w warsztacie TrueNAS, masz już gdzie umieścić agenta lokalnego: jest włączony przez cały dzień i jest w tej samej sieci co twoje drukarki. Agent działa jako kolejna aplikacja TrueNAS, obok tych, które już masz.

Ta strona wyjaśnia, jak go zainstalować, powiązać z warsztatem, aktualizować, przenieść i usunąć. Czym jest agent i jakie drukarki podłącza, znajdziesz w Agent lokalny.

---

Zanim zaczniesz

Czego potrzebujesz	Jak to sprawdzić
TrueNAS 24.10 lub nowszy (Community Edition)	W TrueNAS: Dashboard → System Information → Version. Starsze wersje nie mają Install via YAML.
Włączone aplikacje TrueNAS	W Apps na górze widać Apps Service Running. Jeśli robisz to pierwszy raz, TrueNAS poprosi cię o wybranie puli, w której mają być przechowywane.
Logowanie do TrueNAS jako administrator	Tylko administrator może instalować aplikacje.
Bycie właścicielem warsztatu w BolloPrint	Przy powiązywaniu pojawiają się tylko warsztaty, których jesteś właścicielem.
TrueNAS i drukarki w tej samej sieci	Jeśli są w oddzielnych sieciach, agent działa tak samo, ale drukarki trzeba będzie dodać po ich IP.
TrueNAS z dostępem do internetu	Nic więcej: nie trzeba otwierać portów ani mieć stałego IP.

---

1. Skopiuj YAML z BolloPrint

W BolloPrint przejdź do Ustawienia → Drukarki → Agent lokalny → Nowy agent i wybierz TrueNAS.

Zobaczysz kroki, a pod nimi ramkę z YAML-em: tekstem, który mówi TrueNAS, co ma zainstalować. Kliknij Kopiuj.

Na tym ekranie nie trzeba niczego tworzyć: YAML jest taki sam dla wszystkich warsztatów i nie zawiera kluczy. Agent powstaje dopiero wtedy, gdy go powiążesz, w kroku 3.

Jeśli chcesz wiedzieć, co robi, YAML wygląda tak (zawsze kopiuj ten z BolloPrint, bo ma właściwą wersję w wierszu image:):

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 umieszcza agenta w sieci twojego TrueNAS: dzięki temu znajduje drukarki.
• BP_LINK_LISTEN otwiera jego stronę na porcie 8257, a x-portals dodaje w TrueNAS przycisk Web UI.
• data to folder, w którym agent zapisuje swoją tożsamość i powiązanie. Przetrwa restarty i aktualizacje.

---

2. Zainstaluj go w TrueNAS

1. Zaloguj się do TrueNAS i otwórz Apps.
2. Kliknij Discover Apps.
3. W prawym górnym rogu, obok Custom App, otwórz menu ⋮ i wybierz Install via YAML.
4. W polu Name wpisz bolloprint-agent.
5. W polu Custom Config wklej skopiowany YAML.
6. Kliknij Save.

TrueNAS pobiera agenta i go uruchamia. Po minucie pojawia się w Apps → Installed jako Running.

---

3. Powiąż go ze swoim warsztatem

1. W Apps → Installed kliknij bolloprint-agent. Po prawej, w Application Info, kliknij Web UI. Strona agenta otworzy się w nowej karcie.
2. Na stronie widać komunikat „Ten agent nie należy jeszcze do żadnego warsztatu” i ośmioznakowy kod, np. 6E7B-9DEF. Kliknij Powiąż z BolloPrint.
3. Otworzy się BolloPrint. Jeśli nie jesteś zalogowany, zaloguj się. Wybierz warsztat, do którego go dodajesz.
4. BolloPrint pokaże ci urządzenie (nazwę twojego TrueNAS i „TrueNAS”) oraz kod. Sprawdź, czy jest taki sam jak na stronie agenta, nadaj agentowi nazwę i kliknij Dodaj do warsztatu.
5. Wracasz do BolloPrint, do listy agentów. Strona agenta pokazuje teraz Powiązany z i nazwę twojego warsztatu.

Gotowe. W Ustawienia → Drukarki → Agent lokalny zobaczysz agenta z logo TrueNAS, ze statusem Online.

---

4. Daj mu drukarki

Agent zaczyna szukać drukarek w twojej sieci, gdy tylko zostanie powiązany. To, co znajdzie, pojawia się w sekcji Drukarki w sieci lokalnej, pod listą agentów, i stamtąd je dodajesz. Te, które nie pojawią się same, dodasz przyciskiem Dodaj po IP.

Jak to zrobić dla każdej marki, znajdziesz w Drukarki w sieci lokalnej.

---

Aktualizacja

Nie musisz nic robić. Agent aktualizuje się sam: gdy wychodzi nowa wersja, pobiera ją, sprawdza, czy pochodzi od nas, i uruchamia się z nią ponownie. Zapisuje ją w swoim folderze danych, więc zostaje przy tej wersji nawet po ponownym uruchomieniu aplikacji lub TrueNAS.

Dlatego w TrueNAS aplikacja nadal pokazuje Up to date, a wiersz image: w jej YAML-u się nie zmienia: to wersja, z którą została zainstalowana, a nie ta, która działa. Tę, która działa, widzisz w BolloPrint, przy agencie.

Tylko jeśli BolloPrint powiadomi cię, że ten agent wymaga ręcznej aktualizacji:

1. W Apps → Installed kliknij bolloprint-agent, a potem Edit.
2. W Custom Config zmień tylko wersję na końcu wiersza image: na tę, którą BolloPrint pokazuje w Nowy agent → TrueNAS. Niczego więcej nie ruszaj.
3. Kliknij Save.

Agent pozostaje powiązany z tym samym warsztatem, z tymi samymi drukarkami i ich historią. Nie trzeba niczego powiązywać ponownie.

---

Przeniesienie na inne urządzenie lub ponowna instalacja

Agent instalowany od zera, na innym urządzeniu albo na tym samym po usunięciu, to nowy agent:

1. Zainstaluj go i powiąż jak w krokach od 1 do 3.
2. Dodaj swoje drukarki do nowego agenta: przechodzą do niego razem ze swoją historią.
3. Usuń starego agenta w BolloPrint (Ustawienia → Drukarki → Agent lokalny, menu ⋮ agenta → Usuń).

---

Usunięcie

1. W BolloPrint usuń agenta: Ustawienia → Drukarki → Agent lokalny, menu ⋮ agenta → Usuń. Po kilku sekundach agent się o tym dowiaduje, a jego strona znów proponuje Powiąż z BolloPrint.
2. W TrueNAS: Apps → Installed → bolloprint-agent → Delete.

Jeśli usuniesz go tylko w TrueNAS, w BolloPrint nadal będzie widoczny jako Rozłączony, dopóki nie usuniesz go także tam.

---

Jeśli coś nie działa

Co widzisz	Co zrobić
Nie możesz znaleźć Install via YAML	Twój TrueNAS jest starszy niż 24.10 albo aplikacje nie są włączone (w Apps wybierz pulę, o którą prosi).
Aplikacja nie wychodzi poza Deploying albo zatrzymuje się na Stopped	TrueNAS nie ma dostępu do internetu, żeby pobrać agenta. Sprawdź sieć TrueNAS i uruchom aplikację ponownie z Apps → Installed.
Web UI otwiera stronę, która się nie ładuje	Inna aplikacja używa już portu 8257. W Edit zmień ":8257" na ":8364" i port: 8257 niżej na port: 8364, oba, i kliknij Save.
Kod w BolloPrint nie zgadza się z kodem na stronie	Nie potwierdzaj. Wróć na stronę agenta i ponownie kliknij Powiąż z BolloPrint.
Agent ma w BolloPrint status Rozłączony	Sprawdź w TrueNAS, czy aplikacja ma status Running i czy TrueNAS ma dostęp do internetu. Jej log znajdziesz w Apps → Installed → bolloprint-agent → Workloads, pod ikoną logów.
Jest powiązany, ale nie znajduje drukarek	TrueNAS i drukarki muszą być w tej samej sieci. Jeśli nie są, dodaj je przyciskiem Dodaj po IP.