07687f4401
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
51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
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](atlas.hashicorp.com).
|
|
|
|
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
|