Bug #3772

confusing warning related to undocumented change in interpretation of "source" parameter for files

Added by Alan Barrett about 2 years ago. Updated about 2 years ago.

Status:Closed Start date:05/14/2010
Priority:Normal Due date:
Assignee:James Turnbull % Done:

0%

Category:documentation
Target version:0.25.5
Affected Puppet version:0.25.4 Branch:
Keywords:
Votes: 0

Description

This warning appears in src/lib/puppet/file_serving/configuration.rb:

“DEPRECATION NOTICE: Files found in modules without specifying ‘modules’ in file path will be deprecated in the next major release. Please fix module ‘%s’ when no 0.24.x clients are present”

I think it’s trying to say something like: Please change source => “puppet:///mymodule/myfile” to source => “puppet:///modules/mymodule/myfile” in all file resources.

However, I don’t see any documentation that explains this change, and without documentation to back it up, I find the warning confusing. Almost all the examples that I can find use the name of the module, not the word “modules”, as the first component of the path (after the server name) in the “source” parameter of file resources. Even the release notes for puppet 0.25.0 (which I think is where the change occurred) don’t hint at this. They say “The module name must now be specified in source attributes of the file type” (which I thought had already been true in version 0.24), and don’t say anything about the word “modules”.

History

Updated by Alan Barrett about 2 years ago

  • Subject changed from confusing warning related to undocumented change in interpretation of "source" paramneter for files to confusing warning related to undocumented change in interpretation of "source" parameter for files

Updated by James Turnbull about 2 years ago

  • Category set to documentation
  • Status changed from Unreviewed to Closed
  • Assignee set to James Turnbull
  • Target version set to 0.25.5

This is an oversight. I’ve updated some documentation in commit:dec84e5409a2f8e63805c045bebafab4973ba4d0 and updated the Release Notes and File Serving documentation.

Updated by Alan Barrett about 2 years ago

Thanks, that’s much better.

Also available in: Atom PDF