puppet 8.8.1 → 8.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (64) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +2 -0
  3. data/Gemfile.lock +37 -29
  4. data/ext/project_data.yaml +12 -0
  5. data/install.rb +3 -74
  6. data/lib/puppet/application/apply.rb +1 -0
  7. data/lib/puppet/application/filebucket.rb +6 -4
  8. data/lib/puppet/application/ssl.rb +4 -4
  9. data/lib/puppet/defaults.rb +62 -52
  10. data/lib/puppet/face/catalog.rb +24 -8
  11. data/lib/puppet/face/help.rb +43 -23
  12. data/lib/puppet/functions/capitalize.rb +1 -1
  13. data/lib/puppet/functions/find_file.rb +4 -0
  14. data/lib/puppet/functions/hiera.rb +1 -0
  15. data/lib/puppet/functions/index.rb +2 -2
  16. data/lib/puppet/functions/lookup.rb +1 -1
  17. data/lib/puppet/functions/new.rb +1 -1
  18. data/lib/puppet/functions/regsubst.rb +1 -1
  19. data/lib/puppet/functions/unique.rb +3 -2
  20. data/lib/puppet/functions/yaml_data.rb +1 -0
  21. data/lib/puppet/interface/action_manager.rb +1 -1
  22. data/lib/puppet/provider/package/pacman.rb +9 -10
  23. data/lib/puppet/reference/configuration.rb +6 -1
  24. data/lib/puppet/resource/type.rb +15 -1
  25. data/lib/puppet/settings.rb +2 -2
  26. data/lib/puppet/transaction/resource_harness.rb +7 -3
  27. data/lib/puppet/type/exec.rb +3 -4
  28. data/lib/puppet/type/file/checksum.rb +4 -2
  29. data/lib/puppet/type/file/ctime.rb +2 -2
  30. data/lib/puppet/type/file/mtime.rb +2 -2
  31. data/lib/puppet/type/file/selcontext.rb +6 -6
  32. data/lib/puppet/type/package.rb +4 -3
  33. data/lib/puppet/type/user.rb +1 -1
  34. data/lib/puppet/util/checksums.rb +1 -0
  35. data/lib/puppet/util/profiler/aggregate.rb +2 -2
  36. data/lib/puppet/util/profiler/wall_clock.rb +2 -2
  37. data/lib/puppet/util/reference.rb +0 -1
  38. data/lib/puppet/util/selinux.rb +26 -14
  39. data/lib/puppet/version.rb +1 -1
  40. data/locales/puppet.pot +71 -71
  41. data/man/man5/puppet.conf.5 +18 -18
  42. data/man/man8/puppet-agent.8 +1 -1
  43. data/man/man8/puppet-apply.8 +2 -1
  44. data/man/man8/puppet-catalog.8 +5 -2
  45. data/man/man8/puppet-config.8 +1 -1
  46. data/man/man8/puppet-describe.8 +1 -1
  47. data/man/man8/puppet-device.8 +1 -1
  48. data/man/man8/puppet-doc.8 +1 -1
  49. data/man/man8/puppet-epp.8 +1 -1
  50. data/man/man8/puppet-facts.8 +1 -1
  51. data/man/man8/puppet-filebucket.8 +10 -1
  52. data/man/man8/puppet-generate.8 +1 -1
  53. data/man/man8/puppet-help.8 +1 -1
  54. data/man/man8/puppet-lookup.8 +1 -1
  55. data/man/man8/puppet-module.8 +1 -1
  56. data/man/man8/puppet-node.8 +1 -1
  57. data/man/man8/puppet-parser.8 +1 -1
  58. data/man/man8/puppet-plugin.8 +1 -1
  59. data/man/man8/puppet-report.8 +1 -1
  60. data/man/man8/puppet-resource.8 +1 -1
  61. data/man/man8/puppet-script.8 +1 -1
  62. data/man/man8/puppet-ssl.8 +3 -3
  63. data/man/man8/puppet.8 +128 -9
  64. metadata +1 -1
@@ -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\-CATALOG" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-CATALOG" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-catalog\fR \- Compile, save, view, and convert catalogs\.
@@ -113,7 +113,7 @@ When used from the Ruby API, this action has a side effect of leaving Puppet::Re
113
113
  \fBSYNOPSIS\fR
114
114
  .
115
115
  .IP
116
- puppet catalog find [\-\-terminus _TERMINUS] \fIcertname\fR
116
+ puppet catalog find [\-\-terminus _TERMINUS] [\-\-facts_for_catalog] \fIcertname\fR, \fIfacts\fR
117
117
  .
118
118
  .IP
119
119
  \fBDESCRIPTION\fR
@@ -122,6 +122,9 @@ puppet catalog find [\-\-terminus _TERMINUS] \fIcertname\fR
122
122
  Retrieve the catalog for the node from which the command is run\.
123
123
  .
124
124
  .IP
125
+ \fBOPTIONS\fR \fI\-\-facts_for_catalog\fR \- Not implemented for the CLI; facts are collected internally\.
126
+ .
127
+ .IP
125
128
  \fBRETURNS\fR
126
129
  .
127
130
  .IP
@@ -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" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-CONFIG" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-config\fR \- Interact with Puppet\'s settings\.
@@ -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" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-DESCRIBE" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-describe\fR \- Display help about resource types
@@ -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" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-DEVICE" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-device\fR \- Manage remote network devices
@@ -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\-DOC" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-DOC" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-doc\fR \- Generate Puppet references
@@ -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\-EPP" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-EPP" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-epp\fR \- Interact directly with the EPP template parser/renderer\.
@@ -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\-FACTS" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-FACTS" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-facts\fR \- Retrieve and store facts\.
@@ -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\-FILEBUCKET" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-FILEBUCKET" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-filebucket\fR \- Store and retrieve files in a filebucket
@@ -36,6 +36,14 @@ This is a stand\-alone filebucket client for sending files to a local or central
36
36
  .P
37
37
  Note that \'filebucket\' defaults to using a network\-based filebucket available on the server named \'puppet\'\. To use this, you\'ll have to be running as a user with valid Puppet certificates\. Alternatively, you can use your local file bucket by specifying \'\-\-local\', or by specifying \'\-\-bucket\' with a local path\.
38
38
  .
39
+ .P
40
+ \fBImportant\fR: When you enable and use the backup option, and by extension the filebucket resource, you must ensure that sufficient disk space is available for the file backups\. Generally, you can provide the disk space by using one of the following two options:
41
+ .
42
+ .IP "\(bu" 4
43
+ Use a \fBfind\fR command and \fBcrontab\fR entry to retain only the last X days of file backups\. For example:
44
+ .
45
+ .IP "" 0
46
+ .
39
47
  .IP "" 4
40
48
  .
41
49
  .nf
@@ -146,6 +154,7 @@ $ puppet filebucket \-l \-f "2015\-05\-11 09:30:00" list
146
154
 
147
155
  $ puppet filebucket \-l \-t "2015\-05\-11 09:30:00" list
148
156
  d43a6ecaa892a1962398ac9170ea9bf2 2015\-05\-11 09:27:56 /tmp/TestFile
157
+
149
158
  ## Manage files in a specific local filebucket
150
159
  $ puppet filebucket \-b /tmp/TestBucket backup /tmp/TestFile2
151
160
  /tmp/TestFile2: d41d8cd98f00b204e9800998ecf8427e
@@ -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\-GENERATE" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-GENERATE" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-generate\fR \- Generates Puppet code from Ruby definitions\.
@@ -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" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-HELP" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-help\fR \- Display Puppet help\.
@@ -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\-LOOKUP" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-LOOKUP" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-lookup\fR \- Interactive Hiera lookup
@@ -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" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-MODULE" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.
@@ -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" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-NODE" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-node\fR \- View and manage node definitions\.
@@ -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\-PARSER" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-PARSER" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-parser\fR \- Interact directly with the parser\.
@@ -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\-PLUGIN" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-PLUGIN" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-plugin\fR \- Interact with the Puppet plugin system\.
@@ -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\-REPORT" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-REPORT" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-report\fR \- Create, display, and submit reports\.
@@ -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\-RESOURCE" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-RESOURCE" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-resource\fR \- The resource abstraction layer shell
@@ -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\-SCRIPT" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-SCRIPT" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-script\fR \- Run a puppet manifests as a script without compiling a catalog
@@ -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\-SSL" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET\-SSL" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBpuppet\-ssl\fR \- Manage SSL keys and certificates for puppet SSL clients
@@ -39,11 +39,11 @@ Perform all of the steps necessary to request and download a client certificate\
39
39
  .
40
40
  .TP
41
41
  submit_request
42
- Generate a certificate signing request (CSR) and submit it to the CA\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\. If a CSR has already been submitted with the given \fBcertname\fR, then the operation will fail\.
42
+ Generate a certificate signing request (CSR) and submit it to the CA\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise, a new key pair will be generated\. If a CSR has already been submitted with the given \fBcertname\fR, then the operation will fail\.
43
43
  .
44
44
  .TP
45
45
  generate_request
46
- Generate a certificate signing request (CSR)\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\.
46
+ Generate a certificate signing request (CSR)\. If a private and public key pair exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\.
47
47
  .
48
48
  .TP
49
49
  download_cert
data/man/man8/puppet.8 CHANGED
@@ -1,28 +1,147 @@
1
1
  .\" generated with Ronn/v0.7.3
2
2
  .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "PUPPET" "8" "July 2024" "Puppet, Inc." "Puppet manual"
4
+ .TH "PUPPET" "8" "September 2024" "Puppet, Inc." "Puppet manual"
5
5
  .
6
6
  .SH "NAME"
7
- \fBpuppet\fR
7
+ \fBpuppet\fR \- an automated configuration management tool
8
+ .
9
+ .SH "SYNOPSIS"
10
+ \fBpuppet\fR \fIsubcommand\fR [options] \fIaction\fR [options]
11
+ .
12
+ .SH "DESCRIPTION"
13
+ Puppet, an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks (such as adding users, installing packages, and updating server configurations) based on a centralized specification\.
14
+ .
15
+ .SH "COMMANDS"
16
+ .
17
+ .SS "Common"
18
+ \fBapply\fR
19
+ .
20
+ .br
21
+ \~\~\~\~Apply Puppet manifests locally
22
+ .
23
+ .P
24
+ \fBagent\fR
25
+ .
26
+ .br
27
+ \~\~\~\~The puppet agent daemon
28
+ .
29
+ .P
30
+ \fBconfig\fR
31
+ .
32
+ .br
33
+ \~\~\~\~Interact with Puppet\'s settings\.
34
+ .
35
+ .P
36
+ \fBhelp\fR
37
+ .
38
+ .br
39
+ \~\~\~\~Display Puppet help\.
40
+ .
41
+ .P
42
+ \fBlookup\fR
43
+ .
44
+ .br
45
+ \~\~\~\~Interactive Hiera lookup
46
+ .
47
+ .P
48
+ \fBmodule\fR
49
+ .
50
+ .br
51
+ \~\~\~\~Creates, installs and searches for modules on the Puppet Forge\.
52
+ .
53
+ .P
54
+ \fBresource\fR
55
+ .
56
+ .br
57
+ \~\~\~\~The resource abstraction layer shell
58
+ .
59
+ .SS "Specialized"
60
+ \fBstrings\fR
61
+ .
62
+ .br
63
+ \~\~\~\~Generate Puppet documentation with YARD\.
64
+ .
65
+ .P
66
+ \fBcatalog\fR
67
+ .
68
+ .br
69
+ \~\~\~\~Compile, save, view, and convert catalogs\.
8
70
  .
9
71
  .P
10
- Usage: puppet \fIsubcommand\fR [options] \fIaction\fR [options]
72
+ \fBdescribe\fR
73
+ .
74
+ .br
75
+ \~\~\~\~Display help about resource types
76
+ .
77
+ .P
78
+ \fBdevice\fR
79
+ .
80
+ .br
81
+ \~\~\~\~Manage remote network devices
11
82
  .
12
83
  .P
13
- Available subcommands:
84
+ \fBdoc\fR
85
+ .
86
+ .br
87
+ \~\~\~\~Generate Puppet references
14
88
  .
15
89
  .P
16
- Common:
90
+ \fBepp\fR
17
91
  .
18
92
  .br
19
- agent The puppet agent daemon apply Apply Puppet manifests locally config Interact with Puppet\'s settings\. help Display Puppet help\. lookup Interactive Hiera lookup module Creates, installs and searches for modules on the Puppet Forge\. resource The resource abstraction layer shell
93
+ \~\~\~\~Interact directly with the EPP template parser/renderer\.
20
94
  .
21
95
  .P
22
- Specialized:
96
+ \fBfacts\fR
23
97
  .
24
98
  .br
25
- catalog Compile, save, view, and convert catalogs\. describe Display help about resource types device Manage remote network devices doc Generate Puppet references epp Interact directly with the EPP template parser/renderer\. facts Retrieve and store facts\. filebucket Store and retrieve files in a filebucket generate Generates Puppet code from Ruby definitions\. node View and manage node definitions\. parser Interact directly with the parser\. plugin Interact with the Puppet plugin system\. script Run a puppet manifests as a script without compiling a catalog ssl Manage SSL keys and certificates for puppet SSL clients
99
+ \~\~\~\~Retrieve and store facts\.
100
+ .
101
+ .P
102
+ \fBfilebucket\fR
103
+ .
104
+ .br
105
+ \~\~\~\~Store and retrieve files in a filebucket
106
+ .
107
+ .P
108
+ \fBgenerate\fR
109
+ .
110
+ .br
111
+ \~\~\~\~Generates Puppet code from Ruby definitions\.
112
+ .
113
+ .P
114
+ \fBnode\fR
115
+ .
116
+ .br
117
+ \~\~\~\~View and manage node definitions\.
118
+ .
119
+ .P
120
+ \fBparser\fR
121
+ .
122
+ .br
123
+ \~\~\~\~Interact directly with the parser\.
124
+ .
125
+ .P
126
+ \fBplugin\fR
127
+ .
128
+ .br
129
+ \~\~\~\~Interact with the Puppet plugin system\.
130
+ .
131
+ .P
132
+ \fBscript\fR
133
+ .
134
+ .br
135
+ \~\~\~\~Run a puppet manifests as a script without compiling a catalog
136
+ .
137
+ .P
138
+ \fBssl\fR
139
+ .
140
+ .br
141
+ \~\~\~\~Manage SSL keys and certificates for puppet SSL clients
142
+ .
143
+ .SH "SEE ALSO"
144
+ See \fBpuppet help <subcommand>\fR for help on a specific subcommand\.
26
145
  .
27
146
  .P
28
- See \'puppet help \fIsubcommand\fR \fIaction\fR\' for help on a specific subcommand action\. See \'puppet help \fIsubcommand\fR\' for help on a specific subcommand\. Puppet v8\.8\.0
147
+ See \fBpuppet help <subcommand> <action>\fR for help on a specific subcommand action\.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: puppet
3
3
  version: !ruby/object:Gem::Version
4
- version: 8.8.1
4
+ version: 8.9.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Puppet Labs