puppet 5.0.0-universal-darwin → 5.0.1-universal-darwin
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.
- checksums.yaml +7 -0
- data/README.md +1 -1
- data/ext/puppet-test +1 -1
- data/lib/puppet.rb +3 -1
- data/lib/puppet/application/lookup.rb +2 -2
- data/lib/puppet/defaults.rb +1 -1
- data/lib/puppet/face/epp.rb +26 -24
- data/lib/puppet/face/module/search.rb +1 -1
- data/lib/puppet/forge.rb +3 -2
- data/lib/puppet/functions/each.rb +1 -1
- data/lib/puppet/functions/filter.rb +1 -1
- data/lib/puppet/module.rb +28 -1
- data/lib/puppet/module_tool.rb +2 -2
- data/lib/puppet/module_tool/applications/installer.rb +5 -5
- data/lib/puppet/module_tool/applications/uninstaller.rb +1 -1
- data/lib/puppet/module_tool/applications/upgrader.rb +5 -5
- data/lib/puppet/module_tool/shared_behaviors.rb +2 -2
- data/lib/puppet/parser/compiler.rb +4 -0
- data/lib/puppet/parser/functions/assert_type.rb +1 -1
- data/lib/puppet/parser/functions/binary_file.rb +1 -1
- data/lib/puppet/parser/functions/break.rb +1 -1
- data/lib/puppet/parser/functions/defined.rb +1 -1
- data/lib/puppet/parser/functions/dig.rb +1 -1
- data/lib/puppet/parser/functions/each.rb +2 -2
- data/lib/puppet/parser/functions/epp.rb +1 -1
- data/lib/puppet/parser/functions/filter.rb +2 -2
- data/lib/puppet/parser/functions/find_file.rb +1 -1
- data/lib/puppet/parser/functions/inline_epp.rb +1 -1
- data/lib/puppet/parser/functions/lest.rb +1 -1
- data/lib/puppet/parser/functions/map.rb +1 -1
- data/lib/puppet/parser/functions/match.rb +1 -1
- data/lib/puppet/parser/functions/new.rb +1 -1
- data/lib/puppet/parser/functions/next.rb +1 -1
- data/lib/puppet/parser/functions/reduce.rb +1 -1
- data/lib/puppet/parser/functions/return.rb +1 -1
- data/lib/puppet/parser/functions/reverse_each.rb +2 -2
- data/lib/puppet/parser/functions/slice.rb +1 -1
- data/lib/puppet/parser/functions/step.rb +2 -2
- data/lib/puppet/parser/functions/strftime.rb +1 -1
- data/lib/puppet/parser/functions/then.rb +1 -1
- data/lib/puppet/parser/functions/type.rb +1 -1
- data/lib/puppet/parser/functions/with.rb +1 -1
- data/lib/puppet/pops/merge_strategy.rb +1 -1
- data/lib/puppet/pops/time/timestamp.rb +2 -2
- data/lib/puppet/provider/nameservice.rb +4 -2
- data/lib/puppet/reference/configuration.rb +1 -1
- data/lib/puppet/reports/http.rb +4 -2
- data/lib/puppet/resource/capability_finder.rb +1 -1
- data/lib/puppet/util/execution.rb +1 -1
- data/lib/puppet/util/logging.rb +8 -4
- data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/gem_version.rb +1 -1
- data/lib/puppet/vendor/semantic_puppet/lib/semantic_puppet/version.rb +1 -1
- data/lib/puppet/version.rb +1 -1
- data/locales/puppet.pot +66 -58
- data/man/man5/puppet.conf.5 +233 -63
- data/man/man8/puppet-agent.8 +31 -9
- data/man/man8/puppet-apply.8 +20 -5
- data/man/man8/puppet-ca.8 +48 -34
- data/man/man8/puppet-catalog.8 +12 -15
- data/man/man8/puppet-cert.8 +23 -6
- data/man/man8/puppet-certificate.8 +52 -36
- data/man/man8/puppet-certificate_request.8 +10 -10
- data/man/man8/puppet-certificate_revocation_list.8 +9 -9
- data/man/man8/puppet-config.8 +5 -5
- data/man/man8/puppet-describe.8 +3 -3
- data/man/man8/puppet-device.8 +13 -5
- data/man/man8/puppet-doc.8 +5 -5
- data/man/man8/puppet-epp.8 +16 -10
- data/man/man8/puppet-facts.8 +9 -9
- data/man/man8/puppet-filebucket.8 +44 -5
- data/man/man8/puppet-generate.8 +84 -0
- data/man/man8/puppet-help.8 +4 -4
- data/man/man8/puppet-key.8 +11 -11
- data/man/man8/puppet-lookup.8 +104 -0
- data/man/man8/puppet-man.8 +5 -5
- data/man/man8/puppet-master.8 +5 -5
- data/man/man8/puppet-module.8 +29 -17
- data/man/man8/puppet-node.8 +9 -9
- data/man/man8/puppet-parser.8 +4 -4
- data/man/man8/puppet-plugin.8 +4 -4
- data/man/man8/puppet-report.8 +9 -9
- data/man/man8/puppet-resource.8 +4 -8
- data/man/man8/puppet-status.8 +9 -9
- data/man/man8/puppet.8 +12 -3
- data/spec/integration/util/execution_spec.rb +8 -0
- data/spec/unit/application/lookup_spec.rb +1 -1
- data/spec/unit/face/epp_face_spec.rb +9 -0
- data/spec/unit/face/module/search_spec.rb +1 -1
- data/spec/unit/functions/lookup_spec.rb +26 -0
- data/spec/unit/indirector/file_bucket_file/file_spec.rb +3 -3
- data/spec/unit/module_spec.rb +64 -0
- data/spec/unit/module_tool_spec.rb +22 -0
- data/spec/unit/parser/scope_spec.rb +1 -1
- data/spec/unit/pops/types/p_timestamp_type_spec.rb +30 -1
- data/spec/unit/puppet_spec.rb +33 -0
- data/spec/unit/util/logging_spec.rb +18 -9
- data/tasks/generate_ast_model.rake +48 -44
- data/tasks/manpages.rake +9 -1
- data/tasks/parallel.rake +12 -7
- metadata +3515 -3526
- data/man/man8/puppet-inspect.8 +0 -36
@@ -1,13 +1,13 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-CERTIFICATE" "8" "
|
4
|
+
.TH "PUPPET\-CERTIFICATE" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-certificate\fR \- Provide access to the CA for certificate management\.
|
8
8
|
.
|
9
9
|
.SH "SYNOPSIS"
|
10
|
-
puppet certificate \fIaction\fR [\-\-terminus
|
10
|
+
puppet certificate \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
|
11
11
|
.
|
12
12
|
.SH "DESCRIPTION"
|
13
13
|
This subcommand interacts with a local or remote Puppet certificate authority\. Currently, its behavior is not a full superset of \fBpuppet cert\fR; specifically, it is unable to mimic puppet cert\'s "clean" option, and its "generate" action submits a CSR rather than creating a signed certificate\.
|
@@ -16,7 +16,7 @@ This subcommand interacts with a local or remote Puppet certificate authority\.
|
|
16
16
|
Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
17
17
|
.
|
18
18
|
.P
|
19
|
-
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/
|
19
|
+
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
20
20
|
.
|
21
21
|
.TP
|
22
22
|
\-\-render\-as FORMAT
|
@@ -42,7 +42,7 @@ This option is required\.
|
|
42
42
|
A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
|
43
43
|
.
|
44
44
|
.TP
|
45
|
-
\-\-terminus
|
45
|
+
\-\-terminus _TERMINUS
|
46
46
|
Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
|
47
47
|
.
|
48
48
|
.IP
|
@@ -53,12 +53,11 @@ The terminus for an action is often determined by context, but occasionally need
|
|
53
53
|
.
|
54
54
|
.SH "ACTIONS"
|
55
55
|
.
|
56
|
-
.
|
57
|
-
\fBdestroy\fR \- Delete a certificate
|
58
|
-
\fBSYNOPSIS\fR
|
56
|
+
.IP "\(bu" 4
|
57
|
+
\fBdestroy\fR \- Delete a certificate\.: \fBSYNOPSIS\fR
|
59
58
|
.
|
60
59
|
.IP
|
61
|
-
puppet certificate destroy [\-\-terminus
|
60
|
+
puppet certificate destroy [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
|
62
61
|
.
|
63
62
|
.IP
|
64
63
|
\fBDESCRIPTION\fR
|
@@ -72,12 +71,11 @@ Deletes a certificate\. This action currently only works on the local CA\.
|
|
72
71
|
.IP
|
73
72
|
Nothing\.
|
74
73
|
.
|
75
|
-
.
|
76
|
-
\fBfind\fR \- Retrieve a certificate
|
77
|
-
\fBSYNOPSIS\fR
|
74
|
+
.IP "\(bu" 4
|
75
|
+
\fBfind\fR \- Retrieve a certificate\.: \fBSYNOPSIS\fR
|
78
76
|
.
|
79
77
|
.IP
|
80
|
-
puppet certificate find [\-\-terminus
|
78
|
+
puppet certificate find [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR \fIhost\fR
|
81
79
|
.
|
82
80
|
.IP
|
83
81
|
\fBDESCRIPTION\fR
|
@@ -94,12 +92,11 @@ An x509 SSL certificate\.
|
|
94
92
|
.IP
|
95
93
|
Note that this action has a side effect of caching a copy of the certificate in Puppet\'s \fBssldir\fR\.
|
96
94
|
.
|
97
|
-
.
|
98
|
-
\fBgenerate\fR \- Generate a new certificate signing request
|
99
|
-
\fBSYNOPSIS\fR
|
95
|
+
.IP "\(bu" 4
|
96
|
+
\fBgenerate\fR \- Generate a new certificate signing request\.: \fBSYNOPSIS\fR
|
100
97
|
.
|
101
98
|
.IP
|
102
|
-
puppet certificate generate [\-\-terminus
|
99
|
+
puppet certificate generate [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-dns\-alt\-names NAMES] \fIhost\fR
|
103
100
|
.
|
104
101
|
.IP
|
105
102
|
\fBDESCRIPTION\fR
|
@@ -111,19 +108,39 @@ Generates and submits a certificate signing request (CSR) for the specified host
|
|
111
108
|
Puppet agent usually handles CSR submission automatically\. This action is primarily useful for requesting certificates for individual users and external applications\.
|
112
109
|
.
|
113
110
|
.IP
|
114
|
-
\fBOPTIONS\fR \fI\-\-dns\-alt\-names NAMES\fR \-
|
111
|
+
\fBOPTIONS\fR \fI\-\-dns\-alt\-names NAMES\fR \- A comma\-separated list of alternate DNS names for Puppet Server\. These are extra hostnames (in addition to its \fBcertname\fR) that the server is allowed to use when serving agents\. Puppet checks this setting when automatically requesting a certificate for Puppet agent or Puppet Server, and when manually generating a certificate with \fBpuppet cert generate\fR\.
|
115
112
|
.
|
116
113
|
.IP
|
117
|
-
|
114
|
+
In order to handle agent requests at a given hostname (like "puppet\.example\.com"), Puppet Server needs a certificate that proves it\'s allowed to use that name; if a server shows a certificate that doesn\'t include its hostname, Puppet agents will refuse to trust it\. If you use a single hostname for Puppet traffic but load\-balance it to multiple Puppet Servers, each of those servers needs to include the official hostname in its list of extra names\.
|
118
115
|
.
|
119
116
|
.IP
|
120
|
-
|
117
|
+
\fBNote:\fR The list of alternate names is locked in when the server\'s certificate is signed\. If you need to change the list later, you can\'t just change this setting; you also need to:
|
121
118
|
.
|
122
|
-
.IP
|
123
|
-
|
119
|
+
.IP "\(bu" 4
|
120
|
+
On the server: Stop Puppet Server\.
|
121
|
+
.
|
122
|
+
.IP "\(bu" 4
|
123
|
+
On the CA server: Revoke and clean the server\'s old certificate\. (\fBpuppet cert clean <NAME>\fR)
|
124
|
+
.
|
125
|
+
.IP "\(bu" 4
|
126
|
+
On the server: Delete the old certificate (and any old certificate signing requests) from the ssldir \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/dirs_ssldir\.html\fR\.
|
127
|
+
.
|
128
|
+
.IP "\(bu" 4
|
129
|
+
On the server: Run \fBpuppet agent \-t \-\-ca_server <CA HOSTNAME>\fR to request a new certificate
|
130
|
+
.
|
131
|
+
.IP "\(bu" 4
|
132
|
+
On the CA server: Sign the certificate request, explicitly allowing alternate names (\fBpuppet cert sign \-\-allow\-dns\-alt\-names <NAME>\fR)\.
|
133
|
+
.
|
134
|
+
.IP "\(bu" 4
|
135
|
+
On the server: Run \fBpuppet agent \-t \-\-ca_server <CA HOSTNAME>\fR to retrieve the cert\.
|
136
|
+
.
|
137
|
+
.IP "\(bu" 4
|
138
|
+
On the server: Start Puppet Server again\.
|
139
|
+
.
|
140
|
+
.IP "" 0
|
124
141
|
.
|
125
142
|
.IP
|
126
|
-
|
143
|
+
To see all the alternate names your servers are using, log into your CA server and run \fBpuppet cert list \-a\fR, then check the output for \fB(alt names: \.\.\.)\fR\. Most agent nodes should NOT have alternate names; the only certs that should have them are Puppet Server nodes that you want other agents to trust\.
|
127
144
|
.
|
128
145
|
.IP
|
129
146
|
\fBRETURNS\fR
|
@@ -131,12 +148,11 @@ It is rarely necessary for servers; it is usually helpful only if you need to ha
|
|
131
148
|
.IP
|
132
149
|
Nothing\.
|
133
150
|
.
|
134
|
-
.
|
135
|
-
\fBinfo\fR \- Print the default terminus class for this face
|
136
|
-
\fBSYNOPSIS\fR
|
151
|
+
.IP "\(bu" 4
|
152
|
+
\fBinfo\fR \- Print the default terminus class for this face\.: \fBSYNOPSIS\fR
|
137
153
|
.
|
138
154
|
.IP
|
139
|
-
puppet certificate info [\-\-terminus
|
155
|
+
puppet certificate info [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
|
140
156
|
.
|
141
157
|
.IP
|
142
158
|
\fBDESCRIPTION\fR
|
@@ -144,12 +160,11 @@ puppet certificate info [\-\-terminus TERMINUS] [\-\-extra HASH] \fI\-\-ca\-loca
|
|
144
160
|
.IP
|
145
161
|
Prints the default terminus class for this subcommand\. Note that different run modes may have different default termini; when in doubt, specify the run mode with the \'\-\-run_mode\' option\.
|
146
162
|
.
|
147
|
-
.
|
148
|
-
\fBlist\fR \- List all certificate signing requests
|
149
|
-
\fBSYNOPSIS\fR
|
163
|
+
.IP "\(bu" 4
|
164
|
+
\fBlist\fR \- List all certificate signing requests\.: \fBSYNOPSIS\fR
|
150
165
|
.
|
151
166
|
.IP
|
152
|
-
puppet certificate list [\-\-terminus
|
167
|
+
puppet certificate list [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR
|
153
168
|
.
|
154
169
|
.IP
|
155
170
|
\fBDESCRIPTION\fR
|
@@ -163,12 +178,11 @@ List all certificate signing requests\.
|
|
163
178
|
.IP
|
164
179
|
An array of #inspect output from CSR objects\. This output is currently messy, but does contain the names of nodes requesting certificates\. This action returns #inspect strings even when used from the Ruby API\.
|
165
180
|
.
|
166
|
-
.
|
167
|
-
\fBsign\fR \- Sign a certificate signing request for HOST
|
168
|
-
\fBSYNOPSIS\fR
|
181
|
+
.IP "\(bu" 4
|
182
|
+
\fBsign\fR \- Sign a certificate signing request for HOST\.: \fBSYNOPSIS\fR
|
169
183
|
.
|
170
184
|
.IP
|
171
|
-
puppet certificate sign [\-\-terminus
|
185
|
+
puppet certificate sign [\-\-terminus _TERMINUS] [\-\-extra HASH] \fI\-\-ca\-location LOCATION\fR [\-\-[no\-]allow\-dns\-alt\-names] \fIhost\fR
|
172
186
|
.
|
173
187
|
.IP
|
174
188
|
\fBDESCRIPTION\fR
|
@@ -185,6 +199,8 @@ Sign a certificate signing request for HOST\.
|
|
185
199
|
.IP
|
186
200
|
A string that appears to be (but isn\'t) an x509 certificate\.
|
187
201
|
.
|
202
|
+
.IP "" 0
|
203
|
+
.
|
188
204
|
.SH "EXAMPLES"
|
189
205
|
\fBgenerate\fR
|
190
206
|
.
|
@@ -221,4 +237,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
|
|
221
237
|
.IP "" 0
|
222
238
|
.
|
223
239
|
.SH "COPYRIGHT AND LICENSE"
|
224
|
-
Copyright 2011 by Puppet
|
240
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|
@@ -1,13 +1,13 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-CERTIFICATE_REQUEST" "8" "
|
4
|
+
.TH "PUPPET\-CERTIFICATE_REQUEST" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-certificate_request\fR \- Manage certificate requests\.
|
8
8
|
.
|
9
9
|
.SH "SYNOPSIS"
|
10
|
-
puppet certificate_request \fIaction\fR [\-\-terminus
|
10
|
+
puppet certificate_request \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
|
11
11
|
.
|
12
12
|
.SH "DESCRIPTION"
|
13
13
|
This subcommand retrieves and submits certificate signing requests (CSRs)\.
|
@@ -16,7 +16,7 @@ This subcommand retrieves and submits certificate signing requests (CSRs)\.
|
|
16
16
|
Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
17
17
|
.
|
18
18
|
.P
|
19
|
-
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/
|
19
|
+
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
20
20
|
.
|
21
21
|
.TP
|
22
22
|
\-\-render\-as FORMAT
|
@@ -35,7 +35,7 @@ Whether to log debug information\.
|
|
35
35
|
A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
|
36
36
|
.
|
37
37
|
.TP
|
38
|
-
\-\-terminus
|
38
|
+
\-\-terminus _TERMINUS
|
39
39
|
Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
|
40
40
|
.
|
41
41
|
.IP
|
@@ -51,7 +51,7 @@ The terminus for an action is often determined by context, but occasionally need
|
|
51
51
|
\fBSYNOPSIS\fR
|
52
52
|
.
|
53
53
|
.IP
|
54
|
-
puppet certificate_request find [\-\-terminus
|
54
|
+
puppet certificate_request find [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fIhost\fR]
|
55
55
|
.
|
56
56
|
.IP
|
57
57
|
\fBDESCRIPTION\fR
|
@@ -73,7 +73,7 @@ Defaults to the current nodes certname\.
|
|
73
73
|
\fBSYNOPSIS\fR
|
74
74
|
.
|
75
75
|
.IP
|
76
|
-
puppet certificate_request info [\-\-terminus
|
76
|
+
puppet certificate_request info [\-\-terminus _TERMINUS] [\-\-extra HASH]
|
77
77
|
.
|
78
78
|
.IP
|
79
79
|
\fBDESCRIPTION\fR
|
@@ -86,7 +86,7 @@ Prints the default terminus class for this subcommand\. Note that different run
|
|
86
86
|
\fBSYNOPSIS\fR
|
87
87
|
.
|
88
88
|
.IP
|
89
|
-
puppet certificate_request save [\-\-terminus
|
89
|
+
puppet certificate_request save [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIx509_CSR\fR
|
90
90
|
.
|
91
91
|
.IP
|
92
92
|
\fBDESCRIPTION\fR
|
@@ -99,7 +99,7 @@ API only: create or overwrite an object\. As the Faces framework does not curren
|
|
99
99
|
\fBSYNOPSIS\fR
|
100
100
|
.
|
101
101
|
.IP
|
102
|
-
puppet certificate_request search [\-\-terminus
|
102
|
+
puppet certificate_request search [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
|
103
103
|
.
|
104
104
|
.IP
|
105
105
|
\fBDESCRIPTION\fR
|
@@ -158,4 +158,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
|
|
158
158
|
.IP "" 0
|
159
159
|
.
|
160
160
|
.SH "COPYRIGHT AND LICENSE"
|
161
|
-
Copyright 2011 by Puppet
|
161
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|
@@ -1,13 +1,13 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-CERTIFICATE_REVOCATION_LIST" "8" "
|
4
|
+
.TH "PUPPET\-CERTIFICATE_REVOCATION_LIST" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-certificate_revocation_list\fR \- Manage the list of revoked certificates\.
|
8
8
|
.
|
9
9
|
.SH "SYNOPSIS"
|
10
|
-
puppet certificate_revocation_list \fIaction\fR [\-\-terminus
|
10
|
+
puppet certificate_revocation_list \fIaction\fR [\-\-terminus _TERMINUS] [\-\-extra HASH]
|
11
11
|
.
|
12
12
|
.SH "DESCRIPTION"
|
13
13
|
This subcommand is primarily for retrieving the certificate revocation list from the CA\.
|
@@ -16,7 +16,7 @@ This subcommand is primarily for retrieving the certificate revocation list from
|
|
16
16
|
Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
17
17
|
.
|
18
18
|
.P
|
19
|
-
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/
|
19
|
+
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
20
20
|
.
|
21
21
|
.TP
|
22
22
|
\-\-render\-as FORMAT
|
@@ -35,7 +35,7 @@ Whether to log debug information\.
|
|
35
35
|
A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
|
36
36
|
.
|
37
37
|
.TP
|
38
|
-
\-\-terminus
|
38
|
+
\-\-terminus _TERMINUS
|
39
39
|
Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
|
40
40
|
.
|
41
41
|
.IP
|
@@ -51,7 +51,7 @@ The terminus for an action is often determined by context, but occasionally need
|
|
51
51
|
\fBSYNOPSIS\fR
|
52
52
|
.
|
53
53
|
.IP
|
54
|
-
puppet certificate_revocation_list destroy [\-\-terminus
|
54
|
+
puppet certificate_revocation_list destroy [\-\-terminus _TERMINUS] [\-\-extra HASH] \fIdummy_text\fR
|
55
55
|
.
|
56
56
|
.IP
|
57
57
|
\fBDESCRIPTION\fR
|
@@ -76,7 +76,7 @@ Although this action always deletes the CRL from the specified terminus, it requ
|
|
76
76
|
\fBSYNOPSIS\fR
|
77
77
|
.
|
78
78
|
.IP
|
79
|
-
puppet certificate_revocation_list find [\-\-terminus
|
79
|
+
puppet certificate_revocation_list find [\-\-terminus _TERMINUS] [\-\-extra HASH] [\fIkey\fR]
|
80
80
|
.
|
81
81
|
.IP
|
82
82
|
\fBDESCRIPTION\fR
|
@@ -101,7 +101,7 @@ Although this action always returns the CRL from the specified terminus\.
|
|
101
101
|
\fBSYNOPSIS\fR
|
102
102
|
.
|
103
103
|
.IP
|
104
|
-
puppet certificate_revocation_list info [\-\-terminus
|
104
|
+
puppet certificate_revocation_list info [\-\-terminus _TERMINUS] [\-\-extra HASH]
|
105
105
|
.
|
106
106
|
.IP
|
107
107
|
\fBDESCRIPTION\fR
|
@@ -136,4 +136,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
|
|
136
136
|
.IP "" 0
|
137
137
|
.
|
138
138
|
.SH "COPYRIGHT AND LICENSE"
|
139
|
-
Copyright 2011 by Puppet
|
139
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|
data/man/man8/puppet-config.8
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-CONFIG" "8" "
|
4
|
+
.TH "PUPPET\-CONFIG" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-config\fR \- Interact with Puppet\'s settings\.
|
@@ -10,13 +10,13 @@
|
|
10
10
|
puppet config \fIaction\fR [\-\-section SECTION_NAME]
|
11
11
|
.
|
12
12
|
.SH "DESCRIPTION"
|
13
|
-
This subcommand can inspect and modify settings from Puppet\'s \'puppet\.conf\' configuration file\. For documentation about individual settings, see https://docs\.puppetlabs\.com/
|
13
|
+
This subcommand can inspect and modify settings from Puppet\'s \'puppet\.conf\' configuration file\. For documentation about individual settings, see https://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html\.
|
14
14
|
.
|
15
15
|
.SH "OPTIONS"
|
16
16
|
Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
17
17
|
.
|
18
18
|
.P
|
19
|
-
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/
|
19
|
+
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
20
20
|
.
|
21
21
|
.TP
|
22
22
|
\-\-render\-as FORMAT
|
@@ -114,4 +114,4 @@ Set the vardir for only the agent:
|
|
114
114
|
$ puppet config set vardir /opt/puppetlabs/puppet/cache \-\-section agent
|
115
115
|
.
|
116
116
|
.SH "COPYRIGHT AND LICENSE"
|
117
|
-
Copyright 2011 by Puppet
|
117
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|
data/man/man8/puppet-describe.8
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-DESCRIBE" "8" "
|
4
|
+
.TH "PUPPET\-DESCRIBE" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-describe\fR \- Display help about resource types
|
@@ -48,4 +48,4 @@ $ puppet describe user \-s \-m
|
|
48
48
|
David Lutterkort
|
49
49
|
.
|
50
50
|
.SH "COPYRIGHT"
|
51
|
-
Copyright (c) 2011 Puppet
|
51
|
+
Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
|
data/man/man8/puppet-device.8
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-DEVICE" "8" "
|
4
|
+
.TH "PUPPET\-DEVICE" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-device\fR \- Manage remote network devices
|
@@ -13,7 +13,7 @@ Retrieves all configurations from the puppet master and apply them to the remote
|
|
13
13
|
Currently must be run out periodically, using cron or something similar\.
|
14
14
|
.
|
15
15
|
.SH "USAGE"
|
16
|
-
puppet device [\-d|\-\-debug] [\-\-detailed\-exitcodes] [
|
16
|
+
puppet device [\-d|\-\-debug] [\-\-detailed\-exitcodes] [\-\-deviceconfig \fIfile\fR] [\-h|\-\-help] [\-l|\-\-logdest syslog|\fIfile\fR|console] [\-v|\-\-verbose] [\-w|\-\-waitforcert \fIseconds\fR] [\-t|\-\-target \fIdevice\fR] [\-V|\-\-version]
|
17
17
|
.
|
18
18
|
.SH "DESCRIPTION"
|
19
19
|
Once the client has a signed certificate for a given remote device, it will retrieve its configuration and apply it\.
|
@@ -42,7 +42,11 @@ Enable full debugging\.
|
|
42
42
|
.
|
43
43
|
.TP
|
44
44
|
\-\-detailed\-exitcodes
|
45
|
-
Provide transaction information via exit codes\. If this is enabled, an exit code of \'1\' means at least one device had a compile failure, an exit code of \'2\' means at least one device had resource changes, and an exit code of \'4\' means at least one device had resource failures\. Exit codes of \'3\', \'5\', \'6\', or \'7\' means that a bitwise combination of the
|
45
|
+
Provide transaction information via exit codes\. If this is enabled, an exit code of \'1\' means at least one device had a compile failure, an exit code of \'2\' means at least one device had resource changes, and an exit code of \'4\' means at least one device had resource failures\. Exit codes of \'3\', \'5\', \'6\', or \'7\' means that a bitwise combination of the preceding exit codes happened\.
|
46
|
+
.
|
47
|
+
.TP
|
48
|
+
\-\-deviceconfig
|
49
|
+
Path to the device config file for puppet device\. Default: $confdir/device\.conf
|
46
50
|
.
|
47
51
|
.TP
|
48
52
|
\-\-help
|
@@ -56,6 +60,10 @@ Where to send log messages\. Choose between \'syslog\' (the POSIX syslog service
|
|
56
60
|
A path ending with \'\.json\' will receive structured output in JSON format\. The log file will not have an ending \']\' automatically written to it due to the appending nature of logging\. It must be appended manually to make the content valid JSON\.
|
57
61
|
.
|
58
62
|
.TP
|
63
|
+
\-\-target
|
64
|
+
Target a specific device/certificate in the device\.conf\. Doing so will perform a device run against only that device/certificate\.
|
65
|
+
.
|
66
|
+
.TP
|
59
67
|
\-\-verbose
|
60
68
|
Turn on verbose reporting\.
|
61
69
|
.
|
@@ -75,4 +83,4 @@ This option only matters for daemons that do not yet have certificates and it is
|
|
75
83
|
Brice Figureau
|
76
84
|
.
|
77
85
|
.SH "COPYRIGHT"
|
78
|
-
Copyright (c) 2011 Puppet
|
86
|
+
Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
|
data/man/man8/puppet-doc.8
CHANGED
@@ -1,19 +1,19 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-DOC" "8" "
|
4
|
+
.TH "PUPPET\-DOC" "8" "June 2017" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-doc\fR \- Generate Puppet references
|
8
8
|
.
|
9
9
|
.SH "SYNOPSIS"
|
10
|
-
Generates a reference for all Puppet types\. Largely meant for internal Puppet
|
10
|
+
Generates a reference for all Puppet types\. Largely meant for internal Puppet Inc\. use\. (Deprecated)
|
11
11
|
.
|
12
12
|
.SH "USAGE"
|
13
13
|
puppet doc [\-h|\-\-help] [\-l|\-\-list] [\-r|\-\-reference \fIreference\-name\fR]
|
14
14
|
.
|
15
15
|
.SH "DESCRIPTION"
|
16
|
-
This deprecated command generates a Markdown document to stdout describing all installed Puppet types or all allowable arguments to puppet executables\. It is largely meant for internal use and is used to generate the reference document available on the Puppet
|
16
|
+
This deprecated command generates a Markdown document to stdout describing all installed Puppet types or all allowable arguments to puppet executables\. It is largely meant for internal use and is used to generate the reference document available on the Puppet Inc\. web site\.
|
17
17
|
.
|
18
18
|
.P
|
19
19
|
For Puppet module documentation (and all other use cases) this command has been superseded by the "puppet\-strings" module \- see https://github\.com/puppetlabs/puppetlabs\-strings for more information\.
|
@@ -43,4 +43,4 @@ $ puppet doc \-r type > /tmp/type_reference\.markdown
|
|
43
43
|
Luke Kanies
|
44
44
|
.
|
45
45
|
.SH "COPYRIGHT"
|
46
|
-
Copyright (c) 2011 Puppet
|
46
|
+
Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
|