hiera-ldapprovider 1.0.2 → 1.0.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +57 -50
  3. data/lib/hiera/backend/ldap.rb +1 -1
  4. metadata +1 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: f9dcce63a21cecc44d7d78fccb8e63834fe6228e
4
- data.tar.gz: 7ca58c58013a8f9bd01465460a74fd5cbfcee36d
3
+ metadata.gz: f0871470681d1e239cdccde7bcce3584eb6441d2
4
+ data.tar.gz: 86ffedd97568f32b3f6635e29fbde1eb829fef17
5
5
  SHA512:
6
- metadata.gz: c667b30b72e476d9f47c97fc77660ad0c81fa1aa06114205c420ed1dbddcddf649377aa77a32b7f8b86e26d6ba377fe0afad1a2576963463e3b4c5feae2b4434
7
- data.tar.gz: b1d945b0817353de2c1e6182a42bfaa96503897a054cbf56dd752d8d2456574854375b9f3e34154cdf06acfae2610f40ed1fa72cf1baf7ccfd3cd62c552f808a
6
+ metadata.gz: 5bbe0536070462211f8ed7a5ee3a3115d8d5afc8aaef0e2dd7db4de1914fa9915626686f8f5b645b0909dec46b71dcc611eebd36e2a7c47996a743b2cbe32096
7
+ data.tar.gz: 4849346ada83977afdfa7af14371b6233047ee05185ad65fa52d37b8141c0bea11d838f35f670e8d1618664ffe1a0430d270c90c4436e4521ece9cd2c11a652a
data/README.md CHANGED
@@ -4,81 +4,88 @@ This module allows hiera to look up entries in LDAP. It will return an array of
4
4
 
5
5
  # Installation
6
6
 
7
- This module can be placed in your puppet module path and will be pluginsync'd to the master.
7
+ This module can be installed via rubygems:
8
+
9
+ ```bash
10
+ $ gem install hiera-ldapprovider
11
+ ```
8
12
 
9
13
  # Use
10
14
 
11
15
  ## Ldap example:
12
16
 
13
- dn: uid=nibz,ou=People,dc=catnip
14
- loginShell: /usr/bin/zsh
15
- objectClass: top
16
- objectClass: account
17
- objectClass: posixAccount
18
- objectClass: shadowAccount
19
- objectClass: person
20
- objectClass: organizationalPerson
21
- objectClass: inetOrgPerson
22
- objectClass: podPerson
23
- uid: nibz
24
- uidNumber: 1861
25
- gidNumber: 300
26
- homeDirectory: /u/nibz
27
- gecos: Spencer O Krum
28
- cn: Spencer O Krum
29
- sn: Krum
30
- givenName: Spencer
31
- mail: nibz@cecs.pdx.edu
32
-
17
+ ```ldif
18
+ objectClass: dNSDomain
19
+ objectClass: domain
20
+ objectClass: ipHost
21
+ objectClass: puppetClient
22
+ objectClass: top
23
+ cn: client1
24
+ dc: example.com
25
+ ipHostNumber: 10.0.0.1
26
+ aRecord: client1.example.com
27
+ environment: production
28
+ puppetclass: rbackup
29
+ puppetclass: ntp
30
+ puppetclass: apache2
31
+ puppetclass: snmpd
32
+ puppetvar: service_ensure=running
33
+ ```
33
34
 
34
35
  ## Configuration example
35
- <pre>
36
+
37
+ ```yaml
36
38
 
37
39
  :ldap:
38
- :base: ou=People,dc=cat,dc=pdx,dc=edu
39
- :host: ldap.cat.pdx.edu
40
- :port: 636
40
+ :base: ou=machines,dc=example,dc=com
41
+ :host: ldap.example.com
42
+ :port: 389 # Default: 389
43
+ :attribute: cn # Default: cn
41
44
  :encryption: :simple_tls
42
45
  :auth:
43
46
  :method: :simple
44
- :username: uid=network,ou=Netgroup,dc=cat,dc=pdx,dc=edu
47
+ :username: uid=network,ou=Netgroup,dc=example,dc=com
45
48
  :password: PASSWORD
46
-
47
- </pre>
49
+ ```
48
50
 
49
51
  ## Puppet example
50
52
 
53
+ In this example a hierarchy will be used. See [PuppetDoc](http://docs.puppetlabs.com/hiera/1/variables.html#in-data-sources) on how to define a hierarchy:
51
54
 
52
- # get info from ldap and put into a hash
55
+ ```yaml
56
+ :hierarchy:
57
+ - "%{::clientcert}"
58
+ - "common"
59
+ ```
53
60
 
54
- $rooter_info = hiera("uid=${username}")
55
- if $rooter_info == undef {
56
- fail ("Hiera/LDAP look up on ${username} failed. Aborting.")
57
- }
61
+ #### Get a String from LDAP
58
62
 
59
- # use the hashdata to fill out user paramaters
60
- # as of now, the ldap/hiera backend downcases ldap attributes
63
+ ```puppetl
64
+ notify {'message':
65
+ message => hiera("ipHostNumber")
66
+ }
67
+ # => Notice: /Stage[main]/Main/Node[client1]/Notify[message]/message: defined 'message' as '10.0.0.1'
68
+ ```
61
69
 
62
- user { $username:
63
- ensure => present,
64
- gid => 'root',
65
- uid => $rooter_info['uidnumber'],
66
- home => $rooter_info['homedirectory'],
67
- managehome => true,
68
- shell => $rooter_info['loginshell'],
69
- comment => $rooter_info['gecos'],
70
- }
70
+ #### Get an Array of Elements from LDAP
71
+ ```puppetl
72
+ notify {'message':
73
+ message => hiera_array("puppetclass")
74
+ }
75
+ ```
71
76
 
72
- # Details
73
-
74
- - It wraps the pramaters to Net::LDAP.new so anything you can do there you can do here
77
+ #### Get a Hash from LDAP
75
78
 
79
+ ```puppetl
80
+ notify {'message':
81
+ message => hiera_hash("puppetclass")
82
+ }
83
+ ```
76
84
 
77
- # Advanced
85
+ # Details
78
86
 
79
- The key being looked up is actually processsed just like rfc4515 so you can use advanced ldap searches:
87
+ - It wraps the pramaters to Net::LDAP.new so anything you can do there you can do here
80
88
 
81
- hiera('(|(uid=nibz)(uidNumber=1861))')
82
89
 
83
90
  # Authors
84
91
 
data/lib/hiera/backend/ldap.rb CHANGED
@@ -1,7 +1,7 @@
1
1
  class Hiera
2
2
  module Backend
3
3
  module LDAP
4
- VERSION="1.0.2"
4
+ VERSION="1.0.3"
5
5
  end
6
6
  end
7
7
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: hiera-ldapprovider
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.2
4
+ version: 1.0.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - Florian Kasper