diff --git a/goss.md b/goss.md new file mode 100644 index 0000000..7bb8f68 --- /dev/null +++ b/goss.md @@ -0,0 +1,52 @@ +# Goss + +**Goss** est un outil utilisé principalement pour tester et valider la configuration des serveurs. +C’est un outil léger et rapide qui permet de vérifier que les services, fichiers, paquets, utilisateurs, permissions, ports, etc. sont bien configurés comme attendu sur une machine. + +## Objectif du test + +- Vérifier que Docker est bien installé, activé et en cours d’exécution. +- Vérifier que le groupe docker existe. +- Vérifier que l’interface réseau eth0 est active et possède une adresse IP. +- Tester l’accessibilité des ports HTTP utilisés par le serveur (par exemple Payara sur les ports 8080 et 4848). + +## Création du fichier de configuration + +```bash +nano goss.yaml +``` +Cette commande permet de créer ou modifier le fichier de configuration Goss. +C’est dans ce fichier que seront enregistrés tous les tests que Goss doit exécuter. + +## Ajouter un test sur l’interface réseau + +```bash +goss add interface eth0 +``` +Cette commande ajoute un test automatique sur l’interface eth0. +Goss vérifiera si elle existe, si elle est activée et si elle possède une adresse IP valide. + +## Ajouter un test sur Docker + +```bash +goss add docker +``` +Cette commande ajoute un test sur Docker. +Elle permet de vérifier que le service Docker est bien installé et actif sur la machine. + +## Vérifier la configuration + +```bash +goss v +``` +Cette commande exécute la validation de tous les tests définis dans le fichier goss.yaml. +Chaque test renvoie un résultat : +- OK si le test est validé, +- FAIL si une erreur est détectée. + +## Vérification au format TAP (optionnel) + +```bash +goss -f tap v +``` +Le format TAP (Test Anything Protocol) permet d’obtenir un résultat structuré et lisible, souvent utilisé dans les environnements d’intégration continue (CI/CD).