blob: 8b2b038418b99b2061a1cb0bd998093f30a6f143 [file] [log] [blame] [view]
Anthony Young63987872011-09-30 11:34:43 -07001Tool to quickly deploy openstack dev environments.
2
3# Goals
4
Jesse Andrews38df1222011-11-20 09:55:44 -08005* To quickly build dev openstack environments in clean oneiric environments
Anthony Young63987872011-09-30 11:34:43 -07006* 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 Andrewsba23cc72011-09-11 03:22:13 -07009
Jesse Andrewsb69d6ce2011-10-13 10:36:00 -070010Read more at http://devstack.org (built from the gh-pages branch)
11
Anthony Young0e65abf2011-09-30 09:24:00 -070012Be sure to carefully read these scripts before you run them as they install software and may alter your networking configuration.
13
14# To start a dev cloud on your local machine (installing on a dedicated vm is safer!):
15
16 ./stack.sh
17
Anthony Young63987872011-09-30 11:34:43 -070018If working correctly, you should be able to access openstack endpoints, like:
19
Tres Henryca85b792011-10-28 14:00:21 -070020* Horizon: http://myhost/
Anthony Young63987872011-09-30 11:34:43 -070021* Keystone: http://myhost:5000/v2.0/
22
Anthony Young63987872011-09-30 11:34:43 -070023# Customizing
24
25You 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.
26
Jesse Andrewsaec8fa42011-09-12 16:41:23 -070027# Todo
Jesse Andrews2caf8fd2011-09-12 16:15:11 -070028
Jesse Andrews2caf8fd2011-09-12 16:15:11 -070029* Add python-novaclient cli support
Jesse Andrews710eeec2011-09-13 00:04:24 -070030* syslog
Jesse Andrews1c1d1502011-09-12 19:29:56 -070031* Add volume support
Jesse Andrews1c1d1502011-09-12 19:29:56 -070032* Add quantum support
Jesse Andrews1c1d1502011-09-12 19:29:56 -070033
Jesse Andrews2caf8fd2011-09-12 16:15:11 -070034# Future
35
Jesse Andrews04ab3ae2011-09-12 16:29:14 -070036* idea: move from screen to tmux?
Jesse Andrewsba23cc72011-09-11 03:22:13 -070037* idea: create a live-cd / vmware preview image using this?