Railslove Deploy
The Railslove deploy gem to setup a full ruby server stack. Includes Sprinkle setup scripts and Capistrano deployment recipes.
Contact
There is no nice documentation or readme file yet but if you have any problems questions feel free to contact me anytime:
michael@railslove.com skype:derbumi.de irc: derbumi on freenode twitter: @bumi
Idea
The Railslove_deploy gem provides some sprinkle and capistrano recipes to setup a full server stack and deploy your application. It tries to be as configurable as possible by providing a configurable collection of recipies simple recipes.
How to get you going
1. deployify
Run the deployify command in your application root directory to generate all the deployment files
bumi:~/development/rails_apps/stuff/deploy_demo
→ deployify .
[Deployment files created]
This generates the default capistrano files (Capfile and config/deploy.rb) and a config/server directory containing the server configuration files:
- backup.rb - example safe (http://github.com/astrails/safe) backup file
- policy.rb - the sprinkle policy for your server
- vhost.erb - the template to generate your apache vhost config file
- ferm.conf.erb - the ferm (http://ferm.foo-projects.org/) to configure IP tables
2. Adjust your config/deploy.rb file
Adjust the deploy file for your needs. Enter the IPs of your Server, configure your callbacks, etc.
3. Adjust your config/server/policy.rb file
The policy file describes how your server should look like. Here you can configure the packages you want to install.
The default policy installs the following:
policy :passenger_stack, :roles => :app do
requires :webserver # Apache
requires :database # MySQL or SQLite
# memcached
requires :memcached_daemon # Memcached
requires :libmemcached # libmemcached
requires :memcached_conf # memcached-user, init.d config
requires :scm # Git or SVN
requires :ruby # Ruby Enterprise
requires :searchengine # Sphinx
requires :appserver # passenger
requires :rails_user # special rails user with sudo rights
requires :database_driver # Ruby database driver
requires :usefull_gems # usefull, frequently needed gems
requires :image_magick # image magick
requires :ferm # ferm iptable configuration tool
requires :ferm_conf # configure ferm (allow http, https and ssh)
requires :monit # monit - system process monitoring
requires :munin_node # install munin-node for system monitoring
requires :munin_apache_status # configure extended apache status information
end
4. use the sprinkle command to run your policy and setup your server
sprinkle -s config/server/policy.rb
Now sprinkle parses your policy and load the recipes and installs it on the server. After that you're server is ready to deploy.
5. cap deploy:setup
6. cap deploy:cold
You're done. :D
Notes
not included packages
curl/libcurl
to install libcurl try: apt-get install libcurl4-openssl-dev If apt-get fails to install libcurl4-openssl-dev, try libcurl-dev, libcurl4-gnutls-dev, or libcurl3-gnutls-dev.
Issues
- Sprinkle does not have any rollback function if something fails.