puppet 4.10.9-universal-darwin → 4.10.10-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 +4 -4
- data/lib/puppet/agent.rb +22 -2
- data/lib/puppet/application.rb +18 -1
- data/lib/puppet/application/agent.rb +9 -2
- data/lib/puppet/application/apply.rb +1 -1
- data/lib/puppet/application/config.rb +1 -0
- data/lib/puppet/application/device.rb +1 -2
- data/lib/puppet/application/filebucket.rb +22 -5
- data/lib/puppet/application/help.rb +1 -0
- data/lib/puppet/application/inspect.rb +2 -0
- data/lib/puppet/application/lookup.rb +1 -3
- data/lib/puppet/application_support.rb +6 -1
- data/lib/puppet/defaults.rb +33 -4
- data/lib/puppet/face/config.rb +13 -0
- data/lib/puppet/functions/each.rb +10 -4
- data/lib/puppet/functions/lookup.rb +2 -2
- data/lib/puppet/functions/map.rb +12 -2
- data/lib/puppet/functions/reduce.rb +45 -2
- data/lib/puppet/interface.rb +1 -0
- data/lib/puppet/module_tool/tar/mini.rb +57 -4
- data/lib/puppet/network/http/factory.rb +9 -0
- data/lib/puppet/network/http/webrick.rb +1 -3
- data/lib/puppet/node.rb +10 -0
- data/lib/puppet/node/facts.rb +9 -0
- data/lib/puppet/parser/functions/sprintf.rb +17 -3
- data/lib/puppet/pops/loader/static_loader.rb +2 -2
- data/lib/puppet/pops/lookup/hiera_config.rb +2 -2
- data/lib/puppet/pops/merge_strategy.rb +16 -1
- data/lib/puppet/pops/types/iterable.rb +2 -0
- data/lib/puppet/pops/types/type_factory.rb +1 -1
- data/lib/puppet/pops/types/type_mismatch_describer.rb +15 -5
- data/lib/puppet/pops/types/types.rb +4 -2
- data/lib/puppet/provider/service/smf.rb +2 -2
- data/lib/puppet/provider/service/systemd.rb +1 -0
- data/lib/puppet/provider/service/upstart.rb +1 -1
- data/lib/puppet/settings/environment_conf.rb +10 -2
- data/lib/puppet/transaction.rb +3 -0
- data/lib/puppet/transaction/report.rb +8 -1
- data/lib/puppet/type.rb +1 -9
- data/lib/puppet/type/user.rb +9 -3
- data/lib/puppet/util/http_proxy.rb +14 -6
- data/lib/puppet/version.rb +1 -1
- data/locales/puppet.pot +29 -13
- data/man/man5/puppet.conf.5 +276 -55
- data/man/man8/extlookup2hiera.8 +2 -2
- data/man/man8/puppet-agent.8 +32 -10
- data/man/man8/puppet-apply.8 +21 -6
- data/man/man8/puppet-ca.8 +48 -34
- data/man/man8/puppet-catalog.8 +4 -4
- data/man/man8/puppet-cert.8 +23 -6
- data/man/man8/puppet-certificate.8 +44 -28
- data/man/man8/puppet-certificate_request.8 +4 -4
- data/man/man8/puppet-certificate_revocation_list.8 +4 -4
- data/man/man8/puppet-config.8 +5 -5
- data/man/man8/puppet-describe.8 +3 -3
- data/man/man8/puppet-device.8 +23 -13
- data/man/man8/puppet-doc.8 +5 -5
- data/man/man8/puppet-epp.8 +16 -10
- data/man/man8/puppet-facts.8 +4 -4
- data/man/man8/puppet-file.8 +4 -4
- data/man/man8/puppet-filebucket.8 +63 -6
- data/man/man8/puppet-generate.8 +84 -0
- data/man/man8/puppet-help.8 +4 -4
- data/man/man8/puppet-inspect.8 +8 -5
- data/man/man8/puppet-key.8 +4 -4
- data/man/man8/puppet-lookup.8 +87 -0
- data/man/man8/puppet-man.8 +5 -5
- data/man/man8/puppet-master.8 +5 -5
- data/man/man8/puppet-module.8 +22 -13
- data/man/man8/puppet-node.8 +4 -4
- data/man/man8/puppet-parser.8 +4 -4
- data/man/man8/puppet-plugin.8 +4 -4
- data/man/man8/puppet-report.8 +4 -4
- data/man/man8/puppet-resource.8 +4 -8
- data/man/man8/puppet-resource_type.8 +4 -4
- data/man/man8/puppet-status.8 +5 -5
- data/man/man8/puppet.8 +12 -3
- data/spec/fixtures/unit/application/environments/production/data/common.yaml +2 -0
- data/spec/integration/agent/logging_spec.rb +2 -0
- data/spec/integration/provider/cron/crontab_spec.rb +1 -0
- data/spec/unit/agent_spec.rb +33 -0
- data/spec/unit/application/config_spec.rb +4 -0
- data/spec/unit/application/inspect_spec.rb +11 -0
- data/spec/unit/application/lookup_spec.rb +30 -0
- data/spec/unit/application_spec.rb +18 -0
- data/spec/unit/environments_spec.rb +15 -0
- data/spec/unit/face/config_spec.rb +1 -2
- data/spec/unit/functions/break_spec.rb +108 -49
- data/spec/unit/functions/defined_spec.rb +2 -2
- data/spec/unit/functions/lookup_spec.rb +88 -3
- data/spec/unit/interface_spec.rb +12 -0
- data/spec/unit/module_tool/tar/mini_spec.rb +34 -5
- data/spec/unit/network/http/factory_spec.rb +22 -0
- data/spec/unit/network/http/webrick_spec.rb +30 -29
- data/spec/unit/parser/functions/sprintf_spec.rb +26 -0
- data/spec/unit/pops/loaders/static_loader_spec.rb +1 -1
- data/spec/unit/pops/types/type_calculator_spec.rb +21 -0
- data/spec/unit/pops/types/type_mismatch_describer_spec.rb +9 -0
- data/spec/unit/provider/service/smf_spec.rb +2 -4
- data/spec/unit/provider/service/systemd_spec.rb +14 -0
- data/spec/unit/resource/catalog_spec.rb +10 -0
- data/spec/unit/transaction/report_spec.rb +19 -0
- data/spec/unit/util/http_proxy_spec.rb +37 -0
- metadata +4 -2
@@ -0,0 +1,84 @@
|
|
1
|
+
.\" generated with Ronn/v0.7.3
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
|
+
.
|
4
|
+
.TH "PUPPET\-GENERATE" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
|
+
.
|
6
|
+
.SH "NAME"
|
7
|
+
\fBpuppet\-generate\fR \- Generates Puppet code from Ruby definitions\.
|
8
|
+
.
|
9
|
+
.SH "SYNOPSIS"
|
10
|
+
puppet generate \fIaction\fR
|
11
|
+
.
|
12
|
+
.SH "OPTIONS"
|
13
|
+
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\.
|
14
|
+
.
|
15
|
+
.P
|
16
|
+
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\.
|
17
|
+
.
|
18
|
+
.TP
|
19
|
+
\-\-render\-as FORMAT
|
20
|
+
The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
|
21
|
+
.
|
22
|
+
.TP
|
23
|
+
\-\-verbose
|
24
|
+
Whether to log verbosely\.
|
25
|
+
.
|
26
|
+
.TP
|
27
|
+
\-\-debug
|
28
|
+
Whether to log debug information\.
|
29
|
+
.
|
30
|
+
.SH "ACTIONS"
|
31
|
+
.
|
32
|
+
.TP
|
33
|
+
\fBtypes\fR \- Generates Puppet code for custom types
|
34
|
+
\fBSYNOPSIS\fR
|
35
|
+
.
|
36
|
+
.IP
|
37
|
+
puppet generate types [\-\-format \fIformat\fR] [\-\-force]
|
38
|
+
.
|
39
|
+
.IP
|
40
|
+
\fBDESCRIPTION\fR
|
41
|
+
.
|
42
|
+
.IP
|
43
|
+
Generates definitions for custom resource types using Puppet code\.
|
44
|
+
.
|
45
|
+
.IP
|
46
|
+
Types defined in Puppet code can be used to isolate custom type definitions between different environments\.
|
47
|
+
.
|
48
|
+
.IP
|
49
|
+
\fBOPTIONS\fR \fI\-\-force\fR \- Forces the generation of output files (skips up\-to\-date checks)\.
|
50
|
+
.
|
51
|
+
.IP
|
52
|
+
\fI\-\-format <format\fR> \- The generation output format to use\. Supported formats: pcore\.
|
53
|
+
.
|
54
|
+
.SH "EXAMPLES"
|
55
|
+
\fBtypes\fR
|
56
|
+
.
|
57
|
+
.P
|
58
|
+
Generate Puppet type definitions for all custom resource types in the current environment:
|
59
|
+
.
|
60
|
+
.IP "" 4
|
61
|
+
.
|
62
|
+
.nf
|
63
|
+
|
64
|
+
$ puppet generate types
|
65
|
+
.
|
66
|
+
.fi
|
67
|
+
.
|
68
|
+
.IP "" 0
|
69
|
+
.
|
70
|
+
.P
|
71
|
+
Generate Puppet type definitions for all custom resource types in the specified environment:
|
72
|
+
.
|
73
|
+
.IP "" 4
|
74
|
+
.
|
75
|
+
.nf
|
76
|
+
|
77
|
+
$ puppet generate types \-\-environment development
|
78
|
+
.
|
79
|
+
.fi
|
80
|
+
.
|
81
|
+
.IP "" 0
|
82
|
+
.
|
83
|
+
.SH "COPYRIGHT AND LICENSE"
|
84
|
+
Copyright 2016 by Puppet Inc\. Apache 2 license; see COPYING
|
data/man/man8/puppet-help.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\-HELP" "8" "
|
4
|
+
.TH "PUPPET\-HELP" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-help\fR \- Display Puppet help\.
|
@@ -13,7 +13,7 @@ puppet help \fIaction\fR
|
|
13
13
|
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\.
|
14
14
|
.
|
15
15
|
.P
|
16
|
-
See the configuration file documentation at \fIhttps://docs\.puppetlabs\.com/
|
16
|
+
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\.
|
17
17
|
.
|
18
18
|
.TP
|
19
19
|
\-\-render\-as FORMAT
|
@@ -61,4 +61,4 @@ Get help for an action:
|
|
61
61
|
$ puppet help
|
62
62
|
.
|
63
63
|
.SH "COPYRIGHT AND LICENSE"
|
64
|
-
Copyright 2011 by Puppet
|
64
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|
data/man/man8/puppet-inspect.8
CHANGED
@@ -1,12 +1,15 @@
|
|
1
1
|
.\" generated with Ronn/v0.7.3
|
2
|
-
.\"
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
3
|
.
|
4
|
-
.TH "PUPPET\-INSPECT" "8" "
|
4
|
+
.TH "PUPPET\-INSPECT" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-inspect\fR \- Send an inspection report
|
8
8
|
.
|
9
9
|
.SH "SYNOPSIS"
|
10
|
+
Note: this command is deprecated
|
11
|
+
.
|
12
|
+
.P
|
10
13
|
Prepares and submits an inspection report to the puppet master\.
|
11
14
|
.
|
12
15
|
.SH "USAGE"
|
@@ -19,7 +22,7 @@ This command uses the cached catalog from the previous run of \'puppet agent\' t
|
|
19
22
|
Puppet inspect does not run as a daemon, and must be run manually or from cron\.
|
20
23
|
.
|
21
24
|
.SH "OPTIONS"
|
22
|
-
Any configuration setting which is valid in the configuration file is also a valid long argument, e\.g\. \'\-\-server=master\.domain\.com\'\. See the configuration file documentation at https://docs\.puppetlabs\.com/
|
25
|
+
Any configuration setting which is valid in the configuration file is also a valid long argument, e\.g\. \'\-\-server=master\.domain\.com\'\. See the configuration file documentation at https://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html for the full list of acceptable settings\.
|
23
26
|
.
|
24
27
|
.TP
|
25
28
|
\-\-archive_files
|
@@ -30,7 +33,7 @@ During an inspect run, whether to archive files whose contents are audited to a
|
|
30
33
|
During an inspect run, the file bucket server to archive files to if archive_files is set\. The default value is \'$server\'\.
|
31
34
|
.
|
32
35
|
.SH "AUTHOR"
|
33
|
-
Puppet
|
36
|
+
Puppet Inc\.
|
34
37
|
.
|
35
38
|
.SH "COPYRIGHT"
|
36
|
-
Copyright (c) 2011 Puppet
|
39
|
+
Copyright (c) 2011 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
|
data/man/man8/puppet-key.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\-KEY" "8" "
|
4
|
+
.TH "PUPPET\-KEY" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-key\fR \- Create, save, and remove certificate keys\.
|
@@ -16,7 +16,7 @@ This subcommand manages certificate private keys\. Keys are created automaticall
|
|
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
|
@@ -129,4 +129,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
|
|
129
129
|
.IP "" 0
|
130
130
|
.
|
131
131
|
.SH "COPYRIGHT AND LICENSE"
|
132
|
-
Copyright 2011 by Puppet
|
132
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|
@@ -0,0 +1,87 @@
|
|
1
|
+
.\" generated with Ronn/v0.7.3
|
2
|
+
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
|
+
.
|
4
|
+
.TH "PUPPET\-LOOKUP" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
|
+
.
|
6
|
+
.SH "NAME"
|
7
|
+
\fBpuppet\-lookup\fR \- Data in modules lookup function
|
8
|
+
.
|
9
|
+
.SH "SYNOPSIS"
|
10
|
+
The lookup command is used for debugging and testing a given data configuration\. For a given data key, lookup will produce either a value or an explanation of how that value was obtained on the standard output stream with the specified rendering format\. Lookup is designed to be run on a puppet master or a node in a masterless setup\.
|
11
|
+
.
|
12
|
+
.SH "USAGE"
|
13
|
+
puppet lookup [\-\-help] [\-\-type \fITYPESTRING\fR] [\-\-merge unique|hash|deep] [\-\-knock\-out\-prefix \fIPREFIX\-STRING\fR] [\-\-sort\-merged\-arrays] [\-\-merge\-hash\-arrays] [\-\-explain] [\-\-default \fIVALUE\fR] [\-\-node \fINODE\-NAME\fR] [\-\-facts \fIFILE\fR] [\-\-compile] [\-\-render\-as s|json|yaml|binary|msgpack] \fIkeys\fR
|
14
|
+
.
|
15
|
+
.SH "DESCRIPTION"
|
16
|
+
The lookup command is a CLI interface for the puppet lookup function\. When given one or more keys, the lookup command will return the first value found when run from the puppet master or a masterless node\.
|
17
|
+
.
|
18
|
+
.P
|
19
|
+
When an explanation has not been requested and lookup is simply looking up a value, the application will exit with 0 if a value was found and 1 otherwise\. When an explanation is requested, lookup will always exit with 0 unless there is a major error\.
|
20
|
+
.
|
21
|
+
.P
|
22
|
+
The other options are as passed into the lookup function, and the effect they have on the lookup is described in more detail in the header for the lookup function:
|
23
|
+
.
|
24
|
+
.P
|
25
|
+
http://links\.puppetlabs\.com/lookup\-docs
|
26
|
+
.
|
27
|
+
.SH "OPTIONS"
|
28
|
+
These options and their effects are described in more detail in the puppet lookup function linked to above\.
|
29
|
+
.
|
30
|
+
.IP "\(bu" 4
|
31
|
+
\-\-help: Print this help message\.
|
32
|
+
.
|
33
|
+
.IP "\(bu" 4
|
34
|
+
\-\-type \fITYPESTRING\fR: Assert that the value has the specified type\.
|
35
|
+
.
|
36
|
+
.IP "\(bu" 4
|
37
|
+
\-\-merge unique|hash|deep: Specify the merge strategy\. \'hash\' performs a simple hash\-merge by overwriting keys of lower lookup priority\. \'unique\' appends everything to an array containing no nested arrays and where all duplicates have been removed\. \'deep\' Performs a deep merge on values of Array and Hash type\. There are additional option flags that can be used with \'deep\'\.
|
38
|
+
.
|
39
|
+
.IP "\(bu" 4
|
40
|
+
\-\-knock\-out\-prefix \fIPREFIX\-STRING\fR Can be used with the \'deep\' merge strategy\. Specify string value to signify prefix which deletes elements from existing element\.
|
41
|
+
.
|
42
|
+
.IP "\(bu" 4
|
43
|
+
\-\-sort\-merged\-arrays Can be used with the \'deep\' merge strategy\. When this flag is used all merged arrays will be sorted\.
|
44
|
+
.
|
45
|
+
.IP "\(bu" 4
|
46
|
+
\-\-merge\-hash\-arrays Can be used with the \'deep\' merge strategy\. When this flag is used arrays and hashes will be merged\.
|
47
|
+
.
|
48
|
+
.IP "\(bu" 4
|
49
|
+
\-\-explain Print an explanation for the details of how the lookup performed rather than the value returned for the key\. The explanation will describe how the result was obtained or why lookup failed to obtain the result\.
|
50
|
+
.
|
51
|
+
.IP "\(bu" 4
|
52
|
+
\-\-explain\-options Explain if a lookup_options hash will be used and how it was assembled when performing a lookup\.
|
53
|
+
.
|
54
|
+
.IP "\(bu" 4
|
55
|
+
\-\-default \fIVALUE\fR A value produced if no value was found in the lookup\.
|
56
|
+
.
|
57
|
+
.IP "\(bu" 4
|
58
|
+
\-\-node \fINODE\-NAME\fR Specify node which defines the scope in which the lookup will be performed\. If a node is not given, lookup will default to the machine from which the lookup is being run (which should be the master)\.
|
59
|
+
.
|
60
|
+
.IP "\(bu" 4
|
61
|
+
\-\-facts \fIFILE\fR Specify a \.json, or \.yaml file holding key => value mappings that will override the facts for the current node\. Any facts not specified by the user will maintain their original value\.
|
62
|
+
.
|
63
|
+
.IP "\(bu" 4
|
64
|
+
\-\-compile Perform a full catalog compilation prior to the lookup\. This is meaningful when the catalog changes global variables that are referenced in interpolated values\. No catalog compilation takes place unless this flag is given\.
|
65
|
+
.
|
66
|
+
.IP "\(bu" 4
|
67
|
+
\-\-render\-as s|json|yaml|binary|msgpack Determines how the results will be rendered to the standard output where s means plain text\. The default when lookup is producing a value is yaml and the default when producing an explanation is s\.
|
68
|
+
.
|
69
|
+
.IP "" 0
|
70
|
+
.
|
71
|
+
.SH "EXAMPLE"
|
72
|
+
If you wanted to lookup \'key_name\' within the scope of the master, you would call lookup like this: $ puppet lookup key_name
|
73
|
+
.
|
74
|
+
.P
|
75
|
+
If you wanted to lookup \'key_name\' within the scope of the agent\.local node, you would call lookup like this: $ puppet lookup \-\-node agent\.local key_name
|
76
|
+
.
|
77
|
+
.P
|
78
|
+
If you wanted to get the first value found for \'key_name_one\' and \'key_name_two\' within the scope of the agent\.local node while merging values and knocking out the prefix \'foo\' while merging, you would call lookup like this: $ puppet lookup \-\-node agent\.local \-\-merge deep \-\-knock\-out\-prefix foo key_name_one key_name_two
|
79
|
+
.
|
80
|
+
.P
|
81
|
+
If you wanted to lookup \'key_name\' within the scope of the agent\.local node, and return a default value of \'bar\' if nothing was found, you would call lookup like this: $ puppet lookup \-\-node agent\.local \-\-default bar key_name
|
82
|
+
.
|
83
|
+
.P
|
84
|
+
If you wanted to see an explanation of how the value for \'key_name\' would be obtained in the context of the agent\.local node, you would call lookup like this: $ puppet lookup \-\-node agent\.local \-\-explain key_name
|
85
|
+
.
|
86
|
+
.SH "COPYRIGHT"
|
87
|
+
Copyright (c) 2015 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
|
data/man/man8/puppet-man.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\-MAN" "8" "
|
4
|
+
.TH "PUPPET\-MAN" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-man\fR \- Display Puppet manual pages\.
|
@@ -10,13 +10,13 @@
|
|
10
10
|
puppet man \fIaction\fR
|
11
11
|
.
|
12
12
|
.SH "DESCRIPTION"
|
13
|
-
This subcommand displays manual pages for all Puppet subcommands\. If the \fBronn\fR gem (\fIhttps://github\.com/rtomayko/ronn/\fR) is installed on your system, puppet man will display fully\-
|
13
|
+
This subcommand displays manual pages for all Puppet subcommands\. If the \fBronn\fR gem (\fIhttps://github\.com/rtomayko/ronn/\fR) is installed on your system, puppet man will display fully\-formatted man pages\. If \fBronn\fR is not available, puppet man will display the raw (but human\-readable) source text in a pager\.
|
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
|
@@ -67,4 +67,4 @@ $ puppet man facts
|
|
67
67
|
The pager used for display will be the first found of \fB$MANPAGER\fR, \fB$PAGER\fR, \fBless\fR, \fBmost\fR, or \fBmore\fR\.
|
68
68
|
.
|
69
69
|
.SH "COPYRIGHT AND LICENSE"
|
70
|
-
Copyright 2011 by Puppet
|
70
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|
data/man/man8/puppet-master.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\-MASTER" "8" "
|
4
|
+
.TH "PUPPET\-MASTER" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-master\fR \- The puppet master daemon
|
@@ -19,7 +19,7 @@ This command starts an instance of puppet master, running as a daemon and using
|
|
19
19
|
Note that any Puppet setting that\'s valid in the configuration file is also a valid long argument\. For example, \'server\' is a valid setting, so you can specify \'\-\-server \fIservername\fR\' as an argument\. Boolean settings translate into \'\-\-setting\' and \'\-\-no\-setting\' pairs\.
|
20
20
|
.
|
21
21
|
.P
|
22
|
-
See the configuration file documentation at https://docs\.puppetlabs\.com/
|
22
|
+
See the configuration file documentation at https://docs\.puppetlabs\.com/puppet/latest/reference/configuration\.html for the full list of acceptable settings\. A commented list of all settings can also be generated by running puppet master with \'\-\-genconfig\'\.
|
23
23
|
.
|
24
24
|
.TP
|
25
25
|
\-\-daemonize
|
@@ -46,7 +46,7 @@ A path ending with \'\.json\' will receive structured output in JSON format\. Th
|
|
46
46
|
.
|
47
47
|
.TP
|
48
48
|
\-\-masterport
|
49
|
-
The port on which to listen for traffic\. (This is a Puppet setting, and can go in puppet\.conf\.)
|
49
|
+
The port on which to listen for traffic\. The default port is 8140\. (This is a Puppet setting, and can go in puppet\.conf\.)
|
50
50
|
.
|
51
51
|
.TP
|
52
52
|
\-\-verbose
|
@@ -82,4 +82,4 @@ Close file descriptors for log files and reopen them\. Used with logrotate\.
|
|
82
82
|
Luke Kanies
|
83
83
|
.
|
84
84
|
.SH "COPYRIGHT"
|
85
|
-
Copyright (c) 2012 Puppet
|
85
|
+
Copyright (c) 2012 Puppet Inc\., LLC Licensed under the Apache 2\.0 License
|
data/man/man8/puppet-module.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\-MODULE" "8" "
|
4
|
+
.TH "PUPPET\-MODULE" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.
|
@@ -16,7 +16,7 @@ This subcommand can find, install, and manage modules from the Puppet Forge, a r
|
|
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
|
@@ -32,14 +32,23 @@ Whether to log debug information\.
|
|
32
32
|
.
|
33
33
|
.TP
|
34
34
|
\-\-environment production
|
35
|
-
The environment Puppet is running
|
35
|
+
The environment in which Puppet is running\. For clients, such as \fBpuppet agent\fR, this determines the environment itself, which Puppet uses to find modules and much more\. For servers, such as \fBpuppet master\fR, this provides the default environment for nodes that Puppet knows nothing about\.
|
36
|
+
.
|
37
|
+
.IP
|
38
|
+
When defining an environment in the \fB[agent]\fR section, this refers to the environment that the agent requests from the master\. The environment doesn\'t have to exist on the local filesystem because the agent fetches it from the master\. This definition is used when running \fBpuppet agent\fR\.
|
39
|
+
.
|
40
|
+
.IP
|
41
|
+
When defined in the \fB[user]\fR section, the environment refers to the path that Puppet uses to search for code and modules related to its execution\. This requires the environment to exist locally on the filesystem where puppet is being executed\. Puppet subcommands, including \fBpuppet module\fR and \fBpuppet apply\fR, use this definition\.
|
42
|
+
.
|
43
|
+
.IP
|
44
|
+
Given that the context and effects vary depending on the config section \fIhttps://puppet\.com/docs/puppet/latest/config_file_main\.html#config\-sections\fR in which the \fBenvironment\fR setting is defined, do not set it globally\.
|
36
45
|
.
|
37
46
|
.TP
|
38
47
|
\-\-modulepath
|
39
48
|
The search path for modules, as a list of directories separated by the system path separator character\. (The POSIX path separator is \':\', and the Windows path separator is \';\'\.)
|
40
49
|
.
|
41
50
|
.IP
|
42
|
-
Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT\'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see
|
51
|
+
Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT\'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see \fIhttps://docs\.puppet\.com/puppet/latest/reference/environments\.html\fR
|
43
52
|
.
|
44
53
|
.SH "ACTIONS"
|
45
54
|
.
|
@@ -79,7 +88,7 @@ puppet module changes \fIpath\fR
|
|
79
88
|
\fBDESCRIPTION\fR
|
80
89
|
.
|
81
90
|
.IP
|
82
|
-
Shows any files in a module that have been modified since it was installed\. This action compares the files on disk to the md5 checksums included in the module\'s metadata\.
|
91
|
+
Shows any files in a module that have been modified since it was installed\. This action compares the files on disk to the md5 checksums included in the module\'s checksums\.json or, if that is missing, in metadata\.json\.
|
83
92
|
.
|
84
93
|
.IP
|
85
94
|
\fBRETURNS\fR
|
@@ -322,37 +331,37 @@ Notice: Generating module at /Users/username/Projects/puppet/puppetlabs\-ssh\.\.
|
|
322
331
|
Install a module:
|
323
332
|
.
|
324
333
|
.P
|
325
|
-
$ puppet module install puppetlabs\-vcsrepo Preparing to install into /etc/puppetlabs/code/modules \.\.\. Downloading from https://forgeapi\.
|
334
|
+
$ puppet module install puppetlabs\-vcsrepo Preparing to install into /etc/puppetlabs/code/modules \.\.\. Downloading from https://forgeapi\.puppet\.com \.\.\. Installing \-\- do not interrupt \.\.\. /etc/puppetlabs/code/modules └── puppetlabs\-vcsrepo (v0\.0\.4)
|
326
335
|
.
|
327
336
|
.P
|
328
337
|
Install a module to a specific environment:
|
329
338
|
.
|
330
339
|
.P
|
331
|
-
$ puppet module install puppetlabs\-vcsrepo \-\-environment development Preparing to install into /etc/puppetlabs/code/environments/development/modules \.\.\. Downloading from https://forgeapi\.
|
340
|
+
$ puppet module install puppetlabs\-vcsrepo \-\-environment development Preparing to install into /etc/puppetlabs/code/environments/development/modules \.\.\. Downloading from https://forgeapi\.puppet\.com \.\.\. Installing \-\- do not interrupt \.\.\. /etc/puppetlabs/code/environments/development/modules └── puppetlabs\-vcsrepo (v0\.0\.4)
|
332
341
|
.
|
333
342
|
.P
|
334
343
|
Install a specific module version:
|
335
344
|
.
|
336
345
|
.P
|
337
|
-
$ puppet module install puppetlabs\-vcsrepo \-v 0\.0\.4 Preparing to install into /etc/puppetlabs/modules \.\.\. Downloading from https://forgeapi\.
|
346
|
+
$ puppet module install puppetlabs\-vcsrepo \-v 0\.0\.4 Preparing to install into /etc/puppetlabs/modules \.\.\. Downloading from https://forgeapi\.puppet\.com \.\.\. Installing \-\- do not interrupt \.\.\. /etc/puppetlabs/code/modules └── puppetlabs\-vcsrepo (v0\.0\.4)
|
338
347
|
.
|
339
348
|
.P
|
340
349
|
Install a module into a specific directory:
|
341
350
|
.
|
342
351
|
.P
|
343
|
-
$ puppet module install puppetlabs\-vcsrepo \-\-target\-dir=/opt/puppetlabs/puppet/modules Preparing to install into /opt/puppetlabs/puppet/modules \.\.\. Downloading from https://forgeapi\.
|
352
|
+
$ puppet module install puppetlabs\-vcsrepo \-\-target\-dir=/opt/puppetlabs/puppet/modules Preparing to install into /opt/puppetlabs/puppet/modules \.\.\. Downloading from https://forgeapi\.puppet\.com \.\.\. Installing \-\- do not interrupt \.\.\. /opt/puppetlabs/puppet/modules └── puppetlabs\-vcsrepo (v0\.0\.4)
|
344
353
|
.
|
345
354
|
.P
|
346
355
|
Install a module into a specific directory and check for dependencies in other directories:
|
347
356
|
.
|
348
357
|
.P
|
349
|
-
$ puppet module install puppetlabs\-vcsrepo \-\-target\-dir=/opt/puppetlabs/puppet/modules \-\-modulepath /etc/puppetlabs/code/modules Preparing to install into /opt/puppetlabs/puppet/modules \.\.\. Downloading from https://forgeapi\.
|
358
|
+
$ puppet module install puppetlabs\-vcsrepo \-\-target\-dir=/opt/puppetlabs/puppet/modules \-\-modulepath /etc/puppetlabs/code/modules Preparing to install into /opt/puppetlabs/puppet/modules \.\.\. Downloading from https://forgeapi\.puppet\.com \.\.\. Installing \-\- do not interrupt \.\.\. /opt/puppetlabs/puppet/modules └── puppetlabs\-vcsrepo (v0\.0\.4)
|
350
359
|
.
|
351
360
|
.P
|
352
361
|
Install a module from a release archive:
|
353
362
|
.
|
354
363
|
.P
|
355
|
-
$ puppet module install puppetlabs\-vcsrepo\-0\.0\.4\.tar\.gz Preparing to install into /etc/puppetlabs/code/modules \.\.\. Downloading from https://forgeapi\.
|
364
|
+
$ puppet module install puppetlabs\-vcsrepo\-0\.0\.4\.tar\.gz Preparing to install into /etc/puppetlabs/code/modules \.\.\. Downloading from https://forgeapi\.puppet\.com \.\.\. Installing \-\- do not interrupt \.\.\. /etc/puppetlabs/code/modules └── puppetlabs\-vcsrepo (v0\.0\.4)
|
356
365
|
.
|
357
366
|
.P
|
358
367
|
Install a module from a release archive and ignore dependencies:
|
@@ -445,4 +454,4 @@ upgrade an installed module for a specific environment
|
|
445
454
|
$ puppet module upgrade puppetlabs\-apache \-\-environment test /etc/puppetlabs/code/environments/test/modules └── puppetlabs\-apache (v1\.0\.0 \-> v2\.4\.0)
|
446
455
|
.
|
447
456
|
.SH "COPYRIGHT AND LICENSE"
|
448
|
-
Copyright 2012 by Puppet
|
457
|
+
Copyright 2012 by Puppet Inc\. Apache 2 license; see COPYING
|
data/man/man8/puppet-node.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\-NODE" "8" "
|
4
|
+
.TH "PUPPET\-NODE" "8" "January 2018" "Puppet Labs, LLC" "Puppet manual"
|
5
5
|
.
|
6
6
|
.SH "NAME"
|
7
7
|
\fBpuppet\-node\fR \- View and manage node definitions\.
|
@@ -16,7 +16,7 @@ This subcommand interacts with node objects, which are used by Puppet to build a
|
|
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
|
@@ -160,4 +160,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
|
|
160
160
|
.IP "" 0
|
161
161
|
.
|
162
162
|
.SH "COPYRIGHT AND LICENSE"
|
163
|
-
Copyright 2011 by Puppet
|
163
|
+
Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING
|