Skip to content

Commit 6938376

Browse files
committed
Generate docs for 6.16
1 parent 9211052 commit 6938376

File tree

18 files changed

+5121
-670
lines changed

18 files changed

+5121
-670
lines changed

source/puppet/latest/configuration.md

Lines changed: 42 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: default
3-
built_from_commit: 5c9738d96e0f4ffdaf2e8f9284d22388136641f6
3+
built_from_commit: 2959aff838fdb13a35943fa8a83581fc3c1f0707
44
title: Configuration Reference
55
toc: columns
66
canonical: "/puppet/latest/configuration.html"
@@ -952,7 +952,7 @@ This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours
952952

953953
The HTTP User-Agent string to send when making network requests.
954954

955-
- *Default*: Puppet/6.14.0 Ruby/2.5.1-p57 (x86_64-darwin17)
955+
- *Default*: Puppet/6.16.0 Ruby/2.3.7-p456 (universal.x86_64-darwin18)
956956

957957
### ignoremissingtypes
958958

@@ -1209,6 +1209,15 @@ This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours
12091209

12101210
- *Default*: unlimited
12111211

1212+
### maxwaitforlock
1213+
1214+
The maximum amount of time the puppet agent should wait for an
1215+
already running puppet agent to finish before starting a new one. This is set by default to 1 minute.
1216+
A value of `unlimited` will cause puppet agent to wait indefinitely.
1217+
This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
1218+
1219+
- *Default*: 1m
1220+
12121221
### merge_dependency_warnings
12131222

12141223
Whether to merge class-level dependency failure warnings.
@@ -1532,6 +1541,17 @@ Whether to send reports after every transaction.
15321541

15331542
- *Default*: true
15341543

1544+
### report_include_system_store
1545+
1546+
Whether the 'http' report processor should include the system
1547+
certificate store when submitting reports to HTTPS URLs. If false, then
1548+
the 'http' processor will only trust HTTPS report servers whose certificates
1549+
are issued by the puppet CA or one of its intermediate CAs. If true, the
1550+
processor will additionally trust CA certificates in the system's
1551+
certificate store.
1552+
1553+
- *Default*: false
1554+
15351555
### report_port
15361556

15371557
The port to communicate with the report_server.
@@ -1603,7 +1623,14 @@ uses its own auth.conf that must be placed within its configuration directory.
16031623

16041624
### resubmit_facts
16051625

1606-
Whether to send updated facts after every transaction.
1626+
Whether to send updated facts after every transaction. By default
1627+
puppet only submits facts at the beginning of the transaction before applying a
1628+
catalog. Since puppet can modify the state of the system, the value of the facts
1629+
may change after puppet finishes. Therefore, any facts stored in puppetdb may not
1630+
be consistent until the agent next runs, typically in 30 minutes. If this feature
1631+
is enabled, puppet will resubmit facts after applying its catalog, ensuring facts
1632+
for the node stored in puppetdb are current. However, this will double the fact
1633+
submission load on puppetdb, so it is disabled by default.
16071634

16081635
- *Default*: false
16091636

@@ -2047,6 +2074,18 @@ This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours
20472074

20482075
- *Default*: 2m
20492076

2077+
### waitforlock
2078+
2079+
How frequently puppet agent should try running when there is an
2080+
already ongoing puppet agent instance.
2081+
2082+
This argument is by default disabled (value set to 0). In this case puppet agent will
2083+
immediatly exit if it cannot run at that moment. When a value other than 0 is set, this
2084+
can also be used in combination with the `maxwaitforlock` argument.
2085+
This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y).
2086+
2087+
- *Default*: 0
2088+
20502089
### yamldir
20512090

20522091
The directory in which YAML data is stored, usually in a subdirectory.

source/puppet/latest/core_facts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: default
3-
built_from_commit: bf9a4b6e9edf8b57d6b4010a1e3adda736ed2421
3+
built_from_commit: 2499c0dff0466dcc34624e5a00e10c8b62101915
44
title: 'Facter: Core Facts'
55
toc: columns
66
canonical: "/puppet/latest/core_facts.html"

source/puppet/latest/function.md

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
layout: default
3-
built_from_commit: f03f25066a56ff61ba828f787fa32600f7d1f169
3+
built_from_commit: 2959aff838fdb13a35943fa8a83581fc3c1f0707
44
title: Built-in function reference
55
canonical: "/puppet/latest/function.html"
66
toc_levels: 2
77
toc: columns
88
---
99

10-
> **NOTE:** This page was generated from the Puppet source code on 2020-05-26 11:40:10 -0700
10+
> **NOTE:** This page was generated from the Puppet source code on 2020-06-30 08:58:23 +0100
1111
1212
This page is a list of Puppet's built-in functions, with descriptions of what they do and how to use them.
1313

@@ -76,6 +76,7 @@ Logs a message on the server at level `alert`.
7676

7777
#### Parameters
7878

79+
7980
* `*values` --- The values to log.
8081

8182
Return type(s): `Undef`.
@@ -799,6 +800,7 @@ Logs a message on the server at level `crit`.
799800

800801
#### Parameters
801802

803+
802804
* `*values` --- The values to log.
803805

804806
Return type(s): `Undef`.
@@ -812,6 +814,7 @@ Logs a message on the server at level `debug`.
812814

813815
#### Parameters
814816

817+
815818
* `*values` --- The values to log.
816819

817820
Return type(s): `Undef`.
@@ -1120,6 +1123,7 @@ Logs a message on the server at level `emerg`.
11201123

11211124
#### Parameters
11221125

1126+
11231127
* `*values` --- The values to log.
11241128

11251129
Return type(s): `Undef`.
@@ -1214,6 +1218,7 @@ Logs a message on the server at level `err`.
12141218

12151219
#### Parameters
12161220

1221+
12171222
* `*values` --- The values to log.
12181223

12191224
Return type(s): `Undef`.
@@ -1289,6 +1294,7 @@ as an array in the form `[key, value]` and returns a hash containing the results
12891294
$data = { "orange" => 0, "blueberry" => 1, "raspberry" => 2 }
12901295
$filtered_data = $data.filter |$items| { $items[0] =~ /berry$/ }
12911296
# $filtered_data = {blueberry => 1, raspberry => 2}
1297+
```
12921298

12931299
When the first argument is an array and the lambda has two parameters, Puppet passes the
12941300
array's indexes (enumerated from 0) in the first parameter and its values in the second
@@ -1680,10 +1686,12 @@ Signature 1
16801686

16811687
#### Parameters
16821688

1689+
16831690
* `collection` --- A collection of things to group.
16841691

16851692
Return type(s): `Hash`.
16861693

1694+
16871695
#### Examples
16881696

16891697
Group array of strings by length, results in e.g. { 1 => [a, b], 2 => [ab] }
@@ -2196,6 +2204,7 @@ Logs a message on the server at level `info`.
21962204

21972205
#### Parameters
21982206

2207+
21992208
* `*values` --- The values to log.
22002209

22012210
Return type(s): `Undef`.
@@ -3883,6 +3892,7 @@ Logs a message on the server at level `notice`.
38833892

38843893
#### Parameters
38853894

3895+
38863896
* `*values` --- The values to log.
38873897

38883898
Return type(s): `Undef`.
@@ -3899,10 +3909,12 @@ Signature 1
38993909

39003910
#### Parameters
39013911

3912+
39023913
* `collection` --- A collection of things to partition.
39033914

39043915
Return type(s): `Tuple[Array, Array]`.
39053916

3917+
39063918
#### Examples
39073919

39083920
Partition array of empty strings, results in e.g. [[''], [b, c]]
@@ -4080,6 +4092,7 @@ Signature 1
40804092

40814093
#### Parameters
40824094

4095+
40834096
* `target` --- The string or array of strings to operate on. If an array, the replacement will be
40844097
performed on each of the elements in the array, and the return value will be an array.
40854098

@@ -4106,6 +4119,7 @@ precompiled regexp). A single-character string with the following values:
41064119

41074120
Return type(s): `Array[String]`, `String`. The result of the substitution. Result type is the same as for the target parameter.
41084121

4122+
41094123
#### Examples
41104124

41114125
Get the third octet from the node's IP address:
@@ -4121,6 +4135,7 @@ Signature 2
41214135

41224136
#### Parameters
41234137

4138+
41244139
* `target` --- The string or array of strings to operate on. If an array, the replacement will be
41254140
performed on each of the elements in the array, and the return value will be an array.
41264141

@@ -4147,6 +4162,7 @@ precompiled regexp). A single-character string with the following values:
41474162

41484163
Return type(s): `Array[String]`, `String`. The result of the substitution. Result type is the same as for the target parameter.
41494164

4165+
41504166
#### Examples
41514167

41524168
Put angle brackets around each octet in the node's IP address:
@@ -5336,6 +5352,7 @@ Logs a message on the server at level `warning`.
53365352

53375353
#### Parameters
53385354

5355+
53395356
* `*values` --- The values to log.
53405357

53415358
Return type(s): `Undef`.
@@ -5372,4 +5389,4 @@ how to use this function.
53725389

53735390
`yaml_data(Struct[{path=>String[1]}] $options, Puppet::LookupContext $context)`
53745391

5375-
> **NOTE:** This page was generated from the Puppet source code on 2020-05-26 11:40:10 -0700
5392+
> **NOTE:** This page was generated from the Puppet source code on 2020-06-30 08:58:23 +0100

0 commit comments

Comments
 (0)