bdd5d92ba7
Complete implementation ready for Coolify: - Node.js 22 + Fastify + socket.io backend - PostgreSQL 16 + Redis 7 services - Docker Compose configuration - Deployment scripts and documentation Co-Authored-By: Paperclip <noreply@paperclip.ing>
114 lines
3 KiB
Markdown
114 lines
3 KiB
Markdown
# AgentHub Phase 1 LAN — Quickstart
|
|
|
|
**Cible :** Serveur LAN `192.168.9.23` (2 vCPU / 4 Go RAM)
|
|
**Temps estimé :** 10-15 minutes
|
|
|
|
## Option 1 : Script Automatique (1 commande)
|
|
|
|
Si vous avez accès SSH au serveur depuis ce workspace :
|
|
|
|
```bash
|
|
cd /home/alexandre/.paperclip/instances/default/workspaces/8780faf8-03bb-45e9-989e-167eeb438b58/agenthub
|
|
./scripts/deploy-lan.sh 192.168.9.23
|
|
```
|
|
|
|
Le script :
|
|
1. Vérifie la connexion SSH
|
|
2. Vérifie Docker sur le serveur
|
|
3. Crée `/opt/agenthub`
|
|
4. Copie les fichiers nécessaires
|
|
5. Build et démarre la stack Docker
|
|
6. Teste le healthcheck
|
|
7. Affiche l'URL d'accès
|
|
|
|
**Prérequis :**
|
|
- Accès SSH configuré (clé ou mot de passe)
|
|
- Docker installé sur 192.168.9.23
|
|
- Port 3000 ouvert sur le firewall LAN
|
|
|
|
## Option 2 : Déploiement Manuel (si pas d'accès SSH depuis Paperclip)
|
|
|
|
Voir le guide complet : **[docs/DEPLOY-LAN-MANUEL.md](docs/DEPLOY-LAN-MANUEL.md)**
|
|
|
|
### Résumé rapide :
|
|
|
|
**Sur le workspace Paperclip :**
|
|
|
|
```bash
|
|
cd /home/alexandre/.paperclip/instances/default/workspaces/8780faf8-03bb-45e9-989e-167eeb438b58
|
|
tar czf /tmp/agenthub-deploy.tar.gz -C agenthub \
|
|
Dockerfile .dockerignore \
|
|
package.json package-lock.json tsconfig.json tsconfig.build.json \
|
|
src/ drizzle/ drizzle.config.ts \
|
|
scripts/migrate.ts scripts/seed.ts \
|
|
compose.lan-direct.yml .env.lan
|
|
|
|
# Copier sur serveur via SCP ou clé USB
|
|
scp /tmp/agenthub-deploy.tar.gz alexandre@192.168.9.23:/tmp/
|
|
```
|
|
|
|
**Sur le serveur 192.168.9.23 :**
|
|
|
|
```bash
|
|
# Se connecter au serveur
|
|
ssh alexandre@192.168.9.23
|
|
|
|
# Installer
|
|
sudo mkdir -p /opt/agenthub
|
|
sudo chown $USER:$USER /opt/agenthub
|
|
cd /opt/agenthub
|
|
tar xzf /tmp/agenthub-deploy.tar.gz
|
|
|
|
# Démarrer (build + run)
|
|
docker compose -f compose.lan-direct.yml up -d --build
|
|
|
|
# Vérifier
|
|
curl http://localhost:3000/healthz
|
|
```
|
|
|
|
## Vérification Rapide
|
|
|
|
Après déploiement, tester :
|
|
|
|
```bash
|
|
# Health check
|
|
curl http://192.168.9.23:3000/healthz
|
|
# → {"status":"ok","uptime":...}
|
|
|
|
# Créer 2 agents de test
|
|
cd /opt/agenthub
|
|
./test/smoke-lan-2-agents.sh 192.168.9.23
|
|
|
|
# Suivre les logs
|
|
docker compose -f compose.lan-direct.yml logs -f app
|
|
```
|
|
|
|
## Fichiers Créés pour Phase 1
|
|
|
|
- **`compose.lan-direct.yml`** — Compose pour build local (pas de registry)
|
|
- **`.env.lan`** — Secrets générés (JWT, Postgres password)
|
|
- **`scripts/deploy-lan.sh`** — Script de déploiement automatique
|
|
- **`docs/DEPLOY-LAN-MANUEL.md`** — Guide manuel complet
|
|
|
|
## Différences avec le Plan Original
|
|
|
|
Le plan original supposait l'existence de Forgejo + registry d'images.
|
|
**Phase 1 simplifiée :**
|
|
- ❌ Pas de Forgejo
|
|
- ❌ Pas de CI/CD
|
|
- ❌ Pas de registry d'images
|
|
- ✅ Build local direct via `docker compose build`
|
|
- ✅ LAN HTTP uniquement (pas de TLS)
|
|
- ✅ Déploiement manuel ou via script SSH
|
|
|
|
**Phase 2 (plus tard) :** Coolify + Forgejo + TLS + CI/CD
|
|
|
|
## Support
|
|
|
|
- **Guide manuel :** [docs/DEPLOY-LAN-MANUEL.md](docs/DEPLOY-LAN-MANUEL.md)
|
|
- **Runbook opérations :** [docs/RUNBOOK-lan.md](docs/RUNBOOK-lan.md)
|
|
- **Tests :** `test/smoke-lan-2-agents.sh`
|
|
|
|
---
|
|
|
|
**Prêt à déployer !** 🚀
|