Puppet Module Best Practices - Puppet Camp Silicon Valley
•Download as PPT, PDF•
14 likes•3,332 views
Ryan Coleman presents "Puppet Module Best Practices" at Puppet Camp Silicon Valley 2014
Recommended
Recommended
More Related Content
Similar to Puppet Module Best Practices - Puppet Camp Silicon Valley
Similar to Puppet Module Best Practices - Puppet Camp Silicon Valley (20)
More from Puppet
More from Puppet (20)
Puppet Module Best Practices - Puppet Camp Silicon Valley
- 1. Ryan Coleman Writing Better Modules @ryanycoleman | ryan@puppetlabs.com
- 2. Where I Came From • • • Penn Stater Professional Traveler Blacksmith #PuppetCamp
- 3. #PuppetCamp
- 4. #PuppetCamp
- 5. #PuppetCamp
- 10. #PuppetCamp
- 11. #PuppetCamp
- 12. #PuppetCamp
- 14. Why Share?
- 16. Keep it modular
- 17. Dependencies can be your friend
- 20. #PuppetCamp
- 21. #PuppetCamp
- 22. #PuppetCamp
- 23. #PuppetCamp
- 27. Vim • vim-pathogen or vundle (for plugins) • snipmate (like TextMate) • tabular • syntastic • mv-vim-puppet
- 28. Class Layout & Parameter Naming
- 30. VS
- 31. Private classes should be discrete
- 36. https://github.com/stdmod/pup pet-modules A community-driven effort to standardize on param names
- 37. Roles & Profiles
- 38. Roles are the service to be offered, roll-up profiles Profiles merge tech modules with business logic
- 39. Containment
- 40. Anchor Pattern
- 42. Documentation the most important part!
- 43. Answer these questions • What technology does your module manage? • What does it intend to do? • How does it do it? (impact on the system) • How should one use it?
- 45. Versioning
- 46. Semantic Versioning • Based on Major.Minor.Patch scheme • X.0.0 Major version for breaking change • 0.X.0 Minor version for new non-breaking functionality • 0.0.X Patch version for backwards compatible bug fixes
- 48. Data & Modules
- 49. Why separate?
- 50. Two Types of Data • Site • Which port do I bind to? • Logistics • Which package for this OS?
- 54. Site • node definitions • ENC
- 59. Automatic Data Lookup Built into Puppet 3
- 61. Data Lookup Order • Use explicit class declaration values • • • Query Data Binding Use the default value from class. Fail compilation with an error if no value can be found.
- 65. Module Testing A Brief Overview
- 72. rspec-system
- 74. Beaker
- 76. Writing Better Modules • Keep them simple & modular • Consistent Style • Useful Documentation • Separate Code From Data • Test Against Regressions
- 79. Thank You! Feel free to email or tweet anytime RE: Forge! ryan@puppetlabs.com - @ryanycoleman forge.puppetlabs.com #PuppetCamp
Editor's Notes
- Ryan was a RedHat sysadmin for Penn State before joining Puppet Labs as a professional services engineer. Now is product owner for the Forge.
- The Puppet Forge is a community driven web service for contributing and finding Puppet modules.
- The following are examples of what you will find on the Forge.
- Many Puppet modules offer users way too many interaction points or one massive entry point that is too difficult to comprehend. The end result isn’t user friendly and doesn’t help with maintenance either.
- The answer, use Hiera! Seriously, these docs rock. Read them. http://docs.puppetlabs.com/hiera/1/index.html
- But really, just get yourself onto Puppet 3 and take advantage of automatic Hiera!
- This slide could be more visual vs text-based
- There’s already an alternative out there, for consulting foreman as your data backend
- Hiera backends are pluggable too. Here are two examples.
- If you want to add your influence to our products, join the Puppet Labs Test Pilots program! https://puppetlabs.com/community/puppet-test-pilots-program/
- Seriously, join our team. It’ll be awesome.