1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
# Reference
<!-- DO NOT EDIT: This document was generated by Puppet Strings -->
## Table of Contents
### Resource types
* [`augeas`](#augeas): Apply a change or an array of changes to the filesystem using the augeas tool.
## Resource types
### <a name="augeas"></a>`augeas`
Requires:
- [Augeas](http://www.augeas.net)
- The ruby-augeas bindings
#### Examples
##### Sample usage with a string:
```puppet
augeas { "test1":
context => "/files/etc/sysconfig/firstboot",
changes => "set RUN_FIRSTBOOT YES",
onlyif => "match other_value size > 0",
}
```
##### Sample usage with an array and custom lenses:
```puppet
augeas { "jboss_conf":
context => "/files",
changes => [
"set etc/jbossas/jbossas.conf/JBOSS_IP $ipaddress",
"set etc/jbossas/jbossas.conf/JAVA_HOME /usr",
],
load_path => "$/usr/share/jbossas/lenses",
}
```
#### Properties
The following properties are available in the `augeas` type.
##### `returns`
The expected return code from the augeas command. Should not be set.
Default value: `0`
#### Parameters
The following parameters are available in the `augeas` type.
* [`changes`](#-augeas--changes)
* [`context`](#-augeas--context)
* [`force`](#-augeas--force)
* [`incl`](#-augeas--incl)
* [`lens`](#-augeas--lens)
* [`load_path`](#-augeas--load_path)
* [`name`](#-augeas--name)
* [`onlyif`](#-augeas--onlyif)
* [`provider`](#-augeas--provider)
* [`root`](#-augeas--root)
* [`show_diff`](#-augeas--show_diff)
* [`type_check`](#-augeas--type_check)
##### <a name="-augeas--changes"></a>`changes`
The changes which should be applied to the filesystem. This
can be a command or an array of commands. The following commands are supported:
* `set <PATH> <VALUE>` --- Sets the value `VALUE` at location `PATH`
* `setm <PATH> <SUB> <VALUE>` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `VALUE`
* `rm <PATH>` --- Removes the node at location `PATH`
* `remove <PATH>` --- Synonym for `rm`
* `clear <PATH>` --- Sets the node at `PATH` to `NULL`, creating it if needed
* `clearm <PATH> <SUB>` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `NULL`
* `touch <PATH>` --- Creates `PATH` with the value `NULL` if it does not exist
* `ins <LABEL> (before|after) <PATH>` --- Inserts an empty node `LABEL` either before or after `PATH`.
* `insert <LABEL> <WHERE> <PATH>` --- Synonym for `ins`
* `mv <PATH> <OTHER PATH>` --- Moves a node at `PATH` to the new location `OTHER PATH`
* `move <PATH> <OTHER PATH>` --- Synonym for `mv`
* `rename <PATH> <LABEL>` --- Rename a node at `PATH` to a new `LABEL`
* `defvar <NAME> <PATH>` --- Sets Augeas variable `$NAME` to `PATH`
* `defnode <NAME> <PATH> <VALUE>` --- Sets Augeas variable `$NAME` to `PATH`, creating it with `VALUE` if needed
If the `context` parameter is set, that value is prepended to any relative `PATH`s.
##### <a name="-augeas--context"></a>`context`
Optional context path. This value is prepended to the paths of all
changes if the path is relative. If the `incl` parameter is set,
defaults to `/files + incl`; otherwise, defaults to the empty string.
Default value: `''`
##### <a name="-augeas--force"></a>`force`
Optional command to force the augeas type to execute even if it thinks changes
will not be made. This does not override the `onlyif` parameter.
Default value: `false`
##### <a name="-augeas--incl"></a>`incl`
Load only a specific file, such as `/etc/hosts`. This can greatly speed
up the execution the resource. When this parameter is set, you must also
set the `lens` parameter to indicate which lens to use.
##### <a name="-augeas--lens"></a>`lens`
Use a specific lens, such as `Hosts.lns`. When this parameter is set, you
must also set the `incl` parameter to indicate which file to load.
The Augeas documentation includes [a list of available lenses](http://augeas.net/stock_lenses.html).
##### <a name="-augeas--load_path"></a>`load_path`
Optional colon-separated list or array of directories; these directories are searched for schema definitions.
The agent's `$libdir/augeas/lenses` path will always be added to support pluginsync.
Default value: `''`
##### <a name="-augeas--name"></a>`name`
namevar
The name of this task. Used for uniqueness.
##### <a name="-augeas--onlyif"></a>`onlyif`
Optional augeas command and comparisons to control the execution of this type.
Note: `values` is not an actual augeas API command. It calls `match` to retrieve an array of paths
in <MATCH_PATH> and then `get` to retrieve the values from each of the returned paths.
Supported onlyif syntax:
* `get <AUGEAS_PATH> <COMPARATOR> <STRING>`
* `values <MATCH_PATH> include <STRING>`
* `values <MATCH_PATH> not_include <STRING>`
* `values <MATCH_PATH> == <AN_ARRAY>`
* `values <MATCH_PATH> != <AN_ARRAY>`
* `match <MATCH_PATH> size <COMPARATOR> <INT>`
* `match <MATCH_PATH> include <STRING>`
* `match <MATCH_PATH> not_include <STRING>`
* `match <MATCH_PATH> == <AN_ARRAY>`
* `match <MATCH_PATH> != <AN_ARRAY>`
where:
* `AUGEAS_PATH` is a valid path scoped by the context
* `MATCH_PATH` is a valid match syntax scoped by the context
* `COMPARATOR` is one of `>, >=, !=, ==, <=,` or `<`
* `STRING` is a string
* `INT` is a number
* `AN_ARRAY` is in the form `['a string', 'another']`
Default value: `''`
##### <a name="-augeas--provider"></a>`provider`
The specific backend to use for this `augeas` resource. You will seldom need to specify this --- Puppet will usually
discover the appropriate provider for your platform.
##### <a name="-augeas--root"></a>`root`
A file system path; all files loaded by Augeas are loaded underneath `root`.
Default value: `/`
##### <a name="-augeas--show_diff"></a>`show_diff`
Valid values: `true`, `false`, `yes`, `no`
Whether to display differences when the file changes, defaulting to
true. This parameter is useful for files that may contain passwords or
other secret data, which might otherwise be included in Puppet reports or
other insecure outputs. If the global `show_diff` setting
is false, then no diffs will be shown even if this parameter is true.
Default value: `true`
##### <a name="-augeas--type_check"></a>`type_check`
Valid values: `true`, `false`
Whether augeas should perform typechecking. Defaults to false.
Default value: `false`
|
