twinsnes.pihole
Pi-hole
Rol para desplegar y configurar todo lo necesario para ejecutar Pi-hole en un Raspberry Pi en tu red.
Requisitos
- Ansible 2.9 o más nuevo
Variables del Rol
| nombre de variable | predeterminado | descripción |
|---|---|---|
raspberry_user |
pi | El usuario que ejecutará Pi-hole. |
dns_server1 |
8.8.8.8 | La IP del servidor DNS principal al que Pi-hole enviará las solicitudes. |
dns_server2 |
8.8.4.4 | La IP del servidor DNS secundario al que Pi-hole enviará la solicitud si el servidor DNS principal no está disponible. Usa el valor "no" para desactivar el DNS secundario. |
pihole_admin_password |
random | Contraseña del administrador para la interfaz web de Pi-hole. Se recomienda que configures esto con algo diferente, o tendrás que buscar en los registros del host para encontrar la contraseña generada automáticamente. |
Dependencias
- geerlingguy.docker
- geerlingguy.pip
Cómo usar
Primero, instala el rol en tu nodo de gestión / máquina local, lo que descargará todas las dependencias requeridas.
ansible-galaxy install twinsnes.pihole
Luego, agrega el rol con la configuración necesaria a tu libro de jugadas para tu Pi, o crea uno nuevo como el siguiente.
Archivo de libro de jugadas:
- hosts: all
roles:
- name: twinsnes.pihole
vars:
pihole_admin_password: "SomeSecretPassword"
Usar un archivo de inventario facilita mucho la gestión de hosts y te permite almacenar la configuración de tu host en un archivo para más tarde. Así, cuando necesites ejecutar esto nuevamente en 6 meses, no tendrás que recordar la configuración.
Archivo de inventario:
all:
vars:
ansible_connection: ssh
ansible_ssh_user: pi
ansible_ssh_pass: raspberry
hosts:
raspberry:
ansible_host: "192.168.1.100"
Una vez que tengas configurados tanto tu libro de jugadas como tu archivo de inventario, ejecuta tu libro de jugadas.
ansible-playbook playbook.yaml -i inventory.yaml
Licencia
Apache-2.0
Role to set up and configure Pi-hole on a raspberry pi using docker
ansible-galaxy install twinsnes.pihole