@@ -117,29 +117,49 @@ file_line { 'bashrc_proxy':
117117
118118マッチ例:
119119
120- file_line { 'bashrc_proxy':
121- ensure => present,
122- path => '/etc/bashrc',
123- line => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
124- match => '^export\ HTTP_PROXY\=',
125- append_on_no_match => false,
126- }
120+ ``` puppet
121+ file_line { 'bashrc_proxy':
122+ ensure => present,
123+ path => '/etc/bashrc',
124+ line => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
125+ match => '^export\ HTTP_PROXY\=',
126+ append_on_no_match => false,
127+ }
128+ ```
129+
130+ このコードの例では、` match ` によってexportで始まり'HTTP_PROXY'が続く行が検索され、その行が行内の値に置き換えられます。マッチするものが見つからない場合、ファイルは変更されません。
131+
132+ ` ensure => absent ` の例:
127133
128- このコードの例では、 ` match ` によってexportで始まりHTTP_PROXYが続く行が検索され、その行が行内の値に置き換えられます。マッチするものが見つからない場合、ファイルは変更されません 。
134+ ` ensure => absent ` を設定する場合に、このタイプの動作には2通りがあります 。
129135
130- ` ensure => absent ` を用いたマッチ例:
136+ 1つは` match => ... ` と` match_for_absence => true ` の設定です。` match ` により、'export'で始まり'HTTP_PROXY'と続く行が探され、その行が削除されます。複数の行がマッチし、` multiple => true ` パラメータが設定されていない場合は、エラーが生じます。
137+
138+ この例で` line => ... ` パラメータは承認されますが無視されます。
139+
140+ 例:
131141
132142``` puppet
133143file_line { 'bashrc_proxy':
134144 ensure => absent,
135145 path => '/etc/bashrc',
136- line => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
137146 match => '^export\ HTTP_PROXY\=',
138147 match_for_absence => true,
139148}
140149```
141150
142- 上の例では、` match ` により、'export'で始まり'HTTP_PROXY'と続く行が探され、その行が削除されます。複数の行がマッチし、` multiple => true ` パラメータが設定されていない場合は、エラーが生じます。
151+ ` ensure => absent ` を設定する場合のもう1つの動作は、` line => ... ` の指定と一致なしです。行が存在しないことを確認した場合のデフォルトの動作では、マッチするすべての行を削除します。この動作を無効にすることはできません。
152+
153+ 例:
154+
155+ ``` puppet
156+ file_line { 'bashrc_proxy':
157+ ensure => absent,
158+ path => '/etc/bashrc',
159+ line => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
160+ }
161+ ```
162+
143163
144164エンコード例:
145165
@@ -193,7 +213,7 @@ file_line { "XScreenSaver":
193213
194214##### ` match `
195215
196- ファイル内の既存の行と比較する正規表現を指定します。マッチが見つかった場合、新規の行を追加するかわりに 、置き換えられます。正規表現の比較は行の値に照らして行われ、マッチしない場合は、例外が発生します 。
216+ ファイル内の既存の行と比較する正規表現を指定します。マッチが見つかった場合、新規の行を追加する代わりに 、置き換えられます。
197217
198218値: 正規表現を含む文字列
199219
@@ -210,7 +230,7 @@ file_line { "XScreenSaver":
210230
211231##### ` multiple `
212232
213- ` match ` および` after ` により複数の行を変更できるかどうかを指定します。` false ` に設定すると、複数の行がマッチする場合に例外が発生します 。
233+ ` match ` および` after ` により複数の行を変更できるかどうかを指定します。` false ` に設定すると、file_lineは1つの行のみ置き換えることができますが、複数の行を置き換えようとするとエラーが発生します。 ` true ` に設定すると、file_lineは1つまたは複数の行を置き換えることができます 。
214234
215235値: ` true ` 、` false `
216236
@@ -235,12 +255,20 @@ file_line { "XScreenSaver":
235255
236256##### ` replace `
237257
238- ` match ` パラメータとマッチする既存の行を上書きするかどうかを指定します。` false ` に設定すると、` match ` パラメータにマッチする行が見つかった場合、その行はファイルに配置されません。
258+ ` match ` パラメータとマッチする既存の行をリソースで上書きするかどうかを指定します。` false ` に設定すると、` match ` パラメータにマッチする行が見つかった場合、その行はファイルに配置されません。
259+
260+ ` false ` に設定すると、` match ` パラメータにマッチする行が見つかった場合、その行はファイルに配置されません。
239261
240262ブーリアン
241263
242264デフォルト値: ` true `
243265
266+ ##### ` replace_all_matches_not_matching_line `
267+
268+ ` line ` がファイルにすでに存在する場合でも、` match ` パラメータに一致するすべての行が置き換えられます。
269+
270+ デフォルト値: ` false `
271+
244272### データタイプ
245273
246274#### ` Stdlib::Absolutepath `
@@ -2214,7 +2242,7 @@ validate_ip_address('260.2.32.43')
22142242例:
22152243
22162244``` puppet
2217- validate_legacy(" Optional[String]", " validate_re", " Value to be validated" , ["."])
2245+ validate_legacy(' Optional[String]', ' validate_re', ' Value to be validated' , ["."])
22182246```
22192247
22202248この関数は、Puppet 3形式の引数確認(stdlibの` validate_* ` 関数を使用)からPuppet 4データタイプへのモジュールのアップデートに対応しており、Puppet 3形式の確認に頼っている場合も機能性が中断することはありません。
0 commit comments