This document provides an overview and walkthrough for mastering puppet configuration management. It introduces puppet and compares it to other solutions like Chef and CFEngine. It outlines puppet's client/server model and covers setting up the master directory structure and configuring agents. The document explains puppet's resource types and manifest syntax. It also provides instructions for setting up an environment and implementing a sample configuration for packages, services, and files.

1. Your ultimate walkthrough
Mastering puppets

2. Menu de jour
1. Intro
2. Puppet overview
3. Environment setup
4. Implementation
5. Review
6. Happy end

3. Intro
• Why configuration provisioning?
• Available solutions
• Which one to select, why?
• How to implement it?

4. Why configuration provisioning?
• It’s DRY
• Law enforcement
• Easier change management
• Easier system scaling
• Better mission control

5. Available solutions
• puppetlabs.com (Ruby)
• cfengine.com (C)
• quattor.org (Perl, Python)
• opscode.com/chef (Ruby)
• … and many others

6. Which one to select, why?
• Puppet
– nicely designed
– straightforward
– Integrations with AWS, Openstack, …
– backed by Google Ventures, Cisco, Vmware
– And it’s Ruby of course

7. How to implement it?
• Install prebuilt packages
• Make it version controlled
• Integrate with project management tool

8. Puppet overview
• client/server software
• They call it agent/master

9. Master directory structure
• /etc/puppet
– /etc/puppet/puppet.conf
– /etc/puppet/manifests
– /etc/puppet/modules
– /etc/puppet/autosign.conf

10. Agent configuration
• /etc/puppet/puppet.conf
server=[hostname/ip]
report=[true/false]
runinterval=[n]s

11. Manifests syntax
class cms::sudo {
#
# /etc/sudoers configuration file
#
file { '/etc/sudoers':
source => 'puppet:///modules/cms/etc/sudoers',
owner => 'root',
group => 'root',
mode => 440,
}
}

12. Manifests syntax vol. #2
service { 'apache2':
ensure => running,
enable => true,
hasstatus => true,
hasrestart => true,
require => [
Mount['/mnt/www-data'],
Mount['/mnt/archive'],
File['/etc/apache2'],
File['/opt/cache'],
File['/tmp/huste'],
File['/tmp/topstar'],
File['/tmp/hcslovan'],
File['/usr/local/lib/php5/php-cgi-wrapper'],
]
}

13. Some resource types
• package
• file
• service
• cron
• mount
• exec

14. Online docs
• Reference manual
http://docs.puppetlabs.com/references/3.1.latest/
• Resource types
http://docs.puppetlabs.com/references/3.1.latest/type.html

15. Environment setup
• Groups of three
• Sys admin (lead)
• Web admin
• Db admin

16. Implementation
• required packages: vim, tcpdump, mtr
• Web server: apache2 + php (mod/cgi)
• Mysql server: mysql5

17. Go ahead …
• Ask for help when needed
http://192.168.122.100/a.txt
http://192.168.122.100/b.txt
http://192.168.122.100/c.txt
…

18. Review

19. Happy end
• Real-world implementation show off

20. Questions?

21. More questions?
Matúš Bursa
matus.bursa@websupport.sk
Peter Mihálik
peter.mihalik@bonet.sk