ansible: Add example

2025-06-09 13:45:01 +02:00
parent 6a00eb2708
commit d71c98c20c
3 changed files with 252 additions and 0 deletions
--- a/ansible/inventory/group_vars/all/static_records.yml.example
+++ b/ansible/inventory/group_vars/all/static_records.yml.example
@@ -0,0 +1,130 @@
+---
+# =================================================================
+# Fichier d'exemple pour les enregistrements DNS statiques
+#
+# Copiez ce fichier vers `ansible/inventory/group_vars/all/static_records.yml`
+# ou un fichier similaire (ex: `ansible/inventory/group_vars/VOTRE_GROUPE/dns_records.yml`)
+# et adaptez les valeurs à votre environnement.
+#
+# Ce fichier est destiné à définir les enregistrements DNS pour les machines
+# ou services ayant des adresses IP fixes, en particulier ceux qui ne
+# sont pas gérés par des systèmes de provisioning dynamiques comme Terraform.
+#
+# La structure ci-dessous est un exemple. Vous devrez l'adapter
+# à la manière dont vos playbooks Ansible attendent ces données
+# (par exemple, pour configurer Dnsmasq, BIND, ou un service DNS cloud).
+# =================================================================
+
+# Exemple de structure pour les enregistrements DNS d'un domaine spécifique (ex: yourdomain.local)
+# Remplacez "yourdomain_local_records" par une clé plus descriptive si nécessaire,
+# par exemple "dns_records_lan" ou "dns_records_dmz".
+# La structure de chaque enregistrement (ip, names) est un exemple.
+# Vos playbooks peuvent attendre une structure différente.
+
+# dns_records_yourdomain_local:
+#   # --- Infrastructure et serveurs critiques ---
+#   - ip: "192.168.1.1"
+#     names:
+#       - "router.yourdomain.local"
+#       - "gateway.yourdomain.local"
+#       - "firewall.yourdomain.local"
+#     # Vous pourriez ajouter d'autres attributs, ex: type: "A", ttl: 3600
+#
+#   - ip: "192.168.1.10"
+#     names:
+#       - "dns-primary.yourdomain.local" # Nom FQDN du serveur DNS lui-même
+#       - "dns1.yourdomain.local"
+#       - "ns1.yourdomain.local"
+#
+#   - ip: "192.168.1.11" # Un serveur DNS secondaire, par exemple
+#     names:
+#       - "dns-secondary.yourdomain.local"
+#       - "dns2.yourdomain.local"
+#       - "ns2.yourdomain.local"
+#
+#   - ip: "192.168.1.20"
+#     names:
+#       - "hypervisor01.yourdomain.local"
+#       - "pve01.yourdomain.local" # Si c'est un Proxmox
+#
+#   - ip: "192.168.1.50"
+#     names:
+#       - "nas.yourdomain.local"
+#       - "storage.yourdomain.local"
+#
+#   # --- Périphériques réseau (imprimantes, caméras, etc.) ---
+#   - ip: "192.168.1.100"
+#     names:
+#       - "printer-color.yourdomain.local"
+#       - "printer01.yourdomain.local"
+#
+#   - ip: "192.168.1.101"
+#     names:
+#       - "camera-garage.yourdomain.local"
+#
+#   # --- Services hébergés ---
+#   - ip: "192.168.1.150" # Peut-être une VM ou un conteneur
+#     names:
+#       - "webserver.yourdomain.local"
+#       - "wiki.yourdomain.local" # Si le même serveur héberge plusieurs services
+#
+#   # --- Enregistrements CNAME (Alias) ---
+#   # La structure pour les CNAMEs peut varier. Voici un exemple :
+#   # - name: "www.yourdomain.local"
+#   #   cname_target: "webserver.yourdomain.local"
+#   #   type: "CNAME"
+#
+#   # --- Enregistrements MX (Mail Exchange) ---
+#   # Si vous hébergez votre propre serveur de messagerie :
+#   # - name: "yourdomain.local" # Le domaine pour lequel le MX est défini
+#   #   mail_server: "mail.yourdomain.local" # FQDN du serveur de messagerie
+#   #   priority: 10 # Priorité MX (valeur plus basse = plus prioritaire)
+#   #   type: "MX"
+#   #
+#   # - ip: "192.168.1.60" # IP du serveur de messagerie
+#   #   names:
+#   #     - "mail.yourdomain.local"
+
+# Vous pouvez avoir des listes séparées pour différents domaines ou zones
+# si votre configuration DNS le requiert.
+# Par exemple, pour un domaine "lab.yourdomain.local":
+# dns_records_lab_yourdomain_local:
+#   - ip: "10.0.0.10"
+#     names:
+#       - "kube-master.lab.yourdomain.local"
+#   - ip: "10.0.0.100"
+#     names:
+#       - "gitlab.lab.yourdomain.local"
+
+# IMPORTANT:
+# La variable `dns_records_home` et `dns_records_lab` utilisée dans votre fichier original
+# `static_records.yml` est une façon valide de structurer ces données.
+# L'exemple ci-dessus est plus générique. Si vos playbooks sont déjà
+# conçus pour utiliser `dns_records_home` et `dns_records_lab`,
+# vous devriez structurer votre fichier `.example` pour correspondre à cela.
+#
+# Exemple reprenant votre structure originale :
+
+dns_records_home: # Pour le domaine "home.votredomaine.fr"
+  - ip: "192.168.1.1" # Exemple: Votre routeur/passerelle
+    names:
+      - "router.home.votredomaine.fr"
+      - "gateway"
+  - ip: "192.168.1.10" # Exemple: Votre serveur DNS principal pour ce domaine
+    names:
+      - "dns.home.votredomaine.fr"
+      - "dns"
+  - ip: "192.168.1.20" # Exemple: Un NAS
+    names:
+      - "nas.home.votredomaine.fr"
+      - "nas"
+
+dns_records_lab: # Pour un autre domaine, par exemple "lab.votredomaine.fr"
+  - ip: "192.168.100.10" # Exemple: Un hyperviseur dans le lab
+    names:
+      - "pve.lab.votredomaine.fr"
+      - "pve"
+  - ip: "192.168.100.20" # Exemple: Un serveur de build
+    names:
+      - "jenkins.lab.votredomaine.fr"
+      - "jenkins"