descartes Omnibus project

This project creates full-stack platform-specific packages for descartes!

Installation

We'll assume you have Ruby 1.9+ and Bundler installed. First ensure all required gems are installed and ready to use:

$ bundle install --binstubs

Usage

Pre-build

You'll want to setup some secrets. See the installing file for details.

Build

You create a platform-specific package using the build project command:

$ bin/omnibus build project descartes

The platform/architecture type of the package created will match the platform where the build project command is invoked. So running this command on say a MacBook Pro will generate a Mac OS X specific package. After the build completes packages will be available in pkg/.

Clean

You can clean up all temporary files generated during the build process with the clean command:

$ bin/omnibus clean

Adding the --purge purge option removes ALL files generated during the build including the project install directory (/opt/descartes) and the package cache directory (/var/cache/omnibus/pkg):

$ bin/omnibus clean --purge

Help

Full help for the Omnibus command line interface can be accessed with the help command:

$ bin/omnibus help

Vagrant-based Virtualized Build Lab

We're shipping this projects with a project-specific Berksfile and Vagrantfile that will allow you to build on:

• Ubuntu 12.04 64-bit

Currently this is the only platform that we've tested on.

See the Vagrantfile to add new platforms to your build lab, but note that the chef recipes would need additional testing on anything other than the specified platform.

The only requirements for standing up this virtualized build lab are:

• VirtualBox - native packages exist for most platforms and can be downloaded from the VirtualBox downloads page.
• Vagrant 1.2.1+ - native packages exist for most platforms and can be downloaded from the Vagrant downloads page.

The vagrant-berkshelf and vagrant-omnibus Vagrant plugins are also required and can be installed easily with the following commands:

$ vagrant plugin install vagrant-berkshelf
$ vagrant plugin install vagrant-omnibus

Once the pre-requisites are installed you can build your package across all platforms with the following command:

$ vagrant up

If you would like to build a package for a single platform the command looks like this:

$ vagrant up PLATFORM

The complete list of valid platform names can be viewed with the vagrant status command.

Information about the built package

See the installing instructions.