ahuffman / ansible-resolv

Ansible role to configure /etc/resolv.conf

ahuffman.resolv

An Ansible role to configure /etc/resolv.conf

Role Variables

Defaults

Variable Name	Required	Description	Default Value	Type
resolv_nameservers	yes	A list of up to 3 nameserver IP addresses	[]	list
resolv_domain	no	Local domain name	""	string
resolv_search	no	List of up to 6 domains to search for host-name lookup	[]	list
resolv_sortlist	no	List of IP-address and netmask pairs to sort addresses returned by gethostbyname.	[]	list
resolv_options	no	List of options to modify certain internal resolver variables.	[]	list

Example Playbooks

Role Invocation

    - name: "Role Invocation - ahuffman.resolv Example"
      hosts: "all"
      roles:
        - role: "ahuffman.resolv"
          resolv_nameservers:
            - "8.8.8.8"
            - "8.8.4.4"
          resolv_domain: "foo.org"
          resolv_search:
            - "foo.bar"
            - "foobar.com"
          resolv_options:
            - "timeout:2"
            - "rotate"

Role Invocation with externaly defined variables (group_vars / host_vars)

    - name: "Role Invocation - ahuffman.resolv Example"
      hosts: "all"
      roles:
        - role: "ahuffman.resolv"
          when:
            - resolv_nameservers is defined
            - resolv_nameservers | length > 0

Included Role

---
- name: "Included Role - ahuffman.resolv Example"
  hosts: "all"
  tasks:
    - name: "Configure resolv.conf"
      include_role:
        name: "ahuffman.resolv"
      vars:
        resolv_nameservers:
          - "8.8.8.8"
          - "8.8.4.4"
        resolv_domain: "foo.org"
        resolv_search:
          - "foo.bar"
          - "foobar.com"
        resolv_options:
          - "timeout:2"
          - "rotate"

License

MIT

Author Information

Andrew J. Huffman

ansible-resolv's Issues

no longer pulls correctly via ansible galaxy command

The command in the documentation to pull this role from ansible galaxy no longer works correctly, because it is trying to pull version v1.2.tar.gz which doesn't exist.

ansible-galaxy install ahuffman.resolv
- downloading role 'resolv', owned by ahuffman
- downloading role from https://github.com/ahuffman/ansible-resolv/archive/v1.2.tar.gz
 [ERROR]: failed to download the file: HTTP Error 404: Not Found

 [WARNING]: - ahuffman.resolv was NOT installed successfully.

ERROR! - you can use --ignore-errors to skip failed roles and finish processing the list.

options written to multiple 'options' lines

The existing template writes options to multiple lines. I'm not sure if this will work in different OSes. I think it's a fairly simple change to write the options to a single line, which will likely be compatible with more different OSes, using a join instead of a for loop.

{{ ansible_managed }}

{% if resolv_search %}
search {{ resolv_search|join(' ') }}
{% endif %}
{% if resolv_domain %}
domain {{ resolv_domain }}
{% endif %}
{% for i in resolv_nameservers %}
nameserver {{ i }}
{% endfor %}
{% for i in resolv_sortlist %}
sortlist {{ i }}
{% endfor %}
{% if resolv_options %}
options {{ resolv_options|join(' ') }}
{% endif %}