Bundler groups¶

First of all, if you installed foreman via a package (rpm, deb) you should not care much about bundler and bundler groups, however feel free to stick around.

Since foreman upgraded to rails 3.x, we also moved to using Bunder.

In order not to force all users to install all possible library stacks (e.g. if you don't care about provisioning, you don't really need the code which handles EC2), we've have broken down the gem list into groups.

How to exclude groups from bundler¶

bundle install --without group1 group2 group3

you can also review/edit .bundle/config file instead.

the current groups break down more or less into to main categories:

Database¶

we currently support sqlite, mysql and postgres* databases, and since you only need one of those, you need to tell bundler not to install all of the rest

So assuming you want to use postgres, simply run:

bundle install --without sqlite mysql mysql2 ...

MySQL¶

Rails supports two different 'drivers' to communicate with a MySQL server (or servers), mysql gem normally works, but people had great results with mysql2 and it seems to be more maintained these days.

Compute Resource related groups¶

EC2¶

requires the fog group

oVirt / Libvirt¶

requires the fog and ovirt groups

Libvirt¶

requires the fog and libvirt groups

VMWare¶

requires the fog and vmware groups

Development / Test groups¶

requires test and development groups.

note that if you are using the rails console, its also recommended to use the console group for better text formatting / helpers etc.