homelab-config/INSTRUCTIONS.md

INSTRUCTIONS POUR AGENTS

📋 Sommaire des agents

• AGENT_devops.md : Opérations quotidiennes (Status Monitor, commandes SSH, corrections courantes)
• AGENT_MAJ_traefik_GIT_inventaire.md : Synchronisation Traefik/GIT (procédure détaillée)
• AGENT-creation-lxc-proxmox.md : Création de containers LXC sur Proxmox
• AGENT-TRAEFIK-https-homelab-infomaniak.md : Configuration HTTPS/Traefik avec Let's Encrypt
• AGENT_Transfert_de_certificat_viaCT200.md : Transfert de certificats via CT200 comme bastion

---

RÈGLES ABSOLUES

1. TOUJOURS vérifier Git en premier cd ~/homelab-config git pull

2. TOUJOURS travailler depuis ~/homelab-config (WSL) - Tu as WSL d'installé avec ubuntu. utilise le pour cloner git...

3. JAMAIS toucher aux fichiers locaux sur C:/Users/theo/.vibe/Proxmox/inventair/

4. TOUJOURS commiter et pusher après modification git add . git commit -m "description claire" GIT_SSL_NO_VERIFY=true git push origin main

FLUX DE DÉPLOIEMENT STATUS-MONITOR

L'ordre est critique pour éviter les déploiements de vieilles versions :

IDE (Windows) ──copy──> WSL (~/homelab-config) ──scp──> CT200/CT100 (192.168.0.100 bastion) ──scp──> CT201 (192.168.0.201 status-monitor)

Commande automatique

wsl bash ~/homelab-config/status-monitor/deploy.sh

Commande manuelle (si deploy.sh ne fonctionne pas)

# 1. IDE -> WSL
cp /mnt/c/Users/theo/homelab_ia/homelab-config/status-monitor/app.py ~/homelab-config/status-monitor/app.py

# 2. WSL -> CT201 (rebond via CT200/CT100)
scp -J root@192.168.0.100 -i ~/.ssh/id_ed25519 ~/homelab-config/status-monitor/app.py root@192.168.0.201:/tmp/app.py

# 3. Installation sur CT201
ssh -J root@192.168.0.100 -i ~/.ssh/id_ed25519 root@192.168.0.201 'mv /tmp/app.py /opt/status-monitor/app.py && systemctl restart status-monitor'

Authentification Git (à utiliser pour tous les commits)

• Utilisateur : Windsurf
• Mot de passe / token : 3N14E7GWVSgi3K
• URL du dépôt : https://Windsurf:3N14E7GWVSgi3K@git.peis.fr/VisualPCI/homelab-config.git
• Auteur des commits : Windsurf <windsurf@peis.fr>
• Le dépôt reste VisualPCI/homelab-config, l'authentification se fait avec Windsurf.

Sources de vérité

• Dépôt Git : https://git.peis.fr/VisualPCI/homelab-config
• Clone local : ~/homelab-config (WSL)
• Backup local : A déplacer par Theo

ERREURS À ÉVITER

• Modifier directement C:/Users/theo/.vibe/Proxmox/inventair/*
• Oublier de faire git pull avant modification
• Oublier de pusher après modification
• Travailler depuis plusieurs emplacements

WORKFLOW STANDARD

1. Recevoir la demande
2. cd ~/homelab-config && git pull
3. Modifier les fichiers dans ~/homelab-config
4. Tester/valider
5. git add . && git commit -m "..." && git push
6. Confirmer à l'utilisateur

---

Créé par : Theo Pour : Mistral Vibe et autres agents