Roles Rôle « Nameserver »

22 octobre 2025 à 16:34

Ce rôle est chargé de mettre en place un serveur de nom local pour la résolution des noms. Il peut potentiellement fournir à l’extérieur des zones de nom.

Variables à fournir

Variable Type Requis Défaut Description
nameserver Objet nameserver Oui Configuration du serveur de nom
nameserver_git_repository_temporary Chemin Faux Dossier d’extraction du dépôt Git lors de l’usage de SSH pour l’accès
nameserver_git_repository_source_ssh Adresse Faux Adresse d’accès au dépôt Git des zones en SSH
nameserver_git_repository_source_http Adresse Faux Adresse d’accès au dépôt Git des zone en HTTPS
nameserver_git_repository_token Chaîne Faux Jeton d’authentification à utiliser pour l’accès au dépôt Git en HTTPS

Les variables nameserver_git_repository_source_ssh et nameserver_git_repository_temporary doivent être définies ensemble.

Les variables nameserver_git_repository_source_http et nameserver_git_repository_token doivent être définies ensemble.

L’une des variables nameserver_git_repository_source_ssh ou nameserver_git_repository_source_http doit être définie lorsque des fichiers de zone doivent être déployés.

Type nameserver

Propriété Type Requis Défaut Description
acls Dictionnaire de liste de chaînes Non Dictionnaire vide Ensembles de permissions à configurer
options Liste de option Non Liste vide Options à configurer
logging Chaîne Non Chaîne vide Directives de journalisation
zones Dictionnaire de liste de option Non Dictionnaire vide Zones de nommage à configurer
views Dictionnaire de liste de option Non Dictionnaire vide Vues nommées à configurer
statistics-channels Liste de channel Non Liste vide Canaux de récupération des statistiques
files Liste d’objets file Non Liste vide Fichiers de zone à déployer
remove Liste de chemins Non Liste vide Nom de fichiers de zone à supprimer
needed_folders Liste d’objets folder Non Liste vide Dossiers à créer
include_private_reverse Booléen Non Vrai Inclure la zone inversée pour le réseaux privés

Type option

Une directive d’option ou un dictionnaire dont la clé est le nom de la directive et la valeur une liste d’option.

Les directives dépendent de la propriété.

Type channel

Propriété Type Requis Défaut Description
address IP Address Oui Adresse d’écoute
port Entier 1-65535 Oui Port d’écoute TCP
allow Liste d’adresses Non Liste vide Permissions d’accès

Type file

Propriété Type Requis Défaut Description
name Chemin Oui Nom du fichier de zone
ref Référence Git Non Vide Référence Git vers le fichier source dans la zone

La valeur de ref est telle qu’attendue par git-cat. La version basique est uniquement le nom du fichier. Il sera alors récupéré depuis la branche master. La seconde version est branche:fichier. Le fichier est alors récupéré depuis la branche spécifiée.

S’il n’y a que la propriété name d’utilisée, sa valeur peut être précisée seule.

Type folder

Propriété Type Requis Défaut Description
path Chemin Oui Chemin absolut du dossier sur le serveur
owner Identifiant Non Nom du propriétaire à affecter
group Identifiant Non Nom du groupe à affecter
mode Mode Non Mode d’accès au fichier tel qu’accepté par le module file

Variables fixées

Variable Type Description
install_packages Liste de chaînes Nom des paquets installés