diff --git a/doc/install/diskimage-builder.rst b/doc/install/diskimage-builder.rst new file mode 100644 index 00000000..1963cb09 --- /dev/null +++ b/doc/install/diskimage-builder.rst @@ -0,0 +1,113 @@ +Diskimage Builder +================= + +Building Libra Images using Diskimage Builder. + + +Setup the builder - Manual way +----------------- + +1. Set DIB path + +:: + + $ echo 'export DIB_PATH=$HOME/diskimage-builder' >> ~/.bashrc + +2. Clone the repository "git://github.com:openstack/diskimage-builder" locally. + +:: + + $ git clone git://github.com:openstack/diskimage-builder $DIB_PATH + +3. Add DIB bin to PATH and DIB directory to your directory to your env. + +:: + + $ echo 'export PATH=$PATH:$DIB_PATH/bin' >> ~/.bashrc + $ . ~/.bashrc + + +4. Setup some variables + +:: + + $ echo 'export LIBRA_ELEMENTS=$HOME/libra-elements' >> ~/.bashrc + $ . ~/.bashrc + +5. Clone the 'libra-elements' repository + +:: + + $ git clone git://github.com/LBaaS/libra-elements $LIBRA_ELEMENTS + + +6. Export the following variable to your .bashrc. Then source it. + +:: + + $ export ELEMENTS_PATH=$DIB_PATH/elements:$LIBRA_ELEMENTS/elements + +Setup DIB using bootstrap.sh +---------------------------- + +bootstrap.sh is a script to bootstrap your environment for DIB and libra-elements. + + +It does: +#. Install deps +#. Add some vars to ~/.dib_profile and your ~/.bashrc +#. Clone / update the repos. + +Simply run: + +:: + + $ curl https://raw.github.com/LBaaS/libra-elements/master/bootstrap.sh | bash + + +Supported distros +----------------- + +Currently the supported distributions for DIB are: + +.. note:: + + There are not support in the elements nor in the packages for anythign else at this time + +* precise + + +Worker image +------------ + +To generate a worker image, do + +:: + + DIB_RELEASE=precise disk-image-create "libra-worker" -o libra-worker.qcow2 + + +API node +-------- + +To generate a API image, do + +:: + + DIB_RELEASE=precise disk-image-create "libra-api" -o libra-api.qcow2 + +Or to put both the API and Admin API on the same image + +:: + + DIB_RELEASE=precise disk-image-create "libra-api libra-admin-api" -o libra-api.qcow2 + + +Pool Manager image +------------------ + +To generate a API image, do + +:: + + DIB_RELEASE=precise disk-image-create "libra-pool-mgr" -o libra-pool-mgr.qcow2 diff --git a/doc/install/index.rst b/doc/install/index.rst index dd7a708c..6768a83f 100644 --- a/doc/install/index.rst +++ b/doc/install/index.rst @@ -9,4 +9,5 @@ Installing Libra LBaas development production ppa + diskimage-builder verify \ No newline at end of file