Browse files

Initial commit

  • Loading branch information...
0 parents commit 34ee3f2f61c6983e0294821c16b1b4db89b4c1ad Joshua Harlow committed Sep 11, 2012
@@ -0,0 +1,69 @@
+*OpenStack Imaging Hot Sauce*
+---- Description
+Modular image builder from imaging awesomness.
+---- Default modules
+1. add_user (adds a given set of sudo users)
+2. install_rpms (installs a list of rpm packages)
+3. Your imagination...
+---- Examples
+$ sudo python ./ -s 4G
+To add users make a yaml like the following:
+$ cat build.yaml
+# Which modules should be ran (in order)
+ - install-rpms
+ - add_user
+# Enable this if you wish to install
+# any users info into the image (ie for testing).
+ - harlowja
+Then run:
+$ sudo python ./ -s 4G -o blah.tar.gz -x
+---- Adding your own module
+To add your own module create a file in the `modules` folder with a function
+of the following format:
+def modify(name, root, cfg):
+The name that is passed in will be the module name (from configuration) with
+the root variable being the root directory of the mounted image (useful for chroot)
+or other file alterations and the cfg variable will be the build configuration
+dictionary (useful for extracting any module configuration specifics)
+Then save this file with a given name, ie, and then to get this module
+to be activated add it to the modules list in the build.yaml with the name
+xyz and then go ahead and build your image. If this module errors out the image
+will not be successfully built so use this method to stop image building (ie
+by throwing exceptions)
+---- Using your image
+To upload this image, take the upload-img tool in anvil and provide it the url
+of your file, for example given a archive at /homes/harlowja/blah.tar.gz
+you would upload this via the following command.
+$ python tools/ -u file://///homes/harlowja/blah.tar.gz
+Then the upload-img tool will go through the nitty gritty of extracting that
+image and connecting the pieces together to form a useable image in openstack.
+The image produced should also be easily useable in amazon (if someone ever
+gets around to trying that).
@@ -0,0 +1,11 @@
+# Used for yaml reading
+# Used for nice pretty coloring
+# Used for progress bar prettyness
+# Used for filling in a libvirt xml sample file
Oops, something went wrong.

0 comments on commit 34ee3f2

Please sign in to comment.