Démarrage Rapide
Ajouter vos Hosts
Commencez par ajouter vos serveurs dans la section Hosts. Chaque host nécessite un nom, une adresse IP et un système d'exploitation.
Bootstrap Ansible
Exécutez le Bootstrap sur chaque host pour configurer l'accès SSH et les prérequis Ansible.
Automatiser
Utilisez les Actions Rapides ou exécutez des playbooks personnalisés pour automatiser vos tâches.
Indicateurs de Santé des Hosts
Chaque host affiche un indicateur visuel de santé représenté par des barres colorées. Cet indicateur combine plusieurs facteurs pour évaluer l'état global de votre serveur.
Comprendre l'Indicateur
Host en ligne, bootstrap OK, vérifié récemment
Host fonctionnel mais certains aspects à améliorer
Attention requise - vérification recommandée
Host hors ligne ou non configuré
Facteurs de Calcul du Score
Le host répond aux requêtes réseau
SSH et prérequis Ansible configurés
Dernière vérification il y a moins d'une heure
Dernière vérification dans les 24 dernières heures
Astuce: Exécutez régulièrement un Health Check pour maintenir un score de santé élevé.
Statuts Bootstrap Ansible
Le host est entièrement configuré pour Ansible. L'utilisateur automation existe, la clé SSH est déployée et sudo est configuré sans mot de passe.
Le bootstrap n'a pas encore été exécuté sur ce host. Cliquez sur le bouton Bootstrap pour configurer l'accès Ansible.
Que signifie "Jamais vérifié" ?
Ce message apparaît lorsqu'aucun Health Check n'a été exécuté sur le host depuis son ajout. Le système ne peut pas déterminer l'état réel du serveur. Lancez un Health Check pour mettre à jour le statut et obtenir un score de santé précis.
Architecture de la Solution
Stack Technologique
- Backend: FastAPI (Python) - API REST haute performance
- Automation: Ansible - Gestion de configuration
- Frontend: HTML/CSS/JS avec TailwindCSS
- Déploiement: Docker & Docker Compose
- Temps réel: WebSocket pour les mises à jour live
Structure des Fichiers
homelab-automation/ ├── app/ │ ├── app_optimized.py # API FastAPI │ ├── index.html # Interface web │ └── main.js # Logique frontend ├── ansible/ │ ├── inventory/ │ │ ├── hosts.yml # Inventaire des hosts │ │ └── group_vars/ # Variables par groupe │ └── playbooks/ # Playbooks Ansible ├── tasks_logs/ # Logs des tâches ├── docker-compose.yml └── Dockerfile
Fonctionnalités par Section
Vue d'ensemble de votre infrastructure avec métriques en temps réel.
- Métriques: Nombre d'hosts en ligne, tâches exécutées, taux de succès
- Actions Rapides: Mise à jour, redémarrage, health check, backup
- Aperçu Hosts: Liste condensée avec statut de chaque serveur
Gestion complète de vos serveurs et machines.
- Ajouter un Host: Nom, IP, OS, groupes d'environnement et de rôle
- Bootstrap: Configure SSH et les prérequis Ansible sur le host
- Filtres: Par groupe, par statut Ansible Ready/Non configuré
- Actions: Health Check, Upgrade, Reboot, Backup par host
- Playbooks: Exécuter des playbooks sur un groupe de hosts
Historique et suivi des tâches d'automatisation.
- Statuts: En cours (bleu), Terminées (vert), Échouées (rouge)
- Filtres: Par statut, par date (année/mois/jour)
- Détails: Cliquez sur une tâche pour voir les logs complets
- Polling: Mise à jour automatique des tâches en cours
Journal des événements système en temps réel.
- Types: Info, Warning, Error avec codes couleur
- WebSocket: Logs en temps réel sans rafraîchissement
- Export: Téléchargez les logs au format texte
- Effacer: Nettoyez l'historique des logs
Playbooks Ansible Disponibles
bootstrap-host.yml
Configure un nouveau host pour Ansible: création utilisateur, clé SSH, sudo sans mot de passe.
Requis avant toute autre opérationhealth-check.yml
Vérifie l'état de santé: CPU, RAM, disque, services critiques.
Exécution rapide, non destructifsystem-upgrade.yml
Met à jour tous les paquets système (apt/yum/dnf selon l'OS).
Peut nécessiter un redémarragebackup-config.yml
Sauvegarde les fichiers de configuration importants (/etc, configs apps).
Stockage local ou distantRéférence API
L'API REST est accessible sur le port configuré. Authentification via header X-API-Key.
| Endpoint | Méthode | Description |
|---|---|---|
| /api/hosts | GET | Liste tous les hosts |
| /api/hosts | POST | Ajoute un nouveau host |
| /api/tasks/logs | GET | Récupère les logs de tâches |
| /api/ansible/playbooks | GET | Liste les playbooks disponibles |
| /api/ansible/execute | POST | Exécute un playbook |
| /api/metrics | GET | Métriques du dashboard |
Dépannage
Cause: Les identifiants SSH fournis sont incorrects ou l'utilisateur n'a pas les droits sudo.
Solution: Vérifiez le nom d'utilisateur et mot de passe. Assurez-vous que l'utilisateur peut exécuter sudo sur le host cible.
Cause: Le health check n'a pas été exécuté ou la clé SSH n'est pas configurée.
Solution: Exécutez le bootstrap si ce n'est pas fait, puis lancez un Health Check.
Cause: Le processus Ansible peut être bloqué ou le host ne répond plus.
Solution: Vérifiez la connectivité réseau. Consultez les logs système pour plus de détails. Redémarrez le conteneur Docker si nécessaire.
Cause: La connexion WebSocket est interrompue.
Solution: Rafraîchissez la page. Vérifiez que le port WebSocket n'est pas bloqué par un firewall ou proxy.
Raccourcis & Astuces
Navigation
- Cliquez sur le logo pour revenir au Dashboard
- Utilisez les onglets du menu pour naviguer
- Le thème clair/sombre est persistant
Productivité
- Filtrez les hosts par groupe pour des actions groupées
- Utilisez les filtres de date pour retrouver des tâches
- Exportez les logs avant de les effacer