|
1 | | -# ipa Puppet module |
2 | | -[](https://travis-ci.org/Puppet-Finland/puppet-ipa) |
| 1 | +# ipa |
3 | 2 |
|
4 | 3 | ## Overview |
5 | 4 |
|
6 | | -This module will install and configure IPA servers, replicas, and clients. This module was forked from huit-ipa, |
7 | | -and refactored with a focus on simplicity and ease of use. |
| 5 | +This module manages [FreeIPA](https://www.freeipa.org/) servers, replicas, and clients. |
| 6 | + |
| 7 | +This module was forked from [Puppet-Finland/puppet-ipa](https://github.com/Puppet-Finland/puppet-ipa), |
| 8 | +which was forked from [jpuskar/puppet-ipa](https://github.com/jpuskar/puppet-ipa), |
| 9 | +which was forked from [huit/puppet-ipa](https://github.com/huit/puppet-ipa). |
8 | 10 |
|
9 | 11 | ## Usage |
10 | 12 |
|
11 | 13 | ### Example usage: |
12 | 14 |
|
13 | 15 | ```puppet |
14 | 16 | class { 'ipa': |
15 | | - ipa_role => 'master', |
16 | | - domain => 'vagrant.example.lan', |
17 | | - ipa_server_fqdn => 'ipa-server-1.vagrant.example.lan', |
18 | | - admin_password => 'vagrant123', |
19 | | - directory_services_password => 'vagrant123', |
20 | | - ip_address => '192.168.56.35', |
21 | | - enable_ip_address => true, |
22 | | - enable_hostname => true, |
| 17 | + ipa_role => 'master', |
| 18 | + domain => 'example.com', |
| 19 | + admin_password => 'rspecrspec123', |
| 20 | + directory_services_password => 'rspecrspec123', |
| 21 | + idstart => 70000, |
| 22 | + configure_dns_server => false, |
| 23 | + configure_ntp => false, |
23 | 24 | } |
24 | 25 | ``` |
25 | 26 |
|
26 | 27 | Adding a replica: |
27 | 28 |
|
28 | 29 | ```puppet |
29 | 30 | class { 'ipa': |
30 | | - ipa_role => 'replica', |
31 | | - domain => 'vagrant.example.lan', |
32 | | - ipa_server_fqdn => 'ipa-server-2.vagrant.example.lan', |
33 | | - domain_join_password => 'vagrant123', |
34 | | - ip_address => '192.168.56.36', |
35 | | - enable_ip_address => true, |
36 | | - enable_hostname => true, |
37 | | - ipa_master_fqdn => 'ipa-server-1.vagrant.example.lan', |
| 31 | + ipa_role => 'replica', |
| 32 | + domain => 'example.com', |
| 33 | + ipa_master_fqdn => 'master-puppet8.example.com', |
| 34 | + admin_password => 'rspecrspec123', |
| 35 | + configure_dns_server => false, |
| 36 | + configure_ntp => false, |
| 37 | + configure_replica_ca => true, |
38 | 38 | } |
39 | 39 | ``` |
40 | 40 |
|
41 | 41 | Adding a client: |
42 | 42 |
|
43 | 43 | ```puppet |
44 | 44 | class { 'ipa': |
45 | | -ipa_role => 'client', |
46 | | -domain => 'vagrant.example.lan', |
47 | | -domain_join_password => 'vagrant123', |
48 | | -ipa_master_fqdn => 'ipa-server-1.vagrant.example.lan', |
| 45 | + ipa_role => 'client', |
| 46 | + domain => 'example.com', |
| 47 | + domain_join_principal => 'admin', |
| 48 | + domain_join_password => 'rspecrspec123', |
| 49 | + ipa_master_fqdn => 'master-puppet8.example.com', |
| 50 | + configure_ntp => false, |
49 | 51 | } |
50 | 52 | ``` |
0 commit comments