ansible-role-hosts

Configures /etc/hosts with custom records and/or configures the system to use custom DNS servers

Dependencies

Roles

None

Collections

None

Platforms

Supported platforms

• Red Hat Enterprise Linux 8¹
• Red Hat Enterprise Linux 9¹
• Red Hat Enterprise Linux 10¹
• RockyLinux 8
• RockyLinux 9
• RockyLinux 10
• OracleLinux 8
• OracleLinux 9
• OracleLinux 10
• AlmaLinux 8
• AlmaLinux 9
• AlmaLinux 10
• Debian 11 (Bullseye)
• Debian 12 (Bookworm)
• Debian 13 (Trixie)
• Ubuntu 20.04 LTS
• Ubuntu 22.04 LTS
• Ubuntu 24.04 LTS
• Ubuntu 26.04 LTS
• Fedora 43
• Fedora 44¹
• Alpine 3

Note: ¹ : no automated testing is performed on these platforms

Role Variables

defaults/main.yml

# Adapter to retrieve IP from
hosts_adapter: default

# Type of name resolving to configure
# hosts = /etc/hosts, dns = /etc/resolv.conf or both
hosts_mode: hosts

# list of name servers
hosts_dns_servers: []

Example Playbook

molecule/default/converge.yml

- name: sample playbook for role 'hosts'
  hosts: all
  become: 'yes'
  tasks:
    - name: Include role 'hosts'
      ansible.builtin.include_role:
        name: hosts