sylvain/agent_deploy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update README with from_git deployment and script skill

Browse Source 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
sylvain
2026-03-15 19:54:23 +00:00
parent 52eefac295
commit c9ac43c9bc
1 changed files with 32 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+32 -14
View File
@@ -1,6 +1,6 @@
# agent_deploy # agent_deploy
Agent de déploiement d'agents IA sur des serveurs distants via SSH. Installe, configure et démarre de nouveaux agents sur des machines cibles à partir d'un catalogue. Agent de déploiement d'agents IA sur des serveurs distants ou en local via SSH. Installe, configure et démarre de nouveaux agents à partir d'un catalogue ou directement depuis une URL git.
## Rôle ## Rôle
@@ -20,20 +20,42 @@ systemctl enable --now agent_deploy
| Skill | Description | | Skill | Description |
|-------|-------------| |-------|-------------|
| `deploy` | Déploie un agent sur un serveur distant via SSH | | `deploy` | Déploie un agent depuis le catalogue sur un serveur distant (SSH) |
| `catalog` | Consulte le catalogue des agents déployables | | `catalog` | Consulte le catalogue des agents déployables |
| `ssh` | Connexion SSH et exécution de commandes distantes | | `ssh` | Connexion SSH et exécution de commandes distantes |
| `script` | Bibliothèque de scripts bash (save/list/show/exec/run/delete) |
| `agents_status` | Statut des agents du système | | `agents_status` | Statut des agents du système |
| `mqtt_send` | Publication sur un topic MQTT | | `mqtt_send` | Publication sur un topic MQTT |
| `mqtt_subscribe` | Souscription dynamique à un topic MQTT | | `mqtt_subscribe` | Souscription dynamique à un topic MQTT |
| `muc_send` | Message dans le groupe XMPP | | `muc_send` | Message dans le groupe XMPP |
## Modes de déploiement
### Depuis le catalogue
```
"Déploie un agent debian sur le serveur 10.0.0.5"
"Installe un nouvel agent ansible sur srv-infra-01"
```
### Depuis une URL git (distant)
```
SKILL:deploy ARGS:from_git <git_url> <nom> <host> <user> password|key <credential> <xmpp_jid> <xmpp_pass> <mqtt_host> [main_script]
```
### Depuis une URL git (local)
```
SKILL:deploy ARGS:from_git_local <git_url> <nom> <xmpp_jid> <xmpp_pass> <mqtt_host> [main_script]
```
L'agent détecte automatiquement le script principal dans ce ordre : `agent_*.py` > `main.py` > fichier avec `if __name__ == "__main__"` > premier `.py`.
## Structure ## Structure
``` ```
agent_deploy.py — Point d'entrée agent_deploy.py — Point d'entrée
deployer.py — Logique de déploiement (AgentCatalog) deployer.py — Logique de déploiement (AgentCatalog + from_git)
skills/ — 7 skills skills/ — 8 skills
scripts/ — Scripts bash persistants
config/ config/
config.json — Configuration config.json — Configuration
system_prompt.txt — Prompt système system_prompt.txt — Prompt système
@@ -56,14 +78,16 @@ agent_deploy.service — Unit systemd
"mqtt": { "host": "localhost", "port": 1883 }, "mqtt": { "host": "localhost", "port": 1883 },
"llm": { "llm": {
"base_url": "http://192.168.7.119:11434", "base_url": "http://192.168.7.119:11434",
"model": "ministral-3:latest", "model": "qwen3:8b",
"temperature": 0.3 "temperature": 0.3
}, },
"llm_profiles": { "llm_profiles": {
"local": "ministral-3:latest", "local": "qwen3:8b",
"cloud": "gpt-oss:120b-cloud" "cloud": "gpt-oss:120b-cloud"
}, },
"catalog": "/opt/agent_deploy/config/catalog.json" "catalog": "/opt/agent_deploy/config/catalog.json",
"use_omemo": true,
"use_llm_coordinator": true
} }
``` ```
@@ -73,13 +97,7 @@ agent_deploy.service — Unit systemd
/catalog — Liste les agents disponibles dans le catalogue /catalog — Liste les agents disponibles dans le catalogue
/report — Statistiques de déploiement /report — Statistiques de déploiement
/status — État de la queue de tâches /status — État de la queue de tâches
``` /script — Gestion de la bibliothèque de scripts bash
## Exemples de tâches (via Nexus)
```
"Déploie un agent debian sur le serveur 10.0.0.5"
"Installe un nouvel agent ansible sur srv-infra-01"
``` ```
> **Note** : l'agent demande toujours confirmation de l'hôte cible. Ne jamais inventer un nom de serveur. > **Note** : l'agent demande toujours confirmation de l'hôte cible. Ne jamais inventer un nom de serveur.