docs: standardize readme format

This commit is contained in:
Simon Cornet 2026-04-10 09:00:19 +02:00
commit 9cc6330f85

View file

@ -1,14 +1,34 @@
# Overview # Ansible Role: Unbound
This role configures an Unbound DNS server. Install and configure [Unbound](https://nlnetlabs.nl/projects/unbound/) DNS server.
## Supported Operating Systems ## Variables
| Operating System | Version | | Variable | Required | Default | Description |
| --- | ----- | |----------|----------|---------|-------------|
| Alpine | 3.23 | | `unbound_upstream_dns` | No | `["8.8.8.8", "1.1.1.1"]` | Upstream DNS servers |
| Debian | 13 | | `unbound_allow_access` | Yes | `[]` | Networks allowed to query DNS |
| `unbound_zones` | Yes | `[]` | DNS zones to configure |
## Tags ## Example
This role has no tags. ```yaml
unbound_upstream_dns:
- "1.1.1.1"
- "8.8.8.8"
unbound_allow_access:
- name: "internal-lan"
network: "10.0.0.0/8"
- name: "dmz"
network: "192.168.1.0/24"
unbound_zones:
- zone: "internal.example.com"
type: "static"
records:
- name: "server1.internal.example.com"
value: "10.0.1.10"
- name: "server2.internal.example.com"
value: "10.0.1.11"
```