Railsmachine - Moonshine

Rails Machine

Thursday, January 15, 2009

The State of Rails Application Deployment


It’s easy, I’ll just use Capistrano.



ssh [email protected]


It’s easy, I’ll just use Capistrano.apt‐get install libmagick10

libmagick9‐dev




gem inst

all rmag

ick

apt‐get install libmagick10

libmagick9‐dev




gem inst

all rmag

ick


libmagick9‐dev

ssh [email protected]‐

get inst

all mysq

l‐

server l

ibmysql‐

ruby

libmysql

client15

‐dev



gem inst

all rmag

ick


libmagick9‐dev


vi /etc/

my.cnf

apt‐get

install

mysql‐

server l

ibmysql‐

ruby

libmysql

client15

‐dev



gem inst

all rmag

ick


libmagick9‐dev


vi /etc/

my.cnf

apt‐get

install

mysql‐

server l

ibmysql‐

ruby

libmysql

client15

‐dev

/etc/init.d/mysql start


UR SHIPMENT OF FAIL HAS ARRIVEDThursday, January 15, 2009

What is deployment?


A Series of Dependencies

• Rails v2.2.2, v1.2.3, etc

• Ruby/Ruby Enterprise

• Apache/Nginx

• Passenger/Thin/Mongrel

• MySQL/PostgreSQL

• system user


A Series of Dependencies

• rmagick

• libmagick10 libmagick9-dev

• thinking-sphinx

• compile by hand

• memcached

• libmemcached, rubygem, service


Satisfying these dependencies via shell commands is backwards


• impossible to verify

• not revisioned

• no ‘migrations’

• not DRY

• not testable


Not “The Rails Way”


script/plugin install moonshine_rails*script/generate moonshine


Moonshine::Manifest

#config/moonshine/default.rbclass 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


Opinionated Software


Opinionated DeploymentThursday, January 15, 2009

• Ubuntu

• Apache

• Passenger

• Ruby Enterprise Edition

• MySQL

• ‘rails’ user

• /srv/rails

Decisions We’veMade For You


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


On your server...


sudo apt‐get install moonshine*sudo moonshine


Answer some questions

• application name

• git repo

• branch to deploy from

• user to create

• generates SSH key for git host

• server ‘tags’


Moonshine goes to work

• clones your repo

• parses and executes generated moonshine manifests

• installs needed gems

• install dependencies

• migrates your db

• deploys your app


Gem Dependenciesgem_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


#need to deploy again?sudo moonshine


On subsequent runs

• updates your repo

• parses and executes updated moonshine manifests

• verifies needed gems

• verifies dependencies

• migrates your db

• deploys your app


• 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...


Puppet Basedclass MysqlMain < Moonshine::Manifest puppet.file '/etc/my.cnf', :ensure => 'present', :content => """[client]port = 3306socket = /var/run/mysqld/mysqld.sock[mysqld]default‐character‐set = utf8key_buffer = 16Mmax_allowed_packet = 16Mthread_stack = 128Kthread_cache_size = 8"""end


But Ruby

class MysqlMain < Moonshine::Manifest puppet.file '/etc/my.cnf', :ensure => 'present', :content => ArbitraryKlass.arbitrary_function('foo')end


ModularUrClass < Moonshine::Manifest::Rails < Moonshine::Manifest

•easy to create your own reusable server manifests

•extend existing ones with modules


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 endend

Moonshine::Manifest::Rails.send(:extend, MoonshineOrderedPackages)


Coming Soon

• screencast demo (blog.railsmachine.com)

• source on GitHub


Questions?


Jesse Newland

[email protected]


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/


Technology

Railsmachine - Moonshine