puppet 3.1.0.rc1 → 3.1.0.rc2
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of puppet might be problematic. Click here for more details.
- data/COMMITTERS.md +185 -0
- data/ext/debian/changelog.erb +6 -0
- data/ext/debian/puppet-common.manpages +1 -0
- data/ext/debian/puppet.default +3 -1
- data/ext/debian/puppetmaster.default +6 -3
- data/ext/redhat/puppet.spec.erb +16 -5
- data/lib/puppet.rb +3 -5
- data/lib/puppet/defaults.rb +6 -5
- data/lib/puppet/dsl.rb +3 -7
- data/lib/puppet/dsl/resource_api.rb +120 -0
- data/lib/puppet/dsl/resource_type_api.rb +34 -0
- data/lib/puppet/module_tool.rb +23 -11
- data/lib/puppet/network/formats.rb +1 -1
- data/lib/puppet/node/environment.rb +1 -3
- data/lib/puppet/parser/ast/definition.rb +5 -2
- data/lib/puppet/parser/ast/hostclass.rb +3 -2
- data/lib/puppet/parser/ast/node.rb +5 -2
- data/lib/puppet/parser/ast/resourceparam.rb +1 -1
- data/lib/puppet/parser/compiler.rb +0 -10
- data/lib/puppet/parser/lexer.rb +50 -39
- data/lib/puppet/parser/parser_support.rb +29 -11
- data/lib/puppet/parser/scope.rb +2 -2
- data/lib/puppet/parser/type_loader.rb +7 -31
- data/lib/puppet/provider/package/openbsd.rb +16 -2
- data/lib/puppet/provider/package/pip.rb +11 -2
- data/lib/puppet/provider/package/portage.rb +29 -12
- data/lib/puppet/provider/service/launchd.rb +19 -14
- data/lib/puppet/provider/service/upstart.rb +1 -1
- data/lib/puppet/provider/user/hpux.rb +37 -2
- data/lib/puppet/resource.rb +25 -38
- data/lib/puppet/resource/type.rb +6 -14
- data/lib/puppet/settings.rb +1 -1
- data/lib/puppet/ssl/certificate_authority.rb +4 -1
- data/lib/puppet/ssl/certificate_request.rb +3 -1
- data/lib/puppet/ssl/certificate_signer.rb +22 -0
- data/lib/puppet/type.rb +4 -4
- data/lib/puppet/util/methodhelper.rb +0 -19
- data/lib/puppet/util/rubygems.rb +3 -1
- data/lib/puppet/util/selinux.rb +1 -6
- data/lib/puppet/version.rb +1 -1
- data/man/man5/puppet.conf.5 +81 -95
- data/man/man8/extlookup2hiera.8 +23 -0
- data/man/man8/puppet-agent.8 +3 -3
- data/man/man8/puppet-apply.8 +2 -6
- data/man/man8/puppet-ca.8 +6 -7
- data/man/man8/puppet-catalog.8 +6 -7
- data/man/man8/puppet-cert.8 +4 -4
- data/man/man8/puppet-certificate.8 +6 -7
- data/man/man8/puppet-certificate_request.8 +6 -7
- data/man/man8/puppet-certificate_revocation_list.8 +6 -7
- data/man/man8/puppet-config.8 +4 -8
- data/man/man8/puppet-describe.8 +1 -1
- data/man/man8/puppet-device.8 +1 -1
- data/man/man8/puppet-doc.8 +3 -3
- data/man/man8/puppet-facts.8 +4 -8
- data/man/man8/puppet-file.8 +6 -7
- data/man/man8/puppet-filebucket.8 +1 -1
- data/man/man8/puppet-help.8 +2 -6
- data/man/man8/puppet-inspect.8 +1 -1
- data/man/man8/puppet-instrumentation_data.8 +3 -7
- data/man/man8/puppet-instrumentation_listener.8 +3 -7
- data/man/man8/puppet-instrumentation_probe.8 +3 -7
- data/man/man8/puppet-key.8 +6 -7
- data/man/man8/puppet-kick.8 +5 -1
- data/man/man8/puppet-man.8 +2 -6
- data/man/man8/puppet-master.8 +2 -2
- data/man/man8/puppet-module.8 +11 -9
- data/man/man8/puppet-node.8 +38 -37
- data/man/man8/puppet-parser.8 +2 -6
- data/man/man8/puppet-plugin.8 +2 -6
- data/man/man8/puppet-queue.8 +1 -1
- data/man/man8/puppet-report.8 +3 -7
- data/man/man8/puppet-resource.8 +1 -1
- data/man/man8/puppet-resource_type.8 +3 -7
- data/man/man8/puppet-secret_agent.8 +2 -6
- data/man/man8/puppet-status.8 +3 -7
- data/man/man8/puppet.8 +1 -1
- data/spec/integration/parser/ruby_manifest_spec.rb +128 -0
- data/spec/lib/puppet_spec/compiler.rb +0 -11
- data/spec/spec_helper.rb +3 -4
- data/spec/unit/dsl/resource_api_spec.rb +180 -0
- data/spec/unit/dsl/resource_type_api_spec.rb +53 -0
- data/spec/unit/module_tool_spec.rb +79 -46
- data/spec/unit/network/formats_spec.rb +4 -0
- data/spec/unit/node/environment_spec.rb +0 -13
- data/spec/unit/parser/compiler_spec.rb +0 -26
- data/spec/unit/parser/parser_spec.rb +14 -0
- data/spec/unit/parser/type_loader_spec.rb +4 -15
- data/spec/unit/provider/package/openbsd_spec.rb +148 -35
- data/spec/unit/provider/package/pip_spec.rb +49 -25
- data/spec/unit/provider/package/portage_spec.rb +65 -0
- data/spec/unit/provider/service/launchd_spec.rb +6 -5
- data/spec/unit/provider/user/hpux_spec.rb +39 -11
- data/spec/unit/provider/user/useradd_spec.rb +14 -14
- data/spec/unit/resource/type_spec.rb +7 -49
- data/spec/unit/resource_spec.rb +0 -32
- data/spec/unit/ssl/certificate_request_spec.rb +18 -0
- data/spec/unit/util/rubygems_spec.rb +1 -1
- data/spec/unit/util/selinux_spec.rb +0 -2
- metadata +17 -50
- data/lib/puppet/dsl/actions.rb +0 -283
- data/lib/puppet/dsl/blank_slate.rb +0 -55
- data/lib/puppet/dsl/context.rb +0 -393
- data/lib/puppet/dsl/parser.rb +0 -57
- data/lib/puppet/dsl/resource_decorator.rb +0 -56
- data/lib/puppet/dsl/resource_reference.rb +0 -95
- data/lib/puppet/dsl/type_reference.rb +0 -102
- data/lib/puppet/util/manifest_filetype_helper.rb +0 -22
- data/spec/integration/dsl/classes_spec.rb +0 -191
- data/spec/integration/dsl/defaults_spec.rb +0 -38
- data/spec/integration/dsl/definitions_spec.rb +0 -73
- data/spec/integration/dsl/functions_spec.rb +0 -95
- data/spec/integration/dsl/nodes_spec.rb +0 -96
- data/spec/integration/dsl/params_spec.rb +0 -146
- data/spec/integration/dsl/relationships_spec.rb +0 -46
- data/spec/integration/dsl/resources_spec.rb +0 -202
- data/spec/integration/dsl/type_loading_spec.rb +0 -64
- data/spec/lib/matchers/catalog.rb +0 -50
- data/spec/lib/puppet_spec/dsl.rb +0 -29
- data/spec/unit/dsl/actions_spec.rb +0 -402
- data/spec/unit/dsl/blank_slate_spec.rb +0 -27
- data/spec/unit/dsl/context_spec.rb +0 -678
- data/spec/unit/dsl/parser_spec.rb +0 -56
- data/spec/unit/dsl/resource_decorator_spec.rb +0 -94
- data/spec/unit/dsl/resource_reference_spec.rb +0 -150
- data/spec/unit/dsl/type_reference_spec.rb +0 -164
- data/spec/unit/util/manifest_filetype_helper_spec.rb +0 -29
@@ -1,6 +1,7 @@
|
|
1
1
|
require 'monitor'
|
2
2
|
require 'puppet/ssl/host'
|
3
3
|
require 'puppet/ssl/certificate_request'
|
4
|
+
require 'puppet/ssl/certificate_signer'
|
4
5
|
require 'puppet/util'
|
5
6
|
|
6
7
|
# The class that knows how to sign certificates. It creates
|
@@ -277,7 +278,9 @@ class Puppet::SSL::CertificateAuthority
|
|
277
278
|
cert = Puppet::SSL::Certificate.new(hostname)
|
278
279
|
cert.content = Puppet::SSL::CertificateFactory.
|
279
280
|
build(cert_type, csr, issuer, next_serial)
|
280
|
-
|
281
|
+
|
282
|
+
signer = Puppet::SSL::CertificateSigner.new
|
283
|
+
signer.sign(cert.content, host.key.content)
|
281
284
|
|
282
285
|
Puppet.notice "Signed certificate request for #{hostname}"
|
283
286
|
|
@@ -1,4 +1,5 @@
|
|
1
1
|
require 'puppet/ssl/base'
|
2
|
+
require 'puppet/ssl/certificate_signer'
|
2
3
|
|
3
4
|
# Manage certificate requests.
|
4
5
|
class Puppet::SSL::CertificateRequest < Puppet::SSL::Base
|
@@ -59,7 +60,8 @@ class Puppet::SSL::CertificateRequest < Puppet::SSL::Base
|
|
59
60
|
csr.add_attribute(OpenSSL::X509::Attribute.new("extReq", extReq))
|
60
61
|
end
|
61
62
|
|
62
|
-
|
63
|
+
signer = Puppet::SSL::CertificateSigner.new
|
64
|
+
signer.sign(csr, key)
|
63
65
|
|
64
66
|
raise Puppet::Error, "CSR sign verification failed; you need to clean the certificate request for #{name} on the server" unless csr.verify(key.public_key)
|
65
67
|
|
@@ -0,0 +1,22 @@
|
|
1
|
+
# Take care of signing a certificate in a FIPS 140-2 compliant manner.
|
2
|
+
#
|
3
|
+
# @see http://projects.puppetlabs.com/issues/17295
|
4
|
+
#
|
5
|
+
# @api private
|
6
|
+
class Puppet::SSL::CertificateSigner
|
7
|
+
def initialize
|
8
|
+
if OpenSSL::Digest.const_defined?('SHA256')
|
9
|
+
@digest = OpenSSL::Digest::SHA256
|
10
|
+
elsif OpenSSL::Digest.const_defined?('SHA1')
|
11
|
+
@digest = OpenSSL::Digest::SHA1
|
12
|
+
else
|
13
|
+
raise Puppet::Error,
|
14
|
+
"No FIPS 140-2 compliant digest algorithm in OpenSSL::Digest"
|
15
|
+
end
|
16
|
+
@digest
|
17
|
+
end
|
18
|
+
|
19
|
+
def sign(content, key)
|
20
|
+
content.sign(key, @digest.new)
|
21
|
+
end
|
22
|
+
end
|
data/lib/puppet/type.rb
CHANGED
@@ -611,11 +611,11 @@ class Type
|
|
611
611
|
@name_var_cache = (key_attributes.length == 1) && key_attributes.first
|
612
612
|
end
|
613
613
|
|
614
|
-
# Gets the '
|
615
|
-
# To explicitly get the 'is' value use `o.is(:name)`, and to get the 'should' value
|
614
|
+
# Gets the 'should' (wanted state) value of a parameter or property by name.
|
615
|
+
# To explicitly get the 'is' (current state) value use `o.is(:name)`, and to explicitly get the 'should' value
|
616
616
|
# use `o.should(:name)`
|
617
|
-
# @param name [String] the name of the attribute to obtain the '
|
618
|
-
# @return [Object]
|
617
|
+
# @param name [String] the name of the attribute to obtain the 'should' value for.
|
618
|
+
# @return [Object] 'should'/wanted value of the given attribute
|
619
619
|
def [](name)
|
620
620
|
name = name.intern
|
621
621
|
fail("Invalid parameter #{name}(#{name.inspect})") unless self.class.validattr?(name)
|
@@ -1,7 +1,5 @@
|
|
1
1
|
# Where we store helper methods related to, um, methods.
|
2
2
|
module Puppet::Util::MethodHelper
|
3
|
-
extend self
|
4
|
-
|
5
3
|
def requiredopts(*names)
|
6
4
|
names.each do |name|
|
7
5
|
devfail("#{name} is a required option for #{self.class}") if self.send(name).nil?
|
@@ -31,21 +29,4 @@ module Puppet::Util::MethodHelper
|
|
31
29
|
hash
|
32
30
|
end
|
33
31
|
end
|
34
|
-
|
35
|
-
##
|
36
|
-
# Helper to validate options. Example:
|
37
|
-
#
|
38
|
-
# validate_options [:arguments, :inherits], options
|
39
|
-
#
|
40
|
-
# It expects list of valid options and a hash to validate as a last
|
41
|
-
# argument.
|
42
|
-
##
|
43
|
-
def validate_options(allow, options = {})
|
44
|
-
options.each do |k, _|
|
45
|
-
unless Array(allow).include? k
|
46
|
-
raise ArgumentError, "unrecognized option #{k}"
|
47
|
-
end
|
48
|
-
end
|
49
|
-
end
|
50
|
-
|
51
32
|
end
|
data/lib/puppet/util/rubygems.rb
CHANGED
@@ -39,7 +39,9 @@ module Puppet::Util::RubyGems
|
|
39
39
|
# @api private
|
40
40
|
class Gems18Source < Source
|
41
41
|
def directories
|
42
|
-
|
42
|
+
# `require 'mygem'` will consider and potentally load
|
43
|
+
# prerelease gems, so we need to match that behavior.
|
44
|
+
Gem::Specification.latest_specs(true).collect do |spec|
|
43
45
|
File.join(spec.full_gem_path, 'lib')
|
44
46
|
end
|
45
47
|
end
|
data/lib/puppet/util/selinux.rb
CHANGED
@@ -43,13 +43,8 @@ module Puppet::Util::SELinux
|
|
43
43
|
# matching. If not, we can pass a mode of 0.
|
44
44
|
begin
|
45
45
|
filestat = file_lstat(file)
|
46
|
-
rescue Errno::EACCES, Errno::ENOENT => detail
|
47
|
-
warning "Could not stat; #{detail}"
|
48
|
-
end
|
49
|
-
|
50
|
-
if filestat
|
51
46
|
mode = filestat.mode
|
52
|
-
|
47
|
+
rescue Errno::EACCES, Errno::ENOENT
|
53
48
|
mode = 0
|
54
49
|
end
|
55
50
|
|
data/lib/puppet/version.rb
CHANGED
data/man/man5/puppet.conf.5
CHANGED
@@ -1,8 +1,8 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
2
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPETCONF" "5" "
|
5
|
-
\fBThis page is autogenerated; any changes will get overwritten\fR \fI(last generated on
|
4
|
+
.TH "PUPPETCONF" "5" "January 2013" "Puppet Labs, LLC" "Puppet manual"
|
5
|
+
\fBThis page is autogenerated; any changes will get overwritten\fR \fI(last generated on Tue Jan 15 12:33:09 \-0800 2013)\fR
|
6
6
|
.
|
7
7
|
.SH "Configuration Settings"
|
8
8
|
.
|
@@ -19,6 +19,9 @@ Settings can be interpolated as \fB$variables\fR in other settings; \fB$environm
|
|
19
19
|
Multiple values should be specified as comma\-separated lists; multiple directories should be separated with the system path separator (usually a colon)\.
|
20
20
|
.
|
21
21
|
.IP "\(bu" 4
|
22
|
+
Settings that represent time intervals should be specified in duration format: an integer immediately followed by one of the units \'y\' (years of 365 days), \'d\' (days), \'h\' (hours), \'m\' (minutes), or \'s\' (seconds)\. The unit cannot be combined with other units, and defaults to seconds when omitted\. Examples are \'3600\' which is equivalent to \'1h\' (one hour), and \'1825d\' which is equivalent to \'5y\' (5 years)\.
|
23
|
+
.
|
24
|
+
.IP "\(bu" 4
|
22
25
|
Settings that take a single file or directory can optionally set the owner, group, and mode for their value: \fBrundir = $vardir/run { owner = puppet, group = puppet, mode = 644 }\fR
|
23
26
|
.
|
24
27
|
.IP "\(bu" 4
|
@@ -29,6 +32,14 @@ The Puppet executables will ignore any setting that isn\'t relevant to their fun
|
|
29
32
|
.P
|
30
33
|
See the configuration guide \fIhttp://docs\.puppetlabs\.com/guides/configuring\.html\fR for more details\.
|
31
34
|
.
|
35
|
+
.SS "agent_catalog_run_lockfile"
|
36
|
+
A lock file to indicate that a puppet agent catalog run is currently in progress\. The file contains the pid of the process that holds the lock on the catalog run\.
|
37
|
+
.
|
38
|
+
.IP "\(bu" 4
|
39
|
+
\fIDefault\fR: $statedir/agent_catalog_run\.lock
|
40
|
+
.
|
41
|
+
.IP "" 0
|
42
|
+
.
|
32
43
|
.SS "agent_disabled_lockfile"
|
33
44
|
A lock file to indicate that puppet agent runs have been administratively disabled\. File contains a JSON object with state information\.
|
34
45
|
.
|
@@ -37,16 +48,16 @@ A lock file to indicate that puppet agent runs have been administratively disabl
|
|
37
48
|
.
|
38
49
|
.IP "" 0
|
39
50
|
.
|
40
|
-
.SS "
|
41
|
-
|
51
|
+
.SS "allow_duplicate_certs"
|
52
|
+
Whether to allow a new certificate request to overwrite an existing certificate\.
|
42
53
|
.
|
43
54
|
.IP "\(bu" 4
|
44
|
-
\fIDefault\fR:
|
55
|
+
\fIDefault\fR: false
|
45
56
|
.
|
46
57
|
.IP "" 0
|
47
58
|
.
|
48
|
-
.SS "
|
49
|
-
|
59
|
+
.SS "allow_variables_with_dashes"
|
60
|
+
Permit hyphens (\fB\-\fR) in variable names and issue deprecation warnings about them\. This setting \fBshould always be \fBfalse\fR;\fR setting it to \fBtrue\fR will cause subtle and wide\-ranging bugs\. It will be removed in a future version\. Hyphenated variables caused major problems in the language, but were allowed between Puppet 2\.7\.3 and 2\.7\.14\. If you used them during this window, we apologize for the inconvenience \-\-\- you can temporarily set this to \fBtrue\fR in order to upgrade, and can rename your variables at your leisure\. Please revert it to \fBfalse\fR after you have renamed all affected variables\.
|
50
61
|
.
|
51
62
|
.IP "\(bu" 4
|
52
63
|
\fIDefault\fR: false
|
@@ -70,21 +81,13 @@ During an inspect run, whether to archive files whose contents are audited to a
|
|
70
81
|
.IP "" 0
|
71
82
|
.
|
72
83
|
.SS "async_storeconfigs"
|
73
|
-
Whether to use a queueing system to provide asynchronous database integration\. Requires that \fBpuppet queue\fR be running
|
84
|
+
Whether to use a queueing system to provide asynchronous database integration\. Requires that \fBpuppet queue\fR be running\.
|
74
85
|
.
|
75
86
|
.IP "\(bu" 4
|
76
87
|
\fIDefault\fR: false
|
77
88
|
.
|
78
89
|
.IP "" 0
|
79
90
|
.
|
80
|
-
.SS "authconfig"
|
81
|
-
The configuration file that defines the rights to the different namespaces and methods\. This can be used as a coarse\-grained authorization system for both \fBpuppet agent\fR and \fBpuppet master\fR\.
|
82
|
-
.
|
83
|
-
.IP "\(bu" 4
|
84
|
-
\fIDefault\fR: $confdir/namespaceauth\.conf
|
85
|
-
.
|
86
|
-
.IP "" 0
|
87
|
-
.
|
88
91
|
.SS "autoflush"
|
89
92
|
Whether log files should always flush to disk\.
|
90
93
|
.
|
@@ -102,7 +105,12 @@ Whether to enable autosign\. Valid values are true (which autosigns any key requ
|
|
102
105
|
.IP "" 0
|
103
106
|
.
|
104
107
|
.SS "bindaddress"
|
105
|
-
The address a listening server should bind to\.
|
108
|
+
The address a listening server should bind to\.
|
109
|
+
.
|
110
|
+
.IP "\(bu" 4
|
111
|
+
\fIDefault\fR: 0\.0\.0\.0
|
112
|
+
.
|
113
|
+
.IP "" 0
|
106
114
|
.
|
107
115
|
.SS "bucketdir"
|
108
116
|
Where FileBucket files are stored\.
|
@@ -120,17 +128,6 @@ Whether the master should function as a certificate authority\.
|
|
120
128
|
.
|
121
129
|
.IP "" 0
|
122
130
|
.
|
123
|
-
.SS "ca_days"
|
124
|
-
How long a certificate should be valid, in days\. This setting is deprecated; use \fBca_ttl\fR instead
|
125
|
-
.
|
126
|
-
.SS "ca_md"
|
127
|
-
The type of hash used in certificates\.
|
128
|
-
.
|
129
|
-
.IP "\(bu" 4
|
130
|
-
\fIDefault\fR: md5
|
131
|
-
.
|
132
|
-
.IP "" 0
|
133
|
-
.
|
134
131
|
.SS "ca_name"
|
135
132
|
The name to use the Certificate Authority certificate\.
|
136
133
|
.
|
@@ -156,7 +153,7 @@ The server to use for certificate authority requests\. It\'s a separate server b
|
|
156
153
|
.IP "" 0
|
157
154
|
.
|
158
155
|
.SS "ca_ttl"
|
159
|
-
The default TTL for new certificates
|
156
|
+
The default TTL for new certificates\. If this setting is set, ca_days is ignored\. Can be specified as a duration\.
|
160
157
|
.
|
161
158
|
.IP "\(bu" 4
|
162
159
|
\fIDefault\fR: 5y
|
@@ -218,6 +215,13 @@ The CA public key\.
|
|
218
215
|
\fIDefault\fR: $cadir/ca_pub\.pem
|
219
216
|
.
|
220
217
|
.IP "" 0
|
218
|
+
.
|
219
|
+
.SS "catalog_cache_terminus"
|
220
|
+
How to store cached catalogs\. Valid values are \'json\' and \'yaml\'\. The agent application defaults to \'json\'\.
|
221
|
+
.
|
222
|
+
.TP
|
223
|
+
\fIDefault\fR:
|
224
|
+
|
221
225
|
.
|
222
226
|
.SS "catalog_format"
|
223
227
|
(Deprecated for \'preferred_serialization_format\') What format to use to dump the catalog\. Only supports \'marshal\' and \'yaml\'\. Only matters on the client, since it asks the server for a specific format\.
|
@@ -249,6 +253,14 @@ The certificate directory\.
|
|
249
253
|
.SS "certdnsnames"
|
250
254
|
The \fBcertdnsnames\fR setting is no longer functional, after CVE\-2011\-3872\. We ignore the value completely\. For your own certificate request you can set \fBdns_alt_names\fR in the configuration and it will apply locally\. There is no configuration option to set DNS alt names, or any other \fBsubjectAltName\fR value, for another nodes certificate\. Alternately you can use the \fB\-\-dns_alt_names\fR command line option to set the labels added while generating your own CSR\.
|
251
255
|
.
|
256
|
+
.SS "certificate_expire_warning"
|
257
|
+
The window of time leading up to a certificate\'s expiration that a notification will be logged\. This applies to CA, master, and agent certificates\. Can be specified as a duration\.
|
258
|
+
.
|
259
|
+
.IP "\(bu" 4
|
260
|
+
\fIDefault\fR: 60d
|
261
|
+
.
|
262
|
+
.IP "" 0
|
263
|
+
.
|
252
264
|
.SS "certificate_revocation"
|
253
265
|
Whether certificate revocation should be supported by downloading a Certificate Revocation List (CRL) to all clients\. If enabled, CA chaining will almost definitely not work\.
|
254
266
|
.
|
@@ -261,7 +273,7 @@ Whether certificate revocation should be supported by downloading a Certificate
|
|
261
273
|
The name to use when handling certificates\. Defaults to the fully qualified domain name\.
|
262
274
|
.
|
263
275
|
.IP "\(bu" 4
|
264
|
-
\fIDefault\fR:
|
276
|
+
\fIDefault\fR: sirrus\.puppetlabs\.lan
|
265
277
|
.
|
266
278
|
.IP "" 0
|
267
279
|
.
|
@@ -339,10 +351,10 @@ How to determine the configuration version\. By default, it will be the time tha
|
|
339
351
|
Print the value of a specific configuration setting\. If the name of a setting is provided for this, then the value is printed and puppet exits\. Comma\-separate multiple values\. For a list of all values, specify \'all\'\.
|
340
352
|
.
|
341
353
|
.SS "configtimeout"
|
342
|
-
How long the client should wait for the configuration to be retrieved before considering it a failure\. This can help reduce flapping if too many clients contact the server at one time\.
|
354
|
+
How long the client should wait for the configuration to be retrieved before considering it a failure\. This can help reduce flapping if too many clients contact the server at one time\. Can be specified as a duration\.
|
343
355
|
.
|
344
356
|
.IP "\(bu" 4
|
345
|
-
\fIDefault\fR:
|
357
|
+
\fIDefault\fR: 2m
|
346
358
|
.
|
347
359
|
.IP "" 0
|
348
360
|
.
|
@@ -494,16 +506,8 @@ Document all resources
|
|
494
506
|
.
|
495
507
|
.IP "" 0
|
496
508
|
.
|
497
|
-
.SS "downcasefacts"
|
498
|
-
Whether facts should be made all lowercase when sent to the server\.
|
499
|
-
.
|
500
|
-
.IP "\(bu" 4
|
501
|
-
\fIDefault\fR: false
|
502
|
-
.
|
503
|
-
.IP "" 0
|
504
|
-
.
|
505
509
|
.SS "dynamicfacts"
|
506
|
-
Facts that are dynamic; these facts will be ignored when deciding whether changed facts should result in a recompile\. Multiple facts should be comma\-separated\.
|
510
|
+
(Deprecated) Facts that are dynamic; these facts will be ignored when deciding whether changed facts should result in a recompile\. Multiple facts should be comma\-separated\.
|
507
511
|
.
|
508
512
|
.IP "\(bu" 4
|
509
513
|
\fIDefault\fR: memorysize,memoryfree,swapsize,swapfree
|
@@ -559,10 +563,10 @@ Where the fileserver configuration is stored\.
|
|
559
563
|
.IP "" 0
|
560
564
|
.
|
561
565
|
.SS "filetimeout"
|
562
|
-
The minimum time to wait
|
566
|
+
The minimum time to wait between checking for updates in configuration files\. This timeout determines how quickly Puppet checks whether a file (such as manifests or templates) has changed on disk\. Can be specified as a duration\.
|
563
567
|
.
|
564
568
|
.IP "\(bu" 4
|
565
|
-
\fIDefault\fR:
|
569
|
+
\fIDefault\fR: 15s
|
566
570
|
.
|
567
571
|
.IP "" 0
|
568
572
|
.
|
@@ -785,14 +789,6 @@ The LDAP attributes to use to define Puppet classes\. Values should be comma\-se
|
|
785
789
|
.
|
786
790
|
.IP "" 0
|
787
791
|
.
|
788
|
-
.SS "ldapnodes"
|
789
|
-
Whether to search for node configurations in LDAP\. See http://projects\.puppetlabs\.com/projects/puppet/wiki/LDAP_Nodes for more information\.
|
790
|
-
.
|
791
|
-
.IP "\(bu" 4
|
792
|
-
\fIDefault\fR: false
|
793
|
-
.
|
794
|
-
.IP "" 0
|
795
|
-
.
|
796
792
|
.SS "ldapparentattr"
|
797
793
|
The attribute to use to define the parent node\.
|
798
794
|
.
|
@@ -805,7 +801,7 @@ The attribute to use to define the parent node\.
|
|
805
801
|
The password to use to connect to LDAP\.
|
806
802
|
.
|
807
803
|
.SS "ldapport"
|
808
|
-
The LDAP port\. Only used if \
|
804
|
+
The LDAP port\. Only used if \fBnode_terminus\fR is set to \fBldap\fR\.
|
809
805
|
.
|
810
806
|
.IP "\(bu" 4
|
811
807
|
\fIDefault\fR: 389
|
@@ -813,7 +809,7 @@ The LDAP port\. Only used if \fBldapnodes\fR is enabled\.
|
|
813
809
|
.IP "" 0
|
814
810
|
.
|
815
811
|
.SS "ldapserver"
|
816
|
-
The LDAP server\. Only used if \
|
812
|
+
The LDAP server\. Only used if \fBnode_terminus\fR is set to \fBldap\fR\.
|
817
813
|
.
|
818
814
|
.IP "\(bu" 4
|
819
815
|
\fIDefault\fR: ldap
|
@@ -855,14 +851,6 @@ Whether TLS should be used when searching for nodes\. Defaults to false because
|
|
855
851
|
.SS "ldapuser"
|
856
852
|
The user to use to connect to LDAP\. Must be specified as a full DN\.
|
857
853
|
.
|
858
|
-
.SS "lexical"
|
859
|
-
Whether to use lexical scoping (vs\. dynamic)\.
|
860
|
-
.
|
861
|
-
.IP "\(bu" 4
|
862
|
-
\fIDefault\fR: false
|
863
|
-
.
|
864
|
-
.IP "" 0
|
865
|
-
.
|
866
854
|
.SS "libdir"
|
867
855
|
An extra search path for Puppet\. This is only useful for those files that Puppet will load on demand, and is only guaranteed to work for those cases\. In fact, the autoload mechanism is responsible for making sure this directory is in Ruby\'s search path
|
868
856
|
.
|
@@ -970,7 +958,7 @@ Whether to create the necessary user and group that puppet agent will run as\.
|
|
970
958
|
The module repository
|
971
959
|
.
|
972
960
|
.IP "\(bu" 4
|
973
|
-
\fIDefault\fR:
|
961
|
+
\fIDefault\fR: https://forge\.puppetlabs\.com
|
974
962
|
.
|
975
963
|
.IP "" 0
|
976
964
|
.
|
@@ -996,6 +984,13 @@ The name of the application, if we are running as one\. The default is essential
|
|
996
984
|
.TP
|
997
985
|
\fIDefault\fR:
|
998
986
|
|
987
|
+
.
|
988
|
+
.SS "node_cache_terminus"
|
989
|
+
How to store cached nodes\. Valid values are (none), \'json\', \'yaml\' or write only yaml (\'write_only_yaml\')\. The master application defaults to \'write_only_yaml\', all others to none\.
|
990
|
+
.
|
991
|
+
.TP
|
992
|
+
\fIDefault\fR:
|
993
|
+
|
999
994
|
.
|
1000
995
|
.SS "node_name"
|
1001
996
|
How the puppet master determines the client\'s identity and sets the \'hostname\', \'fqdn\' and \'domain\' facts for use in the manifest, in particular for determining which \'node\' statement applies to the client\. Possible values are \'cert\' (use the subject\'s CN in the client\'s certificate) and \'facter\' (use the hostname that the client reported in its facts)
|
@@ -1057,7 +1052,7 @@ The shell search path\. Defaults to whatever is inherited from the parent proces
|
|
1057
1052
|
.IP "" 0
|
1058
1053
|
.
|
1059
1054
|
.SS "pidfile"
|
1060
|
-
The
|
1055
|
+
The file containing the PID of a running process\. This file is intended to be used by service management frameworks and monitoring systems to determine if a puppet process is still in the process table\.
|
1061
1056
|
.
|
1062
1057
|
.IP "\(bu" 4
|
1063
1058
|
\fIDefault\fR: $rundir/${run_mode}\.pid
|
@@ -1218,7 +1213,7 @@ The directory in which to store reports received from the client\. Each client g
|
|
1218
1213
|
The \'from\' email address for the reports\.
|
1219
1214
|
.
|
1220
1215
|
.IP "\(bu" 4
|
1221
|
-
\fIDefault\fR: report@
|
1216
|
+
\fIDefault\fR: report@sirrus\.puppetlabs\.lan
|
1222
1217
|
.
|
1223
1218
|
.IP "" 0
|
1224
1219
|
.
|
@@ -1230,14 +1225,6 @@ The list of reports to generate\. All reports are looked for in \fBpuppet/report
|
|
1230
1225
|
.
|
1231
1226
|
.IP "" 0
|
1232
1227
|
.
|
1233
|
-
.SS "reportserver"
|
1234
|
-
(Deprecated for \'report_server\') The server to which to send transaction reports\.
|
1235
|
-
.
|
1236
|
-
.IP "\(bu" 4
|
1237
|
-
\fIDefault\fR: $server
|
1238
|
-
.
|
1239
|
-
.IP "" 0
|
1240
|
-
.
|
1241
1228
|
.SS "reporturl"
|
1242
1229
|
The URL used by the http reports processor to send reports
|
1243
1230
|
.
|
@@ -1295,19 +1282,12 @@ The directory where RRD database files are stored\. Directories for each reporti
|
|
1295
1282
|
.IP "" 0
|
1296
1283
|
.
|
1297
1284
|
.SS "rrdinterval"
|
1298
|
-
How often RRD should expect data\. This should match how often the hosts report back to the server\.
|
1285
|
+
How often RRD should expect data\. This should match how often the hosts report back to the server\. Can be specified as a duration\.
|
1299
1286
|
.
|
1300
1287
|
.IP "\(bu" 4
|
1301
1288
|
\fIDefault\fR: $runinterval
|
1302
1289
|
.
|
1303
1290
|
.IP "" 0
|
1304
|
-
.
|
1305
|
-
.SS "run_mode"
|
1306
|
-
The effective \'run mode\' of the application: master, agent, or user\.
|
1307
|
-
.
|
1308
|
-
.TP
|
1309
|
-
\fIDefault\fR:
|
1310
|
-
|
1311
1291
|
.
|
1312
1292
|
.SS "rundir"
|
1313
1293
|
Where Puppet PID files are kept\.
|
@@ -1317,10 +1297,10 @@ Where Puppet PID files are kept\.
|
|
1317
1297
|
|
1318
1298
|
.
|
1319
1299
|
.SS "runinterval"
|
1320
|
-
How often puppet agent applies the client configuration; in seconds\. Note that a runinterval of 0 means "run continuously" rather than "never run\." If you want puppet agent to never run, you should start it with the \fB\-\-no\-client\fR option\.
|
1300
|
+
How often puppet agent applies the client configuration; in seconds\. Note that a runinterval of 0 means "run continuously" rather than "never run\." If you want puppet agent to never run, you should start it with the \fB\-\-no\-client\fR option\. Can be specified as a duration\.
|
1321
1301
|
.
|
1322
1302
|
.IP "\(bu" 4
|
1323
|
-
\fIDefault\fR:
|
1303
|
+
\fIDefault\fR: 30m
|
1324
1304
|
.
|
1325
1305
|
.IP "" 0
|
1326
1306
|
.
|
@@ -1356,14 +1336,6 @@ The directory in which serialized data is stored, usually in a subdirectory\.
|
|
1356
1336
|
.
|
1357
1337
|
.IP "" 0
|
1358
1338
|
.
|
1359
|
-
.SS "servertype"
|
1360
|
-
The type of server to use\. Currently supported option is webrick\.
|
1361
|
-
.
|
1362
|
-
.IP "\(bu" 4
|
1363
|
-
\fIDefault\fR: webrick
|
1364
|
-
.
|
1365
|
-
.IP "" 0
|
1366
|
-
.
|
1367
1339
|
.SS "show_diff"
|
1368
1340
|
Whether to log and report a contextual diff when files are being replaced\. This causes partial file contents to pass through Puppet\'s normal logging and reporting system, so this setting should be used with caution if you are sending Puppet\'s reports to an insecure destination\. This feature currently requires the \fBdiff/lcs\fR Ruby library\.
|
1369
1341
|
.
|
@@ -1397,7 +1369,7 @@ Whether to sleep for a pseudo\-random (but consistent) amount of time before a r
|
|
1397
1369
|
.IP "" 0
|
1398
1370
|
.
|
1399
1371
|
.SS "splaylimit"
|
1400
|
-
The maximum time to delay before runs\. Defaults to being the same as the run interval\.
|
1372
|
+
The maximum time to delay before runs\. Defaults to being the same as the run interval\. Can be specified as a duration\.
|
1401
1373
|
.
|
1402
1374
|
.IP "\(bu" 4
|
1403
1375
|
\fIDefault\fR: $runinterval
|
@@ -1411,6 +1383,13 @@ The domain which will be queried to find the SRV records of servers to use\.
|
|
1411
1383
|
\fIDefault\fR: puppetlabs\.lan
|
1412
1384
|
.
|
1413
1385
|
.IP "" 0
|
1386
|
+
.
|
1387
|
+
.SS "ssl_client_ca_auth"
|
1388
|
+
Certificate authorities who issue server certificates\. SSL servers will not be considered authentic unless they posses a certificate issued by an authority listed in this file\. If this setting has no value then the Puppet master\'s CA certificate (localcacert) will be used\.
|
1389
|
+
.
|
1390
|
+
.TP
|
1391
|
+
\fIDefault\fR:
|
1392
|
+
|
1414
1393
|
.
|
1415
1394
|
.SS "ssl_client_header"
|
1416
1395
|
The header containing an authenticated client\'s SSL DN\. This header must be set by the proxy to the authenticated client\'s SSL DN (e\.g\., \fB/CN=puppet\.puppetlabs\.com\fR)\.
|
@@ -1427,6 +1406,13 @@ The header containing the status message of the client verification\. This heade
|
|
1427
1406
|
\fIDefault\fR: HTTP_X_CLIENT_VERIFY
|
1428
1407
|
.
|
1429
1408
|
.IP "" 0
|
1409
|
+
.
|
1410
|
+
.SS "ssl_server_ca_auth"
|
1411
|
+
Certificate authorities who issue client certificates\. SSL clients will not be considered authentic unless they posses a certificate issued by an authority listed in this file\. If this setting has no value then the Puppet master\'s CA certificate (localcacert) will be used\.
|
1412
|
+
.
|
1413
|
+
.TP
|
1414
|
+
\fIDefault\fR:
|
1415
|
+
|
1430
1416
|
.
|
1431
1417
|
.SS "ssldir"
|
1432
1418
|
Where SSL certificates are kept\.
|
@@ -1512,7 +1498,7 @@ Where Puppet looks for template files\. Can be a list of colon\-separated direct
|
|
1512
1498
|
.IP "" 0
|
1513
1499
|
.
|
1514
1500
|
.SS "thin_storeconfigs"
|
1515
|
-
Boolean; whether
|
1501
|
+
Boolean; whether Puppet should store only facts and exported resources in the storeconfigs database\. This will improve the performance of exported resources with the older \fBactive_record\fR backend, but will disable external tools that search the storeconfigs database\. Thinning catalogs is generally unnecessary when using PuppetDB to store catalogs\.
|
1516
1502
|
.
|
1517
1503
|
.IP "\(bu" 4
|
1518
1504
|
\fIDefault\fR: false
|
@@ -1568,10 +1554,10 @@ Where Puppet stores dynamic and growing data\. The default for this setting is c
|
|
1568
1554
|
.IP "" 0
|
1569
1555
|
.
|
1570
1556
|
.SS "waitforcert"
|
1571
|
-
The time interval
|
1557
|
+
The time interval \'puppet agent\' should connect to the server and ask it to sign a certificate request\. This is useful for the initial setup of a puppet client\. You can turn off waiting for certificates by specifying a time of 0\. Can be specified as a duration\.
|
1572
1558
|
.
|
1573
1559
|
.IP "\(bu" 4
|
1574
|
-
\fIDefault\fR:
|
1560
|
+
\fIDefault\fR: 2m
|
1575
1561
|
.
|
1576
1562
|
.IP "" 0
|
1577
1563
|
.
|
@@ -1592,4 +1578,4 @@ Boolean; whether to use the zlib library
|
|
1592
1578
|
.IP "" 0
|
1593
1579
|
.
|
1594
1580
|
.P
|
1595
|
-
\fIThis page autogenerated on
|
1581
|
+
\fIThis page autogenerated on Tue Jan 15 12:33:09 \-0800 2013\fR
|