PuppetConf 2014 - Managing the File and Exposing the API

This talk was given at PuppetConf 2014. It is a discussion about APIs in code and the config files we manage.

Transcript

1. Managing the File and Exposing the API Christopher Webber @cwebber
2. About Me
3. Puppet user since 0.24.7 https://flic.kr/p/nAiooR
4. Responsible for production Puppet in three different orgs https://flic.kr/p/bQ69Ba
5. Also...
7. What even is an API? https://flic.kr/p/77vWDD
8. The way we interact with our code and our systems. https://flic.kr/p/k67A5H
9. It is just as much about what you exclude as what you include https://flic.kr/p/9jkkW5
10. Role, Profile, Application
 and Library Modules https://flic.kr/p/4r9zSK
11. The config itself
12. What does it present to us? https://flic.kr/p/8ko6Ps
13. Monolithic File https://flic.kr/p/acMxYe
14. Does it allow includes? https://flic.kr/p/bWKnKT
15. Is it JSON, XML, or YAML? https://flic.kr/p/hLrqqf
16. Is it Key-Value? https://flic.kr/p/6hk2xF
17. https://flic.kr/p/brxUed
18. Lots of config options https://flic.kr/p/7fxQCs
19. Free form nature
 of config files https://flic.kr/p/9QWhCZ
20. Getting data from/about other systems https://flic.kr/p/tkN5
21. Providing the API
22. Days of Old source => ‘<modulename>/file.conf’ " or worse
 source => [
 ‘<modulename>/file.conf.$hostname’,
 ‘<modulename>/file.conf.$operatingsystem',
 ‘<modulename>/file.conf’
 ]
23. https://flic.kr/p/n3cTbR
24. source vs content https://flic.kr/p/4ZHNM3
26. https://github.com/neillturner/kitchen-puppet
28. Start with just a few config options class {‘::redis’:
 version => ‘2.7’,
 maxmemory => ‘12gb’, maxclients => 1000,
 }
29. Well crap class redis {
 $version = ‘2.7’,
 $maxmemory = ‘12gb’, $maxclients = 1000, $daemonize = ‘yes’, $port = 6379, $tcp_backlog = 511, $bind = ‘127.0.0.1’, $timeout = 0, $syslog_enabled = undef, $repl_timeout = undef, …

30. Enter the array of hashes class {‘::redis::slave’: version => ‘2.7’, master => ’10.0.10.100’, misc_config => { ‘zset-max-ziplist-entries’ => 128, ‘zset-max-ziplist-value’ => 64 } }
31. <% if @master -%> slaveof <%= @master %> 6379 <% end -%> <% if @misc_config -%> <% @misc_config.each_key do |config| -%> <%= config %> <%= @misc_config[config] %> <% end -%> <% end -%>
32. conf.d https://flic.kr/p/iyzCf
33. class {‘apache’: } " file {‘/etc/httpd/conf.d/an_site.conf’: ensure => present, content => template(‘myapp/an_site.conf.erb’), notify => Service[‘apache’] }
34. Coupling Issues https://flic.kr/p/dxxRza
35. Defined Type https://flic.kr/p/p5PoFj
36. class {‘apache’: } " apache::vhost {‘myapp.io’: docroot => ‘/var/www/myapp.io’ }
37. https://flic.kr/p/MHv1n
38. passing in the entire template as an override https://flic.kr/p/5YHoPV
39. #STOP hotlinking RewriteEngine on RewriteCond %{HTTP_REFERER} !^$ RewriteCond %{HTTP_REFERER} !^http://(www\.)?yourdomain.com(/)?.*$ [NC] RewriteRule \.(jpe?g|gif|bmp|png)$ nohotlink.jpg [L,NC]
40. class {‘apache’: } " apache::vhost {‘myapp.io’: docroot => ‘/var/www/myapp.io’, override => template(‘myapp/myapp.conf.erb’) }
41. Questions?
42. Thanks! http://cwebber.net Twitter: @cwebber IRC: cwebber GitHub: @cwebberops