Issue #5158 has been updated by Nigel Kersten.

John Warburton wrote:
> If you support the file() syntax, can we remove "source =>" altogether? I see 
> beginners struggle to understand why the puppet syntax forces you to 
> differentiate. 
> 
> The above proposal is superb, as I can have host specific files, but a 
> template by default

If you specify content rather than source, the entire contents of the file are 
contained in the catalog, and are thus transferred every single time the client 
connect.

If you specify source, all the client needs to do is issue a file metadata 
request, and then it only transfers the file contents if necessary.

Depending upon your needs, you may find one of these more suitable than the 
other. It's not ideal to use content for large files that don't change very 
often at all.
----------------------------------------
Feature #5158: File resources: Make source/content parameters and the 
file/template functions consistent.
https://projects.puppetlabs.com/issues/5158

Author: Nigel Kersten
Status: Accepted
Priority: High
Assignee: Nigel Kersten
Category: 
Target version: Statler
Affected Puppet version: 
Keywords: usability
Branch: 


We have four main ways we can specify file content in a file resource.

1. The source parameter
2. The content parameter
3. The file function
4. The template function

These behave inconsistently in the following ways.

The source parameter, file function and template function all can take an 
array. For source/file, the first file that exists will be used. For the 
template function, we concatenate the templates instead.

The file function takes fully qualified paths only.
The template function takes fully qualified paths, or dereferences relative 
paths as follows. 'foo/bar.erb' -> modules/foo/templates/bar.erb

The latter problem is relatively easily solved, particularly if we implement 
#4885

We are going to have to break backwards compatibility to solve the first 
problem however.

My feeling is that more people make use of the multi-select logic in the source 
parameter/file function than make use of the concatenation of the template 
function.


-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to