Integration with OpenStack


The OpenStack integration for dynamic system provisioning is classified as experimental. It has a number of limitations and may impact the scheduler’s performance, therefore it is currently not recommended for use in production on large Beaker instances.

Beaker can optionally be configured to use OpenStack to create virtual machines on demand for running recipes.

When OpenStack integration is enabled, Beaker will attempt to create a new virtual machine for each recipe when it is scheduled. If creating the virtual machine fails, Beaker will fall back to using the regular hardware pool for that recipe. Recipes with hardware requirements in <hostRequires/> which cannot be satisfied by a virtual machine are excluded from this process.

Package prerequisites

  • python-keystoneclient >= 0.11.0
  • python-novaclient >= 2.20.0
  • python-glanceclient >= 0.15.0
  • python-neutronclient >= 2.3.9

As RHEL 6 may not provide the required version of those packages, you can use Juno EL6 repositories provided by CentOS in this case. See JunoEL6QuickStart for more details.

Configuring OpenStack integration

To enable OpenStack integration, configure the Identity API (Keystone) endpoint, dashboard (Horizon) URL and an OpenStack account of Beaker in /etc/beaker/server.cfg:

# Use OpenStack for running recipes on dynamically created guests.
openstack.identity_api_url = ''
openstack.dashboard_url = ''
# Credentials of the OpenStack account of Beaker for authorization-based on
# OpenStack identity trusts. Beaker uses the trust delegated by users to authenticate
# to OpenStack when creating OpenStack instances on behalf of users.
openstack.username = ""
openstack.password = ""

Currently Beaker does not support multiple OpenStack regions. Beaker expects a single row to exist in the openstack_region table, referencing the lab controller which should be used for OpenStack recipes. You must insert the row manually:

INSERT INTO openstack_region (lab_controller_id)
SELECT id FROM lab_controller WHERE fqdn = '';

Uploading iPXE image to Glance

In order to boot distro installers on OpenStack instances, Beaker relies on a special image containing the iPXE network boot loader, which then loads its boot configuration from the Beaker server. The beaker-create-ipxe-image tool creates and uploads a suitable image to Glance. You must run this tool once after defining an OpenStack region.

The name for each virtual machine is constructed from the guest_name_prefix setting (see Configuration) combined with the recipe ID. If you have configured multiple Beaker instances to use the same OpenStack instance, make sure you set a distinct value for guest_name_prefix to avoid name collisions.