summaryrefslogtreecommitdiff
path: root/README.markdown
diff options
context:
space:
mode:
authorHunter Haugen <hunter@puppetlabs.com>2016-03-17 09:25:38 -0700
committerHunter Haugen <hunter@puppetlabs.com>2016-03-17 09:25:38 -0700
commitb6383d259cf4917edd832ba31cf4dae2b4201235 (patch)
tree7ac0df39a11d5335c4373c48603341c4035327c0 /README.markdown
parent52f6af3accb4657d89aa26b623710b4e698cdde2 (diff)
parent0da9ca7e4a78df49c08873f55caf7c88cdd9bc32 (diff)
Merge pull request #576 from yadavnikhil/master
ensure_packages.rb: Modifed to pass hiera parameters (as hash,array) as first argument
Diffstat (limited to 'README.markdown')
-rw-r--r--README.markdown42
1 files changed, 40 insertions, 2 deletions
diff --git a/README.markdown b/README.markdown
index c9bbdad..e346f4f 100644
--- a/README.markdown
+++ b/README.markdown
@@ -351,7 +351,15 @@ brackets. *Type*: rvalue.
#### `ensure_packages`
-Takes a list of packages and only installs them if they don't already exist. It optionally takes a hash as a second parameter to be passed as the third argument to the `ensure_resource()` function. *Type*: statement.
+Takes a list of packages array/hash and only installs them if they don't already exist. It optionally takes a hash as a second parameter to be passed as the third argument to the `ensure_resource()` or `ensure_resources()` function. *Type*: statement.
+
+For Array:
+
+ ensure_packages(['ksh','openssl'], {'ensure' => 'present'})
+
+For Hash:
+
+ ensure_packages({'ksh' => { enure => '20120801-1' } , 'mypackage' => { source => '/tmp/myrpm-1.0.0.x86_64.rpm', provider => "rpm" }}, {'ensure' => 'present'})
#### `ensure_resource`
@@ -375,7 +383,37 @@ An array of resources can also be passed in, and each will be created with the t
*Type*: statement.
-#### `flatten`
+#### `ensure_resources`
+
+Takes a resource type, title (only hash), and a hash of attributes that describe the resource(s).
+
+~~~
+user { 'dan':
+ gid => 'mygroup',
+ ensure => present,
+}
+
+ensure_resources($user)
+~~~
+
+An hash of resources should be passed in and each will be created with the type and parameters specified if it doesn't already exist:
+
+ ensure_resources('user', {'dan' => { gid => 'mygroup', uid => '600' } , 'alex' => { gid => 'mygroup' }}, {'ensure' => 'present'})
+
+From Hiera Backend:
+
+~~~
+userlist:
+dan:
+ gid: 'mygroup'
+uid: '600'
+alex:
+gid: 'mygroup'
+
+ensure_resources('user', hiera_hash('userlist'), {'ensure' => 'present'})
+~~~
+
+### `flatten`
Flattens deeply nested arrays and returns a single flat array as a result. For example, `flatten(['a', ['b', ['c']]])` returns ['a','b','c']. *Type*: rvalue.