Moonshine

Introducing Moonshine, the Rails-focused Ruby DSL for Puppet. Presented at ATLRUG in 2009

Transcript

1. Rails Machine Thursday, January 15, 2009
2. The State of Rails Application Deployment Thursday, January 15, 2009
3. It’s easy, I’ll just use Capistrano. Thursday, January 15, 2009
4. It’s easy, I’ll just use Capistrano. ssh me@mynewserver.com Thursday, January 15, 2009
5. It’s easy, I’ll just use Capistrano. apt‐get install libmagick10 libmagick9‐dev ssh me@mynewserver.com Thursday, January 15, 2009
6. It’s easy, I’ll just use Capistrano. gem install rmagick apt‐get install libmagick10 libmagick9‐dev ssh me@mynewserver.com Thursday, January 15, 2009
7. It’s easy, I’ll just use Capistrano. gem install rmagick apt‐get install libmagick10 libmagick9‐dev ssh me@mynewserver.com apt‐get install mysql‐ server libmysql‐ruby libmysqlclient15‐dev Thursday, January 15, 2009
8. It’s easy, I’ll just use Capistrano. gem install rmagick apt‐get install libmagick10 libmagick9‐dev ssh me@mynewserver.com vi /etc/my.cnf apt‐get install mysql‐ server libmysql‐ruby libmysqlclient15‐dev Thursday, January 15, 2009
9. It’s easy, I’ll just use Capistrano. gem install rmagick apt‐get install libmagick10 libmagick9‐dev ssh me@mynewserver.com vi /etc/my.cnf apt‐get install mysql‐ server libmysql‐ruby libmysqlclient15‐dev /etc/init.d/mysql start Thursday, January 15, 2009
10. UR SHIPMENT OF FAIL HAS ARRIVED Thursday, January 15, 2009
11. What is deployment? Thursday, January 15, 2009
12. A Series of Dependencies • Rails v2.2.2, v1.2.3, etc • Ruby/Ruby Enterprise • Apache/Nginx • Passenger/Thin/Mongrel • MySQL/PostgreSQL • system user Thursday, January 15, 2009
13. A Series of Dependencies • rmagick • libmagick10 libmagick9-dev • thinking-sphinx • compile by hand • memcached • libmemcached, rubygem, service Thursday, January 15, 2009
14. Satisfying these dependencies via shell commands is backwards Thursday, January 15, 2009
15. • impossible to verify • not revisioned • no ‘migrations’ • not DRY • not testable Thursday, January 15, 2009
16. Not “The Rails Way” Thursday, January 15, 2009
17. script/plugin install moonshine_rails* script/generate moonshine Thursday, January 15, 2009
18. Moonshine::Manifest #config/moonshine/default.rb class Moonshine::Manifest::Rails::Production < Moonshine::Manifest::Rails #packages(%w(vim curl)) #service('memcached', %w(memcache libmemcached)) #puppet.exec 'foo', # :command => "echo 'normal puppet stuff' > /tmp/test" end Thursday, January 15, 2009
19. Opinionated Software Thursday, January 15, 2009
20. Opinionated Deployment Thursday, January 15, 2009
21. • Ubuntu • Apache • Passenger • Ruby Enterprise Edition • MySQL • ‘rails’ user • /srv/rails Decisions We’ve Made For You Thursday, January 15, 2009
22. class Moonshine::Manifest::Rails < Moonshine::Manifest requires [ :user, :ruby, :rubygems, :db, :web, :rails, :deploy ] provides :user, 'rails' provides :ruby, 'enterprise_ruby' provides :rubygems, 'enterprise_rubygems' provides :db, 'mysql' provides :web, 'apache2' provides :rails, 'passenger' provides :deploy, 'git' end Look at all the choices I’m not making Thursday, January 15, 2009
23. On your server... Thursday, January 15, 2009
24. sudo apt‐get install moonshine* sudo moonshine Thursday, January 15, 2009
25. Answer some questions • application name • git repo • branch to deploy from • user to create • generates SSH key for git host • server ‘tags’ Thursday, January 15, 2009
26. Moonshine goes to work • clones your repo • parses and executes generated moonshine manifests • installs needed gems • install dependencies • migrates your db • deploys your app Thursday, January 15, 2009
27. Gem Dependencies gem_dependencies do |gem| #lots of dependencies are specified for you already #gem.packages 'mysql', %w(mysql‐dev libmysqlclient5‐dev) #gem.packages 'rmagick', %w(ruby‐dev libmagick9‐dev) #... #can specify a mini‐manifest to satisfy before #installation of this gem gem.custom 'urgem' do |puppet| puppet.file '/file/needed/by/ur/gem', :ensure => 'present', :content => 'foo' build_tarball('http://whatever.com/lib‐something.tgz') end end Thursday, January 15, 2009
28. #need to deploy again? sudo moonshine Thursday, January 15, 2009
29. On subsequent runs • updates your repo • parses and executes updated moonshine manifests • verifies needed gems • verifies dependencies • migrates your db • deploys your app Thursday, January 15, 2009
30. • Reproducible • Verified from top-bottom on each deploy • Versionable with your application • same commit can contain, for example, thinking sphinx and installation of the sphinx searchd daemon • DRY Deployment is now... Thursday, January 15, 2009
31. Puppet Based class MysqlMain < Moonshine::Manifest puppet.file '/etc/my.cnf', :ensure => 'present', :content => """ [client] port = 3306 socket = /var/run/mysqld/mysqld.sock [mysqld] default‐character‐set = utf8 key_buffer = 16M max_allowed_packet = 16M thread_stack = 128K thread_cache_size = 8 """ end Thursday, January 15, 2009
32. But Ruby class MysqlMain < Moonshine::Manifest puppet.file '/etc/my.cnf', :ensure => 'present', :content => ArbitraryKlass.arbitrary_function('foo') end Thursday, January 15, 2009
33. Modular UrClass < Moonshine::Manifest::Rails < Moonshine::Manifest •easy to create your own reusable server manifests •extend existing ones with modules Thursday, January 15, 2009
34. Sample ‘plugin’ module MoonshineOrderedPackages def packages(array_or_name, params = {}) package_array = array_or_name.to_a params = { :ensure => 'installed' }.merge(params) package_array.each_with_index do |name,index| #ensure packages are installed in order given package_params = params if package_array[index+1] package_params.merge({ :before => package(package_array[index+1]) }) end puppet.package name.to_s, package_params end end end Moonshine::Manifest::Rails.send(:extend, MoonshineOrderedPackages) Thursday, January 15, 2009
35. Coming Soon • screencast demo (blog.railsmachine.com) • source on GitHub Thursday, January 15, 2009
36. Questions? Thursday, January 15, 2009
37. Jesse Newland jesse@railsmachine.com Thursday, January 15, 2009
38. Flickr FTW • http://www.flickr.com/photos/wolfgangstaudt/2279651479/sizes/o/ • http://www.flickr.com/photos/ramdac/373881476/sizes/o/ • http://www.flickr.com/photos/striatic/2192189572/sizes/o/ • http://www.flickr.com/photos/blakespot/2376243022/sizes/o • http://www.flickr.com/photos/gravestone/449328990/sizes/l/ • http://www.flickr.com/photos/redglow/410800461/sizes/o/ Thursday, January 15, 2009