Padrino and Engine Yard AppCloud

Engine Yard AppCloud is a great platform for deploying Ruby on Rails applications quickly and easily. It's not only good for Rails, but it also makes it just as easy to deploy any application using Rack or Rack-based frameworks like Sinatra. I'm a big fan of Sinatra and use it for both internal and personal projects. I even spoke about creating "stupid simple" Sinatra micro-apps at Red Dirt Ruby Conf this past year. As a web application developer, it's a wonderful tool to have under your belt for shipping quick, small, and targeted applications or middleware. However, with increasingcomplexity in a project, I want the ease of Sinatra with a little more "oomf". Sinatra is a great web DSL and is perfect for small, isolated applications. But when crafting complex applications, one quickly longs for improved organization, such as the logical separation of an MVC architecture. I found myself writing boilerplate code for each project, setting up the same code for common components: haml, mongo_mapper, rspec, and whatever component the project required. The layout of the boilerplate Sinatra setup I used looked a lot like an ugly parody of Rails and quickly overwhelmed me with too much bloat for a "micro" Sinatra application.

The Padrino Framework

Wynn Netherland asked me at Red Dirt Ruby Conf if I had heard of a framework called Padrino, which solves a lot of these problems. I hadn't heard of it but promised him I'd take a look. Later that day I dove in and instantly fell in love. Padrino provides a well-organized MVC architecture on top of Sinatra. You can easily create complex web applications while harnessing the power of Sinatra and Rack with lots of additional goodies thrown in. You get helpers, forms, mailers, and a built-in admin interface, similar to what you get with Django and easier than implementing something like Typus in your application. You can mount multiple applications with ease and share code between applications. Routing is accomplished with Sinatra's wonderful HTTP verb declaration system instead of a router like in Rails. The feature I enjoy the most with Padrino involves its component agnosticism and generator abilities. Need mongo_mapper instead of ActiveRecord? Done. Want a project with less for CSS generation, haml for your views, jquery, and shoulda? It's easy. I encourage you all to check out Padrino and try it for yourself. If you're a fan of Sinatra, you'll likely enjoy what Padrino has to offer.

Deploying a Padrino Application

Deploying Padrino to Engine Yard AppCloud doesn't require any major changes to your deployment workflow. For example, I have a very simple CMS project called Fikus, which is a Padrino application using MongoDB for document storage. To deploy this to Engine Yard AppCloud, fork the main repository and make any local edits for configuration. You're going to need access to a MongoDB database. You can either use the unofficial chef recipe in the Engine Yard ey-cloud-recipes repository to spin up MongoDB on a utility instance, or you can use a third-party service such as Mongo Machine. The first step is to create your environment. On your Engine Yard AppCloud Dashboard, choose "Create New Environment", give it a name (I called mine fikus), and choose "Passenger" from the Web Server Stack list. You can choose "Show Advanced Options" if you wish to choose specific SSH keys to install, change your availability zone, or the name of the deployment user. Add a new application for the environment, and fill out the name and the git repository of your fork of Fikus. For the application type, choose Sinatra. Make sure to copy down the deploy key given to you and add it to your application's deploy keys on Github. This is necessary for your application to be deployed to your instances. Next you will be asked to specify the gems and UNIX packages for your application. By default it adds the sinatra gem, but you'll want to remove that and add bundler 1.0.0. You don't need to add the padrino gem as it is included in the project's Gemfile. There are no special UNIX packages to add for this application, so once you are done with the gems you can go to the Dashboard. The environment and application are in place, so now the only other piece is setting up your chef recipes for the application. Follow our HOWTO guide for using Chef to install the engineyard gem, fork the base recipe repository, and add your custom recipes. Fikus comes with a custom chef recipe already prepared in the fikus/chef directory. Copy that to your chef repository's cookbooks directory and customize as you see fit. Open up cookbooks/main/recipes/default.rb and make sure the following lines are in place:

require_recipe "mongodb"
require_recipe "fikus"

If you are using a third-party service for MongoDB such as Mongo Machine, you won't need the MongoDB recipe. Instead you can update cookbooks/fikus/templates/default/database.erb with the proper credentials. Commit your changes and push them to Github, then upload them using the ey command:

$ ey recipes upload -e fikus

Now you are ready to boot your instances! You can boot a single instance if you use a third-party MongoDB service, but if you choose to use the unofficial MongoDB recipes in the ey-cloud-recipes repository, you will need to boot up a utility instance named mongodb_master (I strongly discourage having MongoDB on the same instance as your application and/or MySQL). I set it up like this, using the "Custom" cluster option: Fikus Environment Setup

After a while the instances will boot, and then you can deploy the application, again using the ey command:

$ ey deploy -e fikus -r master -a fikus --no-migrate

Pass in the --no-migrate since we're using MongoDB and don't have the concept of migrations. They're not needed. However, if you are using ActiveRecord instead, you would need to use the command bundle exec padrino rake ar:migrate to migrate the database. The final step involved is to ssh into your instance and run the rake task to seed the database with the basic data needed for Fikus:

$ cd /data/fikus/current
$ bundle exec padrino rake seed

That sets up an initial site, admin user, and page for you to play with. Now you can hit your application at the /admin URI, log in with the credentials provided in the "rake seed" step above, and begin adding content to your site. Fikus currently allows you to serve up content for multiple sites, but other than that it is fairly basic. Pages are authored using Markdown, and there are a few options for page caching which are still works in progress. This is a fairly new project, so if you want to contribute, contact me on Github or just send a pull request. I hope this shows you how flexible the Engine Yard AppCloud can be for deploying non-Ruby on Rails applications.

Double Shot #660 »

Created at: 03.03.2010 14:20, source: A Fresh Cup, tagged: Double Shot nosql sinatra

Real viruses are as much of a nuisance to the work schedule as computer ones.

Getting Real about NoSQL and the SQL-Isn't-Scalable Lie - NoSQL has its uses, but as most people who've been around the block know, SQL is in fact scalable far beyond your puny needs.
Sinatra's Watched Repos - The Sinatra ecosystem has been growing quite a bit. Some time I need to dig in to this.
delorean - Gem to allow mocking Time.now in Ruby tests.
BlueGreenDeployment - How to manage continuous delivery without driving yourself nuts.

Double Shot #658 »

Created at: 01.03.2010 13:08, source: A Fresh Cup, tagged: Double Shot canable mongo rails ruby sinatra subversion

New months always hold so much promise.

Warehouse -"A Web-based subversion browser that doesn't suck."
Garbage Collection Slides from LA Ruby Conference - A good intro to a tough ruby topic, with pointers to some useful utilities.
Great CS Program for GIrls Needs Funding - Another good cause that could use some of your hard-earned dollars.
Using Sinatra to test remote services in Rails - Another testing idea from Elad Meidar.
Canable: The Flesh Eating Permission System - John Nunemaker's take on authorization. Looks fairly similar to the way I've been handling it recently.
rails_indexes - I think I mentioned this plugin for finding missing indexes before, but it came in handy this weekend so I'm mentioning it again.
Support Details - A way to quickly query a user's machine for things like OS, Browser, IP address, and color depth.
Migrations with Mongo (and MongoMapper) - Otherwise known as "mongrations".
Lesson from Madlibs Signup Fad: Do Your Own Tests - Amen.

Double Shot #644 »

Created at: 09.02.2010 13:10, source: A Fresh Cup, tagged: auto_timeout aws css devise haml mapreduce rails riak ruby savon sinatra textmate

There's certainly no shortage of goings-on to link to lately.

Devise 1.0.0 - Major milestone for this Rack-based authentication solution for Rails.
Cloudfront: no-brainer CDN Support for S3 - I've got a couple of apps out there where I really should implement this.
Save file and reload Safari from TextMate - Passed on by Alex Heaton.
Bye Bye Github and GitHub post - Afterthoughts - Elad Meidar discusses expectations and git hosting.
SendEmail 1.56 - Command line email sending that can handle TLS (and thus Google Mail servers). Requires some perl modules.
sinatra_more - Gem to boost Sinatra to handling more complex applications.
Auto timeout sessions in Rails - Useful plugin from Matthew Bass, for the times when you need to keep people from just idling. I ended up forking it to make it use jQuery instead of Prototype.
MR.Flow - Web-based designer for MapReduce operations.
EdgeRails.info - Ryan Daigle is moving all his edge content to a fresh domain.
RubyInstaller Release Candidate 2 - 1.8.6, 1.8.7 and 1.9.1 - Useful tool for people who want to run Ruby on Windows without resorting to a virtual machine.
Savon - Ruby SOAP client that includes WSSE authentication.
Wrap your SQL head around Riak's Map-Reduce - Personally my SQL head says "no! enough already!" but I expect I'll have to learn this stuff sooner or later.
Haml Sucks for Content - Actually a good post on some advanced HAML techniques rather than another entry in the holy war.
Less.app - Autocompiler for your LESS CSS files. Well, if you have any.

ипотпал
аквичоп

Links


Blogs: 43
Posts: 2516

bgror

Ruby on Rails Planet

Deploying Sinatra with Passenger »

Fikus: Deploying Padrino to Engine Yard AppCloud »