AnsibleRoles

Roles Ansible pour l'infrastructure physique à administrer pour les clubs étudiants. Fortement inspiré des collections internes de l'infrastructure du Lan ETS

Notes de noms de fichiers

Il est à noter que les fichiers .yml et .yaml sont utilisés dans des cas spécifiques pour différencier les types de contenu.

• Les fichiers .yml sont utilisés pour les fichiers galaxy et les autres fichiers qui ne nécessitent pas de linting propre à Ansible.
• Les fichiers .yaml sont utilisés pour les playbooks et les rôles Ansible, où le linting spécifique à Ansible est appliqué.

Collections et rôles

• proxmox : Collection de rôles Ansible pour gérer Proxmox.
• opnsense : Collection générique pour gérer OPNsense.
• netservices : Collection de rôles réseau pour Kea DHCP, BIND9 et Stork.
• monitoring : Collection de rôles pour Prometheus, Grafana, Loki et les exporters (node, smartctl, blackbox, snmp, ipmi, pve).
• docker : Collection de rôles pour installer et configurer Docker.
• forgejo : Collection de rôles pour déployer les runners Forgejo Actions.
• omni : Collection de rôles pour déployer Sidero Omni (gestionnaire de clusters Talos Kubernetes).
• cisco-3850 : Collection de rôles pour la configuration des switches Cisco 3850.
• cs2 : Collection de rôles pour le déploiement de serveurs CS2 (LanETS).
• pkgcache : Collection de rôles pour les mirrors de cache de paquets (apt, dnf, nix, pacman, pkg, OPNsense).

Tous les rôles réutilisables de l'infrastructure Cedille vivent ici — le repository d'exécution AnsibleInfra ne contient plus aucun rôle local, uniquement des playbooks et inventaires qui consomment ces collections via collections/requirements.yml.

Environnement de dev

Le repo fournit un flake.nix + .envrc (direnv). En entrant dans le répertoire (avec direnv activé, direnv allow la première fois) ou via nix develop, un venv Python est créé/mis à jour automatiquement depuis requirements-dev.txt (ansible-core, molecule, molecule-plugins[docker], ansible-lint, yamllint). Le client docker est fourni par le devShell, mais le daemon Docker doit tourner sur la machine hôte (le devShell ne le gère pas).

Lancer Molecule pour un rôle

Molecule tourne par rôle (driver docker, images geerlingguy/docker-*-ansible avec systemd). Pour reproduire localement ce que fait la CI (.github/workflows/molecule-*.yaml) :

cd <collection>/roles/<role>
ansible-galaxy collection install -r molecule/default/requirements.yml
molecule test

molecule test fait tourner toute la séquence (create, converge, idempotence, verify, destroy). Pour itérer plus vite pendant le dev d'un rôle, molecule converge puis molecule verify évitent de recréer le conteneur à chaque essai ; molecule destroy nettoie à la fin.

Extensions suggérées

Le dossier ./.vscode contient des configurations pour les extensions suivantes, qui sont recommandées pour une expérience de développement optimale :

• Prettier - Code formatter : pour le formatage automatique du code YAML.
• Ansible : pour le linting et la validation des fichiers Ansible.
• YAML : pour le support avancé du langage YAML, y compris la validation et le linting.
• Better Jinja : pour une meilleure prise en charge de la syntaxe Jinja utilisée dans les playbooks Ansible.