e82baba8d0
Add a Vagrant configuration for Astara. This makes it easy for someone to pull the openstack/astara repository and get up and running with an Astara setup quickly. Change-Id: I600328c2a53a8d4aff5bf39a96aaa5b79ef99464 Signed-off-by: Kyle Mestery <mestery@mestery.com> |
||
---|---|---|
.. | ||
devstack.sh | ||
README.md | ||
vagrant.sh | ||
Vagrantfile |
vagrant-devstack-astara
Getting started
A Vagrant based astara.
Steps to try vagrant image:
- Install Vagrant on your local machine. Install one of the current providers supported: VirtualBox, Libvirt or Vagrant
- Git clone the astara repository.
- Run
cd vagrant
- Run
vagrant up
It will take from 10 to 60 minutes, depending on your internet speed. Vagrant-cachier can speed up the process [1]. vagrant ssh
You will get a VM with everything running. You will get vm shell with keystone and neutron already running.
At this point you should have astara running inside of the Vagrant VM.
[1] http://fgrehm.viewdocs.io/vagrant-cachier/
Vagrant Options available
You can set the following environment variables before running vagrant up
to modify
the definition of the Virtual Machine spawned:
-
VAGRANT_ASTARA_VM_BOX: To change the Vagrant Box used. Should be available in atlas.
export VAGRANT_ASTARA_VM_BOX=centos/7
Could be an example of a rpm-based option.
-
VAGRANT_ASTARA_VM_MEMORY: To modify the RAM of the VM. Defaulted to: 4096
-
VAGRANT_ASTARA_VM_CPU: To modify the cpus of the VM. Defaulted to: 2
-
VAGRANT_ASTARA_RUN_DEVSTACK: Whether
vagrant up
should run devstack to have an environment ready to use. Set it to 'false' if you want to editlocal.conf
before run ./stack.sh manually in the VM. Defaulted to: true. See below for additional options for editing local.conf.
Additional devstack configuration
To add additional configuration to local.conf before the VM is provisioned, you can create a file called "user_local.conf" in the vagrant directory of astara. This file will be appended to the "local.conf" created during the Vagrant provisioning.
For example, to use OVN as the Neutron plugin with Astara, you can create a "user_local.conf" with the following configuration:
enable_plugin networking-ovn http://git.openstack.org/openstack/networking-ovn
enable_service ovn-northd
enable_service ovn-controller
disable_service q-agt
disable_service q-l3