Salesforce on Rails - Ruby

Accessing Passenger sites from a Windows Vista instance in VMware Fusion

2009-02-12T05:32:00Z

This article by Robby Russell reminded me of a hopefully helpful post I’ve been meaning to write for a while. The problem is straightforward: You’ve got Phusion Passenger set up on your Mac OS X Leopard (see Robby’s post for details). Your client called, and they say the site you just launched for them looks funky in Internet Explorer. Fun. So now, you want to access your local Passenger site living at http://myapp.local from the copy of Windows Vista living in your VMware Fusion.

There are two things you need to do in order to access your Passenger sites from Windows Vista via VMware Fusion:

Figure out what Vista thinks is your Mac’s IP address
Create entries in Vista’s /etc/hosts file (yes, Vista actually has one)

So fire up VMware and Vista, and let’s begin:

Determine Vista’s Gateway IP

When running VMware Fusion, the virtualized OS (in our case Vista) refers to the host system (Mac OS X Leopard) as its IP Gateway and its DNS. So you want to figure out what that IP address is, and you’ll be able to access the Apache server running in Leopard. Determine the IP with the following steps:

Open the Control Panel, switch to Classic View, open Network and Sharing Center.
Click on Manage Network Connections in the sidebar.
Double click on the Local Area Connection, and click on the Details button.
Make note of the IPv4 Default Gateway – that’s your ticket to accessing your Passenger sites.

Edit Vista’s /etc/hosts file

I discovered this handy link, which tells you all you want to know about Vista’s hosts file. In short, it works pretty much the same as any Unix /etc/hosts file. I followed the instructions to set up a shortcut on my Vista Desktop for quick access, and the screenshot of the Properties dialog for that shortcut is below:

Now, just edit the file, creating an entry for each Passenger site:

172.16.160.2 site1.local
172.16.160.2 site2.local
172.16.160.2 site3.local

With the file saved, you should be able to access your Passenger sites from a browser in Vista (no restart of anything needed).

Multiple IEs

Now for a bit of a bonus, I highly recommend installing IETester in Vista. IE8 beta 2, IE7, IE6 and IE5.5 will be at your fingertips.

Find this helpful? Please consider recommending me on Working with Rails.

Announcing Merb Day Atlanta

2008-10-28T00:20:00Z

It’s been a while since I last posted here (four months to be exact), but I wanted to share the news on a conference I’ve been organizing, Merb Day Atlanta.

Registration has finally opened (much to my relief), and it should be a great event for Ruby developers looking to dive into the next great thing. Registration is a mere $65, and you’ll be learning from the best: Merb Day Atlanta.

I don’t really do much Salesforce work these days, and doubt I will in the future, so I have an idea for a new blog. Less about specific technologies, more about the craftsmanship of software development. Stay tuned…

Engine Yard Express: A Production Slice on Your MacBook Pro

2008-06-20T04:31:00Z

While computing moves more and more to the cloud, it’s interesting that Ruby web development best practices tend to go in the opposite direction, toward the workstation right in front of you. Running a local web server via ‘script/server’ (or my preferred method of ‘thin start’), hosting gem documentation locally, and using local git branches are all win/win practices because they’re far more efficient, and frankly, let you do some bonehead moves without your co-workers ever having to know.

So maybe deployments should be practiced locally as well. Ezra Z. has announced Engine Yard Express, a VMware image that’s essentially an Engine Yard production slice. The idea is that you run the image via virtualization software on your workstation, so that you can get all the benefits of a virtual server without having to actually connect to one through the Tubes.

Yes, this really rocks. You’ll be able practice deployments on the plane!

So first, you’ll need to buy VMware Fusion for your Mac. I first purchased Parallels over a year ago, but VMware clearly kicks its ass. Clearly. It actually runs Windows without making the rest of your system unusable.

Next, download the image and double-click on it. Before you even realize what happened, you’ll be presented with a ready, fully-functional slice just waiting for you like an obedient dog:

You’ve been pleasantly provided with randomly generated passwords for the root and express users, and you’re even given the IP address it’s chosen.

Let’s create an alias for that address so we don’t have to memorize it. Open up /etc/hosts in your favorite text editor (requires sudo permission) and stick something like this in there:

192.168.233.128 express.local

Now, you should probably just leave your VMware window alone. Instead you’ll want to SSH into the slice as if you were logging into a remote server:

$ ssh express@express.local

Nice! A quick visit to http://express.local:81 gives you your Merb start page.

Now, in your Capistrano scripts, you can use ‘express.local’ as the domain of your servers, and you’ll be able to practice deployments without ever connecting to a remote server. Bom chicka wa waa!

Running a local gem documentation server on Mac OS X

2008-06-11T03:49:00Z

When I first started playing around with Ruby on Rails, one of the things that struck me was how development was done completely locally. Instead of uploading or synchronizing your source code to a remote web server, you simply fired up a Ruby web server process on your local machine, and the development process seemed to flow more smoothly.

In that same vein, documentation for Ruby gems can be annoying to hunt down. You have to go to the gem’s web site, and hope that RDoc exists somewhere. Or, you can navigate to your gem’s local install directory and poke around in there. Too much work, and it could break your flow. Not anymore:

$ gem server

Now, just visit http://localhost:8808, and you’re good to go. That easy!

Also, you may find yourself missing RDoc on updated gems, so make sure to do this when it bothers you:

$ sudo gem rdoc [--all|gem_name]

Now, it would be great if the server just started automatically on boot up, with no need for a command line directive. In Mac OS X Leopard, the preferred way is to use launchd/launchctl, which is about as obvious to the uninitiated as the rules of Cricket. Luckily, there’s Lingon, which wraps all that ugly XML in a nice GUI. Make a new entry that looks like this:

Note the full path to the gem command, which I needed for the launch command to work. And that’s it. Full documentation to all your locally installed gems, available whenever you need them.

Special thanks to Daniel Fischer for the ‘gem server’ tip, and Brandon Beacher for the tip on Lingon.

Opening Gems in Textmate

2008-04-12T14:10:00Z

Here’s a problem: you need to look at a gem’s source code to figure out something, but you need to figure out the path to your gems directory, find the gem in question, and then open it from there. What a pain. Luckily, Dr. Nic has saved the day:

$ sudo gem install find_gem
$ find_gem activerecord

This also comes with the wonderful command ‘edit_gem’. Make sure you have your environment EDITOR variable set in your .bash_login|.bash_profile|.bashrc:

export EDITOR="mate"

Save the file and source it:

$ source .bash_login (or .bash_profile or .bashrc)

Now, “edit_gem activerecord” does what you think it should do. Nice little pieces of functionality like these really make the term “gem” so appropriate. Hat-tip to Graham Ashton for sparking my interest to find a solution.

Presentation on Thin

2008-04-09T18:38:00Z

Tonight, I’ll be doing a Lightning Talk for the Atlanta Ruby Users Group on Thin, a Ruby web server. Below are my slides, accompanied by several resources:

| View | Upload your own

Thin is in!

Rails Scales

2008-03-29T00:30:00Z

Over on the High Scalability Blog, a writeup on top 10 Facebook App Friends for Sale details that two full-time Rails developers and one full-time DBA have, in three months, built an application that serves 200 requests per second. Yowsers.

Much of the criticism of Ruby/Rails performance woes will simply go away this year, what with Ruby 1.9, JRuby, it’s companion Glassfish, and Thin popping up. Also, Merb, a framework by Rails deployment genius Ezra Z., will likely inspire some performance enhancements to Rails itself.

I’ve always thought that not adopting a development framework just because it doesn’t scale is rather odd. Humans tend to always hold out that irrational hope that yes, some day they’ll be like those famous people on top, even though they’re completely screwing themselves in the present.

Welcome to the Jungle

2008-03-27T03:28:00Z

Well, lucky you! You’ve stumbled upon this weird, strange corner of the Tubes. A place where the idealism of an elegant open source project meets the stone-cold reality of delivering quality software within tight deadlines to those who line your pockets. No, this is not just another Rails blog. This is a blog about building web software really fast, under ridiculous constraints, with a multitude of crap hurled your way, and finding joy in it. I don’t profess to have found that joy yet, but hopefully, in what should be a long, fulfilling journey, you and I, my dear reader, will. And I won’t ever use that many commas in a single sentence again. Promise.

Luckily, we have some excellent tools at our disposal. You’ve heard of Ruby on Rails, the high-flying web framework that everyone’s been writing about since 2005. It’s got that guy DHH who drops the F-bomb a lot and has a funny Danish accent.

The hippest nerds flock to it, because it’s a damn good way to built web applications. Ruby is, hands down, the nicest language to code in. Rails (and now Merb), were designed from the ground up to make the lives of web developers better. To make us happier. That’s an amazingly progressive goal, hippy-ish really, and it would have been laughed at by those IBM engineers of yore who wore thick-rimmed glasses out of utility and not out of fashion. But I’ll be damned if I ever code in PHP or Java again.

You may have heard of Salesforce.com, the enterprise CRM system used by Fortune 500s to Mom and Pop shops to everyone in between. In the past few years (as Rails has been gaining in popularity), Salesforce has become more than just a CRM (customer relationship management). Dubbed Force.com, it’s become a nearly full-blown web application framework, but not in the same sense as Rails. Using Rails, we build web applications by firing up a text editor and coding in Ruby, HTML, CSS, and some Javascript. Using Force.com, we don’t build applications as much as customize the hell out of an existing one. Much is already built for us, but we then need to use a gaggle of technologies to tweak it just right to fit with our users’ needs.

Ruby on Rails and Force.com have a lot of differences. Rails is open-source, licensed under the MIT License. It’s free as in beer and free as in speech. Force.com is completely proprietary. Your users will have to subscribe in a per seat/per month arrangement. You host (or pay to someone to host) your own Rails apps, while Force.com apps are completely managed by Salesforce.com (the company). Philosophically, Force.com is a true enterprise framework, while the Rails Core team could care less about making it enterprise (and with good reason).

But the two have one striking similarity: they both help web developers build solid applications in ridiculous time. And let me make a bold claim: Force.com completely destroys Rails in development time. It’s not even close. A tool that takes me a day to build using Force.com would take at least a week (and probably two) if I were to use Rails.

I’ll let that sit with you, as I’ve said enough for now. In the coming days and weeks, I’ll be evaluating the pros and cons of each web framework, and sharing what I learn along the way. Neither is perfect, but both are pretty great. While there are many great Rails blogs out there, there is (to my knowledge), only one regularly updated Salesforce development blog, with another newer one. So, I hope to help fill that void. If this all tickles your pickle, consider subscribing to the feed.