This repository has been archived on 2020-11-04. You can view files and clone it, but cannot push or open issues or pull requests.
ansible.basics/README.md

2.8 KiB
Raw Permalink Blame History

Basics

  1. Overview
  2. Role Variables
  3. Example Playbook
  4. Configuration
  5. Development
  6. License
  7. Author Information

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_hosts: Disable the management of /etc/hosts file by Proxmox for LXC containers [default: True].

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, also ensure to disable the management of /etc/hosts by Proxmox:

  • Touch a /etc/.pve-ignore.hosts 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

WTFPL

Author Information

Jérémy Gardais