72 lines
2.1 KiB
Markdown
72 lines
2.1 KiB
Markdown
# ansible-freeipa-client
|
|
|
|
## Synopsis
|
|
|
|
```yaml
|
|
- 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
|
|
```
|
|
|
|
## Description
|
|
|
|
This role allows to join clients to an ipa domain
|
|
|
|
## Requirements
|
|
|
|
* CentOS 7
|
|
* Red Hat Enterprise Linux 7
|
|
* Fedora 24
|
|
* Ubuntu Trusty
|
|
* Ubuntu Xenial
|
|
* Ubuntu Bionic
|
|
|
|
## Role Variables
|
|
|
|
* ``freeipaclient_server``: IP/Hostname of IPA server to use (string, mandatory)
|
|
* ``freeipaclient_domain``: Domain to use (string, mandatory)
|
|
* ``freeipaclient_enroll_user``: Username to enroll host in domain (string, mandatory)
|
|
* ``freeipaclient_enroll_pass``: Password to enroll host in domain (string, mandatory)
|
|
* ``freeipaclient_hostname``: The hostname to use for the client (string, default: output of ``uname -n``)
|
|
* ``freeipaclient_dns_server``: DNS server to configure. This will not do anything if variable is empty (string)
|
|
* ``freeipaclient_force_join``: Whether to overwrite an already existing host entry of requested name (boolean, default: ``false``)
|
|
* ``freeipaclient_enable_ntp``: Whether to enable ntp. Kerberos won't work if the time of master and client drift too much (boolean, default: ``true``)
|
|
* ``freeipaclient_all_ip_addresses``: Whether to add all routable ip addresses to DNS (boolean, default: ``true if not Trusty, else false``)
|
|
|
|
|
|
## License
|
|
|
|
GNU AFFERO GENERAL PUBLIC LICENSE Version 3
|
|
|
|
## Contributing
|
|
|
|
If you want to contribute to this repository please be aware that this
|
|
project uses a [gitflow](http://nvie.com/posts/a-successful-git-branching-model/)
|
|
workflow with the next release branch called ``next``.
|
|
|
|
Please fork this repository and create a local branch split off of the ``next``
|
|
branch and create pull requests back to the origin ``next`` branch.
|
|
|
|
## Integration testing
|
|
|
|
This role provides integration tests using Vagrant:
|
|
|
|
```bash
|
|
cp envvars-vagrant.sample envvars
|
|
EDITOR=vim
|
|
$EDITOR envvars
|
|
source envvars
|
|
make test
|
|
```
|
|
|
|
## Author information
|
|
|
|
Alvaro Aleman
|
|
|
|
<!-- vim: set nofen ts=4 sw=4 et: -->
|