65 lines
1.8 KiB
ReStructuredText
65 lines
1.8 KiB
ReStructuredText
==============================
|
|
Vagrant support for developers
|
|
==============================
|
|
|
|
Bifrost vagrant file for developers can be found in the
|
|
``tools/vagrant_dev_env`` directory. Running ``vagrant up`` from
|
|
within this folder will bring up an Ubuntu Trusty box with Bifrost
|
|
installed.
|
|
|
|
By default, the VM will have three interfaces:
|
|
|
|
- **eth0** - connected to a NAT network
|
|
- **eth1** - connected to Host-only network named: vboxnet1
|
|
- **eth2** - bridged - adapter must be set in Vagrantfile
|
|
|
|
-------------------------
|
|
Walkthrough done on OS X
|
|
-------------------------
|
|
Setup vagrant by:
|
|
|
|
- Installing git
|
|
- Installing virtualbox
|
|
- Installing vagrant
|
|
- Installing ansible
|
|
|
|
Configure Vagrant with the correct box::
|
|
|
|
vagrant box add ubuntu/trusty64
|
|
|
|
Clone bifrost repo::
|
|
|
|
git clone https://github.com/openstack/bifrost.git
|
|
|
|
Change into the bifrost directory::
|
|
|
|
cd bifrost/tools/vagrant_dev_env
|
|
|
|
Edit the Vagrantfile:
|
|
|
|
- Change the ``bifrost.vm.network`` ``public_network`` value to a
|
|
valid network interface to allow Bare Metal connectivity
|
|
- Change ``public_key`` to correct key name
|
|
- Change ``network_interface`` to match your needs
|
|
|
|
|
|
Boot the VM with::
|
|
|
|
vagrant up
|
|
|
|
--------------------
|
|
Installation Options
|
|
--------------------
|
|
Ansible is installed within the VM directly from `source
|
|
<https://github.com/ansible/ansible.git>`_ or from the path set by
|
|
``ANSIBLE_GIT_URL``. You can modify the path of installation by setting
|
|
``ANSIBLE_INSTALL_ROOT`` environment variable. The default value is
|
|
``/opt/stack``. When set in the host, this variable will also be set as an
|
|
environment variable inside the VM for use by test scripts.
|
|
|
|
Note:
|
|
|
|
Only the ansible installation path is configurable at this point using
|
|
the environment variable. All other dependencies will still continue to
|
|
cloned under ``/opt/stack``.
|