Skip to content

Commit 14ef688

Browse files
authored
Merge pull request #390 from miharp/docs/collector-warning-389
Add unbounded-collector warning to the resource collectors page
2 parents f0b94d2 + caa7b64 commit 14ef688

2 files changed

Lines changed: 5 additions & 1 deletion

File tree

docs/_openvox_8x/lang_collectors.markdown

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,10 @@ resembles the normal syntax for [Puppet expressions][expressions], but is not th
5353
5454
A collector with an empty search expression will match **every** resource of the specified resource type.
5555

56+
{% include alert.html type="warning" content="Do not use unbounded resource collectors without search expressions to limit which resources match.
57+
They have a side effect of _realizing_ any matching virtual resources whether declared in your own code or in third party modules.
58+
Using unbounded collectors may result in many unexpected resources being managed and may have unforeseeable consequences like undesired configuration changes." %}
59+
5660
Parentheses can be used to improve readability and to modify the priority/grouping of `and`/`or`. You can
5761
create arbitrarily complex expressions using the following four operators:
5862

docs/_openvox_8x/lang_relationships.markdown

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -163,7 +163,7 @@ This example applies all internal yum repository resources before applying any i
163163

164164
{% include alert.html type="warning" content="Do not use unbounded resource collectors without search expressions to limit which resources match.
165165
They have a side effect of _realizing_ any matching virtual resources whether declared in your own code or in third party modules.
166-
Using unbounded collectors may result in many unexpected resources being managed and may have catastrophic consequences." %}
166+
Using unbounded collectors may result in many unexpected resources being managed and may have unforeseeable consequences like undesired configuration changes." %}
167167

168168
### Capturing resource references for generated resources
169169

0 commit comments

Comments
 (0)