twinsnes.pihole
Pi-hole
Rolle zur Bereitstellung und Konfiguration von allem, was benötigt wird, um Pi-hole auf einem Raspberry Pi in deinem Netzwerk auszuführen.
Anforderungen
- Ansible 2.9 oder neuer
Rollen-Variablen
| Variablenname | Standard | Beschreibung |
|---|---|---|
raspberry_user |
pi | Der Benutzer, der Pi-hole ausführt. |
dns_server1 |
8.8.8.8 | Die IP-Adresse des primären DNS-Servers, an den Pi-hole Anfragen weiterleitet. |
dns_server2 |
8.8.4.4 | Die IP-Adresse des sekundären DNS-Servers, an den Pi-hole Anfragen weiterleitet, falls der primäre DNS-Server nicht verfügbar ist. Verwende den Wert "no", um den sekundären DNS zu deaktivieren. |
pihole_admin_password |
random | Administrator-Passwort für die Weboberfläche von Pi-hole. Es wird empfohlen, dies auf etwas anderes zu setzen, oder du musst die Protokolle auf dem Host durchsuchen, um das automatisch generierte Passwort zu finden. |
Abhängigkeiten
- geerlingguy.docker
- geerlingguy.pip
Verwendung
Installiere zuerst die Rolle auf deinem Verwaltungs-Node / lokalen Rechner, damit alle erforderlichen Abhängigkeiten heruntergeladen werden.
ansible-galaxy install twinsnes.pihole
Füge dann die Rolle mit der erforderlichen Konfiguration zu deinem Playbook für deinen Pi hinzu oder erstelle ein neues, wie das folgende.
Playbook-Datei:
- hosts: all
roles:
- name: twinsnes.pihole
vars:
pihole_admin_password: "SomeSecretPassword"
Die Verwendung einer Inventar-Datei macht es viel einfacher, Hosts zu verwalten, und ermöglicht es dir, die Konfiguration für deinen Host in einer Datei für später zu speichern. So musst du in sechs Monaten die Einstellungen nicht mehr im Kopf behalten.
Inventar-Datei:
all:
vars:
ansible_connection: ssh
ansible_ssh_user: pi
ansible_ssh_pass: raspberry
hosts:
raspberry:
ansible_host: "192.168.1.100"
Sobald du sowohl dein Playbook als auch deine Inventar-Datei eingerichtet hast, führe dein Playbook aus.
ansible-playbook playbook.yaml -i inventory.yaml
Lizenz
Apache-2.0
Role to set up and configure Pi-hole on a raspberry pi using docker
ansible-galaxy install twinsnes.pihole