Skip to main content

Zlecenia Opiekuna (aktualizacje węzłów)

Zlecenia Opiekuna (aktualizacje węzłów, stan 17.11.2026)

Użytkownik zleca z kokpitu (CT163). Agent Opiekun wykonuje na węźle /usr/local/sbin/aktualizuj-wezel w trybie dry albo run. Skrypt nigdy nie restartuje węzła. Wynik wraca na kartę sprawy; użytkownik go czyta i zatwierdza.

Które sprawy

  • Typ aktualizacja, tytuł „N paczek do aktualizacji”, węzeł z listy: saturn, naptun, merkury, jowisz, slonce, mars, grws1.
  • Pozostałe sprawy aktualizacji (np. wtyczki z kanału J-Tools) nie dostają przycisków.

Karta sprawy

  • „Zleć Opiekunowi: zaktualizuj” i „Zleć symulację”, gdy węzeł nie ma aktywnego zlecenia.
  • Blok „Zlecenie Opiekuna #N” ze stanem (zlecone i czeka, w toku, zakończone z wynikiem) i pełnym raportem (escapowany).
  • Żółty pasek „WYMAGANY RESTART WĘZŁA, osobna decyzja”, gdy raport ma „restart wezla wymagany: TAK”. Kokpit nie restartuje.
  • Po wyniku: „Zatwierdzam wynik (zamknij sprawę)”, „Ponów”, „Przypomnij”, „Zignoruj”. Przy czekającym zleceniu: „Anuluj zlecenie”.
  • Linia „Kolejka Opiekuna” nad sprawami. Strona odświeża się co 30 s, gdy coś czeka albo trwa.

Kto może zlecić

  • Symulację: każdy z dostępem do kokpitu. Hub sam tworzy automatyczną symulację.
  • Aktualizację (także „Ponów”): tylko żądanie przez Cloudflare Access (konektor CT134). Bez nagłówka z e-mailem zlecającego żądanie dostaje 403. Z LAN, VPN i od agentów też 403.

Automatyczna symulacja

  • Gdy sprawa jest otwarta bez zleceń („nowa sprawa”) albo zmienia się liczba paczek.
  • Najwyżej jedna automatyczna na sprawę na dobę. Nigdy przy aktywnym zleceniu węzła.

Zasady

  • W całym systemie jedno zadanie w toku. Na węzeł jedno aktywne zlecenie. Pilnują tego unikalne indeksy w bazie.
  • Zadanie w toku dłużej niż 90 minut: BLAD „brak odpowiedzi Opiekuna”. Spóźniony wynik hub przyjmuje z adnotacją.
  • Wyniki: symulacja SYMULACJA, BRAK, BLAD, ODMOWA; aktualizacja OK, BRAK, BLAD, ODMOWA.
  • Zamknięcie sprawy („Wykonane”, „Zignoruj”, „ustąpiła”) anuluje jej czekające zlecenia.
  • Log (tabela log): zadanie-zlecone, zadanie-start, zadanie-wynik, zadanie-przekroczony-czas, zadanie-anulowane, zadanie-zatwierdzone.

API dla Opiekuna (port 8090, tylko z 10.30.7.162)

  • GET /api/zadania?stan=zlecone: czekające, od najstarszego; mozna_zaczac: true, gdy nic nie jest w toku.
  • GET /api/zadania?stan=w_toku, GET /api/zadania?stan=wykonane, GET /api/zadania/<id>.
  • POST /api/zadania/<id>/start: zlecone → w toku; 409, gdy inne jest w toku.
  • POST /api/zadania/<id>/wynik: w toku → wykonane; JSON {"wynik": "...", "tekst": "..."}.
  • Brak adresu do tworzenia zleceń, restartu i wykonywania poleceń (404).

Webhook do Opiekuna (od 16.11, 23:45)

  • Wdrożony na hubie (raport Programisty), test na kopii bazy: 36 z 36 sprawdzeń. Przy każdym zleceniu hub wysyła zdarzenie do OpenBot po zapisie zlecenia.
  • Stan 16.11 (raport Programisty): nieaktywny, bo brak pliku sekretu /etc/wpisy/openbot-webhook-opiekun.secret. Hub wtedy nic nie wysyłał, a zdarzenie dostawało status „pominiete”. Adres jest w /etc/wpisy/openbot-webhook-opiekun.url.
  • Stan 17.11 (zlecenia-agentow.md, wiersz Opiekuna): webhook działa od 17.11 08:53 (czas bez strefy). Nie zweryfikowano na hubie ani w OpenBot.
  • Aktywacja: użytkownik generuje sekret w ustawieniach rutyn OpenBot, Klaudiusz zapisuje go na hubie i w Vaultwarden. Pierwsze zlecenie pokaże wynik na karcie (401: zły sekret, 404: brak rutyny).
  • Opiekun pobiera zlecenia z /api/zadania. Rutyna zapasowa wg zlecenia-agentow.md z 17.11: co 15 minut (webhook działa, jak wyżej).
  • Nie zweryfikowano: prawdziwe wysłanie do OpenBot (brak sekretu w chwili raportu).

Stan (raport Programisty, 16.11 ok. 21:15)

  • Testy na kopii: 60 z 60 sprawdzeń OK (testy/test_zadania_infra_ct163.py). Węzłów nie dotykano.
  • Produkcja: 7 automatycznych symulacji w kolejce (zlecenia #1–#7, sprawy 75, 76, 77, 84, 85, 87, 89), nic w toku. Pierwsza próba: zlecenie #2 (jowisz, symulacja).
  • Nie zweryfikowano: pracy prawdziwego Opiekuna i skryptu na węźle; logowania przez Cloudflare Access na żywo (w teście nagłówek był symulowany).

Ostatnia aktualizacja: 17.11.2026 13:00 UTC, źródło: zlecenia-agentow.md (webhook i rutyna zapasowa, 17.11), Shared/hub-wpisy/README.md (Webhook do Opiekuna)