Skip to content

operations-runbook.md

Latest commit

 

History

History
112 lines (90 loc) · 5.27 KB

operations-runbook.md

File metadata and controls

112 lines (90 loc) · 5.27 KB

Εγχειρίδιο Λειτουργιών ZeroClaw (Operations Runbook)

Αυτό το εγχειρίδιο προορίζεται για τους διαχειριστές του συστήματος που είναι υπεύθυνοι για τη διαθεσιμότητα, την ασφάλεια και την απόκριση σε περιστατικά.

Τελευταία επαλήθευση: 18 Φεβρουαρίου 2026.

Πεδίο Εφαρμογής

Το έγγραφο καλύπτει τις καθημερινές λειτουργίες (Day-2 operations):

  • Εκκίνηση και επίβλεψη του runtime.
  • Ελέγχους καλής λειτουργίας (health checks) και διαγνωστικά.
  • Διαδικασίες ασφαλούς ανάπτυξης (rollout) και επαναφοράς (rollback).
  • Διαλογή (triage) και αποκατάσταση μετά από περιστατικά.

Για την αρχική εγκατάσταση, ανατρέξτε στον οδηγό one-click-bootstrap.md.

Λειτουργίες Χρόνου Εκτέλεσης (Runtime Modes)

Λειτουργία Εντολή Χρήση
Προσκήνιο (Foreground) zeroclaw daemon Τοπική αποσφαλμάτωση και δοκιμές.
Πύλη (Gateway) zeroclaw gateway Έλεγχος τελικών σημείων (endpoints) webhook.
Υπηρεσία Συστήματος zeroclaw service install && zeroclaw service start Μόνιμη εκτέλεση υπό τη διαχείριση του συστήματος.

Βασική Ροή Εργασίας Διαχειριστή

  1. Επικύρωση Ρυθμίσεων: 
    zeroclaw status
  2. Διαγνωστικός Έλεγχος: 
    zeroclaw doctor
zeroclaw channel doctor
  3. Εκκίνηση Daemon: 
    zeroclaw daemon
  4. Διαχείριση Υπηρεσίας: 
    zeroclaw service install
zeroclaw service start
zeroclaw service status

Δείκτες Κατάστασης και Υγείας

Δείκτης Εντολή / Αρχείο Αναμενόμενη Κατάσταση
Εγκυρότητα Ρυθμίσεων zeroclaw doctor Επιτυχής έλεγχος χωρίς κρίσιμα σφάλματα.
Συνδεσιμότητα Καναλιών zeroclaw channel doctor Όλα τα ενεργά κανάλια είναι online.
Σύνοψη Runtime zeroclaw status Εμφάνιση σωστών παρόχων και μοντέλων.
Daemon Heartbeat ~/.zeroclaw/daemon_state.json Το αρχείο ενημερώνεται σε πραγματικό χρόνο.

Καταγραφές (Logs) και Διαγνωστικά

  • macOS / Windows:
    • ~/.zeroclaw/logs/daemon.stdout.log
    • ~/.zeroclaw/logs/daemon.stderr.log
  • Linux (systemd): 
    journalctl --user -u zeroclaw.service -f

Διαλογή Περιστατικών (Incident Triage)

Σε περίπτωση δυσλειτουργίας, ακολουθήστε τα παρακάτω βήματα:

  1. Ανάλυση Κατάστασης: 
    zeroclaw status
zeroclaw doctor
zeroclaw channel doctor
  2. Έλεγχος Υπηρεσίας: 
    zeroclaw service status
  3. Επανεκκίνηση: Εάν η υπηρεσία δεν αποκρίνεται, πραγματοποιήστε καθαρή επανεκκίνηση: 
    zeroclaw service stop
zeroclaw service start
  4. Έλεγχος Διαπιστευτηρίων: Επαληθεύστε τα API keys και τις λίστες επιτρεπόμενων χρηστών στο ~/.zeroclaw/config.toml.
  5. Έλεγχος Πύλης: Επαληθεύστε τις ρυθμίσεις σύνδεσης στην ενότητα [gateway] και την τοπική συνδεσιμότητα.

Διαδικασία Αλλαγών (Safe Change Management)

  1. Δημιουργήστε αντίγραφο ασφαλείας του config.toml.
  2. Εφαρμόστε μία αλλαγή τη φορά.
  3. Εκτελέστε την εντολή zeroclaw doctor για επικύρωση.
  4. Επανεκκινήστε την υπηρεσία.
  5. Επαληθεύστε τη λειτουργία μέσω των εντολών status και channel doctor.

Διαδικασία Επαναφοράς (Rollback)

Εάν παρατηρηθεί υποβάθμιση της υπηρεσίας μετά από αλλαγή:

  1. Επαναφέρετε το προηγούμενο έγκυρο αρχείο config.toml.
  2. Επανεκκινήστε το runtime (daemon ή service).
  3. Επιβεβαιώστε την αποκατάσταση με τους ελέγχους doctor και channel doctor.
  4. Αναλύστε την αιτία του προβλήματος πριν από νέα προσπάθεια αλλαγής.

Σχετική Τεκμηρίωση