Matthias "Netsensei" Vandermaesen
matthias@colada.be
http://www.colada.be
Rum is a set of Drush scripts that makes a Drupal developers' life easier. It allows you to quickly set up and tear down Drupal websites with as few commands as possible. Rum takes away the pain of tediously managing virtual hosts, databases,...
The aim is to keep your development setup as clean as a whistle and allowing you to set up a new Drupal site quickly.
Although a myriad of general solutions already exists, the idea behind Rum is to do one thing only: quickly setting up and tearing down Drupal websites.
Rum is also a learning experience. I wanted to learn more about Drush and I wanted to really dive into OOP and design patterns.
WARNING: INSTALL AT YOUR OWN RISK! THIS IS STILL AN UNFINISHED PROJECT. Rum will interact (add/remove) with your installation, so things might break severely.
Clone the stable release of Rum in your .drush folder:
cd .drush
git clone -b 1.x git://github.com/netsensei/Rum.gitOn Mac OS X, you'll find your .drush folder at /Users/username/
Open up your command line tool and run
drush help | grep rumIf Drush doesn't pick up the Rum commands, clear your Drush cache.
drush cache-clear drushMore information about the drushrc file can be found in the example.drushrc.php file.
Install a vanilla Drupal project called foobar
drush rc vanilla foobarInstall a project Foobar from a CVS repository (local or remote)
drush rc repository foobarBoth commands will create a domain name called hostname.foobar. Rum will talk you through the installation and provide a URL once the process is completed. With a vanilla flavored Rum install, you may need to manually finish the installation in the browser.
Note: when using a Subversion repository you may want to checkout the just the trunk and not the entire repo. For instance, if you have a repository at http://my.subversion-server.com/awesome-repo, you should give the following URL:
http://my.subversion-server.com/awseom-repo/trunkThis way you'll check any folders in the root of your repository instead of the trunk folder which will not comply with the way Rum expects your repo to be setup.
A complete walkthrough for a (GIT) repository based Drupal 7 installation using Rum is available in the Rum Repo Example README.
Remove a project (vhost, folders, link, database,...):
drush rd foobarA complete walkthrough for removing a Rum based installation using Rum is available in the Rum Repo Example README.
There is a whole range of ways to configure a L/MAMP stack. Some prefer to put their document roots in /var/www, others link to a different directory. Same goes for managing database dumps, vhost configurations,...
Rum isn't designed to cater in a flexible way with different setups. The primary goal is to go for a few setups and get things up quick and simple.
Rum will create a workspace directory. All your projects will be stored in this directory. Each project resides in its own project directory
Each project directory ideally has these two directories: a web directory (i.e. www) and a database directory (i.e. db) The first will act as a document root to your vhost configuration, the second contains all your database dumps.
For each virtual host, Rum will create a separate file in the vhost configuration directory.
For each project, Rum will create a single database and generate a settings file which will connect it to the project.
It's possible to change the defaults in your .drushrc.php configuration and or pass specific changes as options from the command line. Refer to this command for more information:
drush rc helpIssues are tracked in the GitHub issue tracker for Rum.
Rum relies on the Drush API. There are few things on the wishlist
These people helped tremendously in making Rum better.
Jim Faes
jimfaes@gmail.com
Jurgen "Sjugge" Verhasselt
sjugge@heretiksambrosia.net
http://heretiksambrosia.net