openstack/kuryr
Code Issues Proposed changes
831b49a94c
kuryr/contrib/vagrant
History
Jaume Devesa 07687f4401 Make ./stack.sh optional 
Create a new VAGRANT_KURYR_RUN_DEVSTACK environment variable to make the
`stack.sh` call optional.

Some people may want to edit the `local.conf` file before run `stack.sh`
manually in the VM. Useful for the devstack/plugin.sh development, for
instance.

It is defaulted to `true` for backwards compatibility.

Change-Id: Ia3fe8cb4416a75a3ec05cbb9ce698313daa555e4
2015-12-21 17:55:42 +01:00
..
config Integrate devstack plugin with Vagrant setup 2015-11-25 09:57:28 -06:00
devstack.sh Make ./stack.sh optional 2015-12-21 17:55:42 +01:00
README.md Make ./stack.sh optional 2015-12-21 17:55:42 +01:00
vagrant.sh Make ./stack.sh optional 2015-12-21 17:55:42 +01:00
Vagrantfile Make ./stack.sh optional 2015-12-21 17:55:42 +01:00

README.md

vagrant-devstack-Kuryr

Getting started

A Vagrant based kuryr,neutron,keystone and experimental docker system.

Steps to try vagrant image:

  1. Install Vagrant on your local machine. Install one of the current providers supported: VirtualBox, Libvirt or Vagrant

  2. Git clone Kuryr repository.

  3. Run cd kuryr/contrib/vagrant

  4. Run vagrant up It will take around 10 mins.

  5. vagrant ssh You will get vm shell with keystone and neutron already running.

  6. Run cd kuryr && ./scripts/run_kuryr.sh & Kuryr service will be up and listening on port 2377.

  7. Create the default Kuryr subnetpool:

    neutron subnetpool-create --default-prefixlen 24 --pool-prefix 10.10.0.0/16 kuryr

At this point you should have experimental docker, kuryr, neutron, keystone all up, running and pointing to each other. Any docker network related commands can be tried now as explained in [1].

References:

[1] https://github.com/openstack/kuryr/blob/master/doc/source/devref/libnetwork_remote_driver_design.rst#L64

Vagrant Options available

You can set the following environment variables before running vagrant up to modify the definition of the Virtual Machine spawned:

  • VAGRANT_KURYR_VM_BOX: To change the Vagrant Box used. Should be available in atlas.

    export VAGRANT_KURYR_VM_BOX=centos/7

    Could be an example of a rpm-based option.

  • VAGRANT_KURYR_VM_MEMORY: To modify the RAM of the VM. Defaulted to: 4096

  • VAGRANT_KURYR_VM_CPU: To modify the cpus of the VM. Defaulted to: 2

  • VAGRANT_KURYR_RUN_DEVSTACK: Whether vagrant up should run devstack to have an environment ready to use. Set it to 'false' if you want to edit local.conf before run ./stack.sh manually in the VM. Defaulted to: true