Instant live openstack

Instant live openstack with vagrant, ansible and devstack.

Vagrant Ansible Devstack

Quick Start

This project provides a simple way to build an instant openstack developing environment through devstack.

You should have the following installed:

• VirtualBox
• Vagrant 1.2.x: see here for how to install vagrant.
• Ansible: you can get ansible through pip install ansible.

Then you should have a vagrant base box, I recommend precise64:

vagrant box add precise64 --provider virtualbox http://files.vagrantup.com/precise64.box

Commercial Time: I myself use a vagrant hackerbox, which provides a really comfortable working environment.

vagrant box add hackerbox_precise64 --provider virtualbox https://dl.dropboxusercontent.com/s/uzuc3h5p7tysin2/hackerbox_precise64.box?token_hash=AAGdDLje6YhQOhwXbUqLkh9nAfxQd_TUnnCiJKkZJynVsA&dl=1

After all the prerequisities met, you can boot an instant openstack developing environment:

git clone https://github.com/xiaohanyu/vagrant-ansible-devstack.git

cd vagrant-ansible-devstack

vagrant up

Note that, there may be some errors due to network, pip/apt mirror, devstack bugs, be patient, please. If you’re a lazy guy. I’ve already built a devstack box for you. Just download the box from here, add it to your vagrant box list:

vagrant box add devstack devstack-20121028.box

Modify some parameters in your Vagrantfile, ensure that you have 192.168.27.100 as the private network ip for your box. Then

$ vagrant up --no-provision

Bringing machine 'default' up with 'virtualbox' provider...

[default] Clearing any previously set forwarded ports...

[default] Fixed port collision for 22 => 2222. Now on port 2200.

[default] Creating shared folders metadata...

[default] Clearing any previously set network interfaces...

[default] Preparing network interfaces based on configuration...

[default] Forwarding ports...

[default] -- 22 => 2200 (adapter 1)

[default] Running 'pre-boot' VM customizations...

[default] Booting VM...

[default] Waiting for machine to boot. This may take a few minutes...

[default] Machine booted and ready!

[default] Configuring and enabling network interfaces...

[default] Mounting shared folders...

[default] -- /vagrant

$ vagrant ssh

Welcome to Ubuntu 12.04 LTS (GNU/Linux 3.2.0-23-generic x86_64)

 * Documentation:  https://help.ubuntu.com/

Welcome to your Vagrant-built virtual machine.

Last login: Fri Nov 22 09:22:37 2013 from 10.0.2.2

vagrant@precise64:~$ cd devstack/

vagrant@precise64:~/devstack$ ./rejoin-stack.sh

If you want to make cinder work in your local box, you need to add an extra virtualbox disk, and then issue some LVM commands like this:

sudo pvcreate /dev/sdb

sudo vgcreate stack-volumes /dev/sdb

Internally, this box contains code from openstack master branch till date Oct 28 2013. You may need do some git pull origin master to update your code. For simplicity, this box set up dev environment based on localrc.basic, which means it doesn’t contain OpenStack heat, ceilometer, and neutron.

Internals

You can set some basic options in devstack.yml, such as:

• Which openstack branch you want to clone? master or stable/grizzly?
• Where you can get the openstack code? Through github or you company’s internal github mirror?
• Do you want do git pull the code each time you redo stack.sh?

Personally, I recommend you use a stable/xxx branch for the first time, since the master branch may have some really weird bugs, which may make you disgusting.

This project also provide two devstack localrc template:

• localrc.basic enable basic openstack service, including nova, cinder, glance, keystone and horizon, requires at least 1GB RAM.
• localrc.full beyond basic openstack service, enable quantum, heat, ceilometer, you’d better give the vm 2GB RAM.

I recommend you use localrc.basic as the starting point.

You can also do something else through a dowhatyoulike.sh hook, such as:

• change the default apt source.list to boost you apt-get
• change default devstack options, etc.

Bonus Tips

• Use virtualbox snapshot if possible to keep a clean, working environment.
• Use rejoin-stack.sh to restart openstack service instead of stack.sh.

For Chinese Users

Chinese user have a really difficult environment to do openstack development due to the poor network and the fucking Great Fire Wall. So I built a openstack git mirror:

• http://git.oschina.net/openstack
• http://git.oschina.net/openstack-dev

Hope it helps. And another weird problem is pip, which often ends with a Connection Timeout error during devstack stack.sh. My workaround here:

• Use http://e.pypi.python.org/ as the pip index-url.
• Provide an already downloaded pip cache, yes, you can do this by using vagrant synced folder strategy, see https://github.com/xiaohanyu/vagrant-ansible-devstack/blob/local_xhy_test/Vagrantfile for details.

References

• https://github.com/lorin/devstack-vm
• https://github.com/dizz/vagrant-devstack
• https://github.com/bcwaldon/vagrant_devstack

from https://github.com/xiaohanyu/vagrant-ansible-devstack
------

https://opendev.org/explore/repos
https://opendev.org/openstack/neutron