docs(examples): update to use Ansible FQCN

- Updated debug tasks to use ansible.builtin.debug (FQCN)
- Removed trailing whitespace
- Fixed line length violations
- Examples now follow Ansible guidelines
This commit is contained in:
Daniel Akulenok
2026-01-29 21:24:16 +01:00
parent 51a798b7ce
commit 0a4c83c4b0
2 changed files with 29 additions and 27 deletions

View File

@@ -4,12 +4,12 @@
- name: Manage DNS zones with nsupdate_zone
hosts: localhost
gather_facts: false
vars:
# TSIG authentication
dns_key_name: "nsupdate"
dns_key_secret: "+bFQtBCta7j2vWkjPkAFtgA=="
# Example zone records
example_com_records:
# Zone apex records
@@ -17,19 +17,19 @@
type: A
value: 192.168.1.1
ttl: 3600
- record: 'example.com.'
type: MX
value:
- "10 mail1.example.com."
- "20 mail2.example.com."
- record: 'example.com.'
type: TXT
value:
- "v=spf1 mx a include:_spf.google.com ~all"
- "google-site-verification=abc123"
# Subdomains
- record: www
type: A
@@ -37,30 +37,30 @@
- 192.168.1.10
- 192.168.1.11
ttl: 300
- record: blog
type: CNAME
value: www.example.com.
- record: mail1
type: A
value: 192.168.1.20
- record: mail2
type: A
value: 192.168.1.21
# Wildcard
- record: '*'
type: A
value: 192.168.1.100
# Remove old record
- record: old-server
type: A
value: 192.168.1.99
state: absent
tasks:
- name: Manage example.com zone
valid.nsupdate_zone.nsupdate_zone:
@@ -76,13 +76,13 @@
dns_server: ns1.example.com
records: "{{ example_com_records }}"
register: result
- name: Display results
debug:
ansible.builtin.debug:
var: result
- name: Show changes made
debug:
ansible.builtin.debug:
msg: |
Zone: {{ item.zone }}
Changed: {{ item.changed }}
@@ -104,20 +104,22 @@
- record: 'example.com.'
type: A
value: 192.168.1.1
- name: example.org
records:
- record: 'example.org.'
type: A
value: 192.168.2.1
- name: example.net
records:
- record: 'example.net.'
type: A
value: 192.168.3.1
register: multi_zone_result
- name: Show multi-zone results
debug:
msg: "Processed {{ multi_zone_result.results | length }} zones, {{ multi_zone_result.results | selectattr('changed', 'equalto', true) | list | length }} changed"
ansible.builtin.debug:
msg: >-
Processed {{ multi_zone_result.results | length }} zones,
{{ multi_zone_result.results | selectattr('changed', 'equalto', true) | list | length }} changed

View File

@@ -11,7 +11,7 @@ list_of_nsupdate_zones:
type: TXT
value: 'c8445a4f-cf4c-4130-94c8-21c2b0da80c0'
state: absent
# Multiple values are specified in list form.
- record: 'hugs.dk.'
type: CAA
@@ -47,7 +47,7 @@ list_of_nsupdate_zones:
- "v=spf1 mx a include:_spf.google.com ~all"
- "google-site-verification=8PimrghUKUJi9dJhfj1CGyB7s5zzf6ZiiZxukzPALM0"
# Complex records with multiple fields are simply
# Complex records with multiple fields are simply
# separated by a space in the value field.
- record: 'hugs.dk.'
type: MX
@@ -63,15 +63,15 @@ list_of_nsupdate_zones:
- name: Provision DNS zones efficiently
hosts: localhost
gather_facts: false
vars_files:
- sample_zone_format.yml
vars:
# Your TSIG key for authentication
dns_tsig_key_name: "nsupdate"
dns_tsig_key_secret: "{{ vault_dns_key }}" # Store in ansible-vault
tasks:
- name: Update DNS zones
valid.nsupdate_zone.nsupdate_zone:
@@ -84,9 +84,9 @@ list_of_nsupdate_zones:
- '^_acme-challenge\..*'
zones: "{{ list_of_nsupdate_zones }}"
register: zone_update_result
- name: Display update summary
debug:
ansible.builtin.debug:
msg: |
Zone: {{ item.zone }}
Changed: {{ item.changed }}