ansible-freeipa-client

Overview

- hosts: all
  vars:
    freeipaclient_server: ipa.demo1.freeipa.org
    freeipaclient_domain: ipa.demo1.freeipa.org
    freeipaclient_enroll_user: admin
    freeipaclient_enroll_pass: Secret123
  roles:
     - alvaroaleman.freeipa-client

What It Does

This role helps connect client machines to an IPA domain.

System Requirements

• CentOS 7
• Red Hat Enterprise Linux 7
• Fedora 24
• Ubuntu Trusty
• Ubuntu Xenial
• Ubuntu Bionic

Role Variables

• freeipaclient_server: The IP address or hostname of the IPA server (string, required)
• freeipaclient_domain: The domain to be used (string, required)
• freeipaclient_enroll_user: Username for adding the host to the domain (string, required)
• freeipaclient_enroll_pass: Password for adding the host to the domain (string, required)
• freeipaclient_hostname: The hostname for the client (string, default: output of uname -n)
• freeipaclient_dns_server: DNS server to set up; no action if this is empty (string)
• freeipaclient_force_join: Whether to overwrite an existing host entry with the same name (boolean, default: false)
• freeipaclient_enable_ntp: Whether to enable NTP; important for Kerberos to function properly (boolean, default: true)
• freeipaclient_all_ip_addresses: Whether to add all routable IP addresses to DNS (boolean, default: true for all except Trusty, which is false)

License

GNU AFFERO GENERAL PUBLIC LICENSE Version 3

How to Contribute

If you wish to help improve this project, please note that it follows a gitflow workflow. The upcoming release branch is called next.

Please fork this repository, create a local branch from next, and submit pull requests back to the original next branch.

Testing the Integration

This role includes integration tests using Vagrant:

cp envvars-vagrant.sample envvars
EDITOR=vim
$EDITOR envvars
source envvars
make test

Author

Alvaro Aleman