113 lines
5.3 KiB
Markdown
113 lines
5.3 KiB
Markdown
# Εγχειρίδιο Λειτουργιών ZeroClaw (Operations Runbook)
|
||
|
||
Αυτό το εγχειρίδιο προορίζεται για τους διαχειριστές του συστήματος που είναι υπεύθυνοι για τη διαθεσιμότητα, την ασφάλεια και την απόκριση σε περιστατικά.
|
||
|
||
Τελευταία επαλήθευση: **18 Φεβρουαρίου 2026**.
|
||
|
||
## Πεδίο Εφαρμογής
|
||
|
||
Το έγγραφο καλύπτει τις καθημερινές λειτουργίες (Day-2 operations):
|
||
- Εκκίνηση και επίβλεψη του runtime.
|
||
- Ελέγχους καλής λειτουργίας (health checks) και διαγνωστικά.
|
||
- Διαδικασίες ασφαλούς ανάπτυξης (rollout) και επαναφοράς (rollback).
|
||
- Διαλογή (triage) και αποκατάσταση μετά από περιστατικά.
|
||
|
||
Για την αρχική εγκατάσταση, ανατρέξτε στον οδηγό [one-click-bootstrap.md](one-click-bootstrap.md).
|
||
|
||
## Λειτουργίες Χρόνου Εκτέλεσης (Runtime Modes)
|
||
|
||
| Λειτουργία | Εντολή | Χρήση |
|
||
|:---|:---|:---|
|
||
| Προσκήνιο (Foreground) | `zeroclaw daemon` | Τοπική αποσφαλμάτωση και δοκιμές. |
|
||
| Πύλη (Gateway) | `zeroclaw gateway` | Έλεγχος τελικών σημείων (endpoints) webhook. |
|
||
| Υπηρεσία Συστήματος | `zeroclaw service install && zeroclaw service start` | Μόνιμη εκτέλεση υπό τη διαχείριση του συστήματος. |
|
||
|
||
## Βασική Ροή Εργασίας Διαχειριστή
|
||
|
||
1. **Επικύρωση Ρυθμίσεων**:
|
||
```bash
|
||
zeroclaw status
|
||
```
|
||
2. **Διαγνωστικός Έλεγχος**:
|
||
```bash
|
||
zeroclaw doctor
|
||
zeroclaw channel doctor
|
||
```
|
||
3. **Εκκίνηση Daemon**:
|
||
```bash
|
||
zeroclaw daemon
|
||
```
|
||
4. **Διαχείριση Υπηρεσίας**:
|
||
```bash
|
||
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)**:
|
||
```bash
|
||
journalctl --user -u zeroclaw.service -f
|
||
```
|
||
|
||
## Διαλογή Περιστατικών (Incident Triage)
|
||
|
||
Σε περίπτωση δυσλειτουργίας, ακολουθήστε τα παρακάτω βήματα:
|
||
|
||
1. **Ανάλυση Κατάστασης**:
|
||
```bash
|
||
zeroclaw status
|
||
zeroclaw doctor
|
||
zeroclaw channel doctor
|
||
```
|
||
2. **Έλεγχος Υπηρεσίας**:
|
||
```bash
|
||
zeroclaw service status
|
||
```
|
||
3. **Επανεκκίνηση**:
|
||
Εάν η υπηρεσία δεν αποκρίνεται, πραγματοποιήστε καθαρή επανεκκίνηση:
|
||
```bash
|
||
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. Αναλύστε την αιτία του προβλήματος πριν από νέα προσπάθεια αλλαγής.
|
||
|
||
## Σχετική Τεκμηρίωση
|
||
|
||
- [one-click-bootstrap.md](one-click-bootstrap.md)
|
||
- [troubleshooting.md](troubleshooting.md)
|
||
- [config-reference.md](config-reference.md)
|
||
- [commands-reference.md](commands-reference.md)
|