3.8 KiB
3.8 KiB
Basics
Overview
Manage some basics configuration for IPR's servers.
Role Variables
- basics__domain : Domain to use [default :
{{ ansible_domain }}
]. - basics__hosts_localhost_manage : If the localhost (127.0.0.1) line should be managed [default :
false
]. - basics__hosts_localhost_content : Content of the localhost (127.0.0.1) line [default :
localhost.localdomain localhost
]. - basics__hosts_ipv4_manage : If the ipv4 address line should be managed [default :
false
]. - basics__hosts_ipv4_content : Content of the ipv4 address line [default :
{{ ansible_hostname }}.{{ basics__domain }} {{ ansible_hostname }}
]. - *basics__proxmox_disable : Allow to disable the management of some files by Proxmox for LXC containers [default :
[]
]. - basics__resolvconf_packages : List of Resolvconf packages to install [default :
resolvconf
]. - basics__resolvconf_enabled : Enable or disable support for Resolvconf [default :
False
]. - basics__resolvconf_domains : List of domains used as search suffixes with Resolvconf [default :
{{ ansible_domain }}
]. - basics__resolvconf_nameservers : List of nameservers to use to resolv host names with Resolvconf [default :
{{ ansible_dns.nameservers }}
]. - basics__resolvconf_service_name : The Resolvconf service name to manage [default :
resolvconf
].
Example Playbook
- If you want to manage both localhost (127.0.0.1) and permanent IP (ipv4) lines :
- hosts: serverXYZ
roles:
- role: ipr-cnrs.basics
basics__hosts_localhost_manage: true
basics__hosts_ipv4_manage: true
- If the domain is not defined on the remote host, you should set the
basics__domain
variable :
- hosts: serverXYZ
roles:
- role: ipr-cnrs.basics
basics__domain: 'mydomain.org'
basics__hosts_ipv4_manage: true
Configuration
Hosts
Ensure to have the correct fqdn and hostname in /etc/hosts :
- You can define the domain if it's not correct on the remote host.
- You can choose to define the localhost (127.0.0.1) line content.
- You can choose to define the permanent ip (ipv4) line content.
- All other lines that contains hostname without this permanent ip address will be removed.
For LXC containers, you also have the possibility to disable the management of some files (/etc/hosts,…) by Proxmox. See Proxmox wiki about LXC.
Resolvconf
- If specified, Resolvconf is installed to fix the domain's informations given by the DHCP server.
- Configure a default configuration file with the given informations (list of domains and nameservers).
- Ensure to restart the service if any modification in configuration file.
Development
This source code comes from our Gogs instance and the Github repo exist just to be able to send the role to Ansible Galaxy…
But feel free to send issue/PR here :)
Thanks to this hook, Github automatically got updates from our Gogs instance :)
License
Author Information
Jérémy Gardais
- Source : on IPR's Gogs
- IPR (Institut de Physique de Rennes)