Add missing files
This commit is contained in:
71
roles/alvaroaleman.freeipa-client/README.md
Normal file
71
roles/alvaroaleman.freeipa-client/README.md
Normal file
@@ -0,0 +1,71 @@
|
||||
# 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: -->
|
||||
Reference in New Issue
Block a user