twinsnes.pihole
Pi-hole
Rôle pour déployer et configurer tout ce qui est nécessaire pour faire fonctionner Pi-hole sur un Raspberry Pi dans votre réseau.
Exigences
- Ansible 2.9 ou version ultérieure
Variables du rôle
| nom de variable | valeur par défaut | description |
|---|---|---|
raspberry_user |
pi | L'utilisateur qui exécutera Pi-hole. |
dns_server1 |
8.8.8.8 | L'adresse IP du serveur DNS principal vers lequel Pi-hole transférera les requêtes. |
dns_server2 |
8.8.4.4 | L'adresse IP du serveur DNS secondaire vers lequel Pi-hole transférera les requêtes si le serveur principal n'est pas disponible. Utilisez la valeur "no" pour désactiver le DNS secondaire. |
pihole_admin_password |
aléatoire | Mot de passe administrateur pour l'interface web de Pi-hole. Il est recommandé de le changer, sinon vous devrez fouiller dans les journaux de l'hôte pour trouver le mot de passe généré automatiquement. |
Dépendances
- geerlingguy.docker
- geerlingguy.pip
Comment utiliser
Tout d'abord, installez le rôle sur votre nœud de gestion / votre machine locale, ce qui téléchargera toutes les dépendances requises.
ansible-galaxy install twinsnes.pihole
Ensuite, ajoutez le rôle avec la configuration requise à votre playbook pour votre Pi, ou créez-en un nouveau comme celui ci-dessous.
Fichier de playbook :
- hosts: all
roles:
- name: twinsnes.pihole
vars:
pihole_admin_password: "SomeSecretPassword"
Utiliser un fichier d'inventaire facilite grandement la gestion des hôtes et vous permettra de stocker la configuration de votre hôte dans un fichier pour plus tard. Ainsi, lorsque vous voudrez le relancer dans 6 mois, vous n'aurez pas à vous rappeler des paramètres.
Fichier d'inventaire :
all:
vars:
ansible_connection: ssh
ansible_ssh_user: pi
ansible_ssh_pass: raspberry
hosts:
raspberry:
ansible_host: "192.168.1.100"
Une fois que vous avez configuré votre playbook et votre fichier d'inventaire, exécutez votre playbook
ansible-playbook playbook.yaml -i inventory.yaml
Licence
Apache-2.0
Role to set up and configure Pi-hole on a raspberry pi using docker
ansible-galaxy install twinsnes.pihole