| Anthony Young | 6398787 | 2011-09-30 11:34:43 -0700 | [diff] [blame^] | 1 | Tool to quickly deploy openstack dev environments. |
| 2 | |
| 3 | # Goals |
| 4 | |
| 5 | * To quickly build dev openstack environments in clean natty environments |
| 6 | * To describe working configurations of openstack (which code branches work together? what do config files look like for those branches?) |
| 7 | * To make it easier for developers to dive into openstack so that they can productively contribute without having to understand every part of the system at once |
| 8 | * To make it easy to prototype cross-project features |
| Jesse Andrews | ba23cc7 | 2011-09-11 03:22:13 -0700 | [diff] [blame] | 9 | |
| Anthony Young | 0e65abf | 2011-09-30 09:24:00 -0700 | [diff] [blame] | 10 | Be sure to carefully read these scripts before you run them as they install software and may alter your networking configuration. |
| 11 | |
| 12 | # To start a dev cloud on your local machine (installing on a dedicated vm is safer!): |
| 13 | |
| 14 | ./stack.sh |
| 15 | |
| Anthony Young | 6398787 | 2011-09-30 11:34:43 -0700 | [diff] [blame^] | 16 | If working correctly, you should be able to access openstack endpoints, like: |
| 17 | |
| 18 | * Dashboard: http://myhost/ |
| 19 | * Keystone: http://myhost:5000/v2.0/ |
| 20 | |
| Anthony Young | 0e65abf | 2011-09-30 09:24:00 -0700 | [diff] [blame] | 21 | # To start a dev cloud in an lxc container: |
| 22 | |
| 23 | ./build_lxc.sh |
| 24 | |
| 25 | You will need to configure a bridge and network on your host machine (by default br0) before starting build_lxc.sh. A sample host-only network configuration can be found in lxc_network_hostonlyplusnat.sh. |
| 26 | |
| Anthony Young | 6398787 | 2011-09-30 11:34:43 -0700 | [diff] [blame^] | 27 | # Customizing |
| 28 | |
| 29 | You can tweak environment variables by creating file name 'localrc' should you need to override defaults. It is likely that you will need to do this to tweak your networking configuration should you need to access your cloud from a different host. |
| 30 | |
| Jesse Andrews | aec8fa4 | 2011-09-12 16:41:23 -0700 | [diff] [blame] | 31 | # Todo |
| Jesse Andrews | 2caf8fd | 2011-09-12 16:15:11 -0700 | [diff] [blame] | 32 | |
| Jesse Andrews | 2caf8fd | 2011-09-12 16:15:11 -0700 | [diff] [blame] | 33 | * Add python-novaclient cli support |
| Jesse Andrews | 710eeec | 2011-09-13 00:04:24 -0700 | [diff] [blame] | 34 | * syslog |
| Jesse Andrews | 710eeec | 2011-09-13 00:04:24 -0700 | [diff] [blame] | 35 | * allow rabbit connection to be specified via environment variables with sensible defaults |
| Jesse Andrews | 1c1d150 | 2011-09-12 19:29:56 -0700 | [diff] [blame] | 36 | * Add volume support |
| Jesse Andrews | 1c1d150 | 2011-09-12 19:29:56 -0700 | [diff] [blame] | 37 | * Add quantum support |
| Jesse Andrews | 1c1d150 | 2011-09-12 19:29:56 -0700 | [diff] [blame] | 38 | |
| Jesse Andrews | 2caf8fd | 2011-09-12 16:15:11 -0700 | [diff] [blame] | 39 | # Future |
| 40 | |
| Jesse Andrews | 04ab3ae | 2011-09-12 16:29:14 -0700 | [diff] [blame] | 41 | * idea: move from screen to tmux? |
| Jesse Andrews | ba23cc7 | 2011-09-11 03:22:13 -0700 | [diff] [blame] | 42 | * idea: create a live-cd / vmware preview image using this? |