91 lines
2.7 KiB
Markdown
91 lines
2.7 KiB
Markdown
# agent_debian
|
|
|
|
Agent d'administration système. Gère les paquets, services, processus, fichiers, réseau, utilisateurs et conteneurs sur le serveur local. Répond aux délégations de Nexus via MQTT.
|
|
|
|
## Rôle
|
|
|
|
Toutes les tâches système sur **ce serveur** passent par cet agent : `apt install`, `systemctl restart`, surveillance disque/RAM, consultation des logs, gestion des crons, etc.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
cd /opt/agent_debian
|
|
python3 -m venv venv
|
|
source venv/bin/activate
|
|
pip install -r requirements.txt
|
|
systemctl enable --now agent_debian
|
|
```
|
|
|
|
## Skills disponibles
|
|
|
|
| Skill | Description |
|
|
|-------|-------------|
|
|
| `apt` | Gestion des paquets (install, remove, update, upgrade, search) |
|
|
| `systemd` | Contrôle des services (start, stop, restart, status, enable) |
|
|
| `shell` | Exécution de commandes shell arbitraires |
|
|
| `script` | Exécution de scripts multi-lignes |
|
|
| `sysinfo` | CPU, RAM, disque, uptime |
|
|
| `process` | Liste, kill, surveillance des processus |
|
|
| `filesystem` | Lecture, écriture, liste, recherche de fichiers |
|
|
| `network` | Interfaces, connexions, ping, traceroute |
|
|
| `journal` | Consultation des logs systemd (journalctl) |
|
|
| `cron` | Gestion des tâches cron |
|
|
| `container` | Gestion Docker/LXC (ps, start, stop, logs) |
|
|
| `user` | Gestion des utilisateurs et groupes |
|
|
| `agents_status` | Statut des agents du système |
|
|
| `mqtt_send` | Publication sur un topic MQTT |
|
|
| `mqtt_subscribe` | Souscription dynamique à un topic MQTT |
|
|
| `muc_send` | Message dans le groupe XMPP |
|
|
|
|
## Surveillance proactive
|
|
|
|
L'agent monitore en arrière-plan (toutes les 5 minutes) :
|
|
- **Disque** : alerte si un volume dépasse 85% d'utilisation
|
|
- **RAM** : alerte si la mémoire utilisée dépasse 90%
|
|
|
|
Les alertes sont envoyées automatiquement à Nexus via MQTT.
|
|
|
|
## Configuration
|
|
|
|
`config/config.json` :
|
|
```json
|
|
{
|
|
"agent_id": "debian.local",
|
|
"xmpp": {
|
|
"jid": "debian.local@xmpp.ovh",
|
|
"password": "...",
|
|
"admin_jid": "sylvain@xmpp.ovh",
|
|
"muc_room": "agents@muc.xmpp.ovh"
|
|
},
|
|
"mqtt": { "host": "localhost", "port": 1883 },
|
|
"llm": {
|
|
"base_url": "http://192.168.7.119:11434",
|
|
"model": "ministral-3:latest",
|
|
"temperature": 0.3
|
|
},
|
|
"llm_profiles": {
|
|
"local": "ministral-3:latest",
|
|
"cloud": "gpt-oss:120b-cloud"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Commandes
|
|
|
|
```
|
|
/report — Rapport système (uptime, RAM, disque, stats tâches)
|
|
/update — Git pull + redémarrage du service
|
|
/status — État de la queue de tâches
|
|
/pause — Pause du traitement des tâches
|
|
/resume — Reprise
|
|
```
|
|
|
|
## Fichiers
|
|
|
|
```
|
|
agent_debian.py — Point d'entrée
|
|
skills/ — 16 skills système
|
|
config/ — Configuration et system prompt
|
|
agent_debian.service — Unit systemd
|
|
```
|