Difference between revisions of "Solum/solum kilo demo"

Latest revision as of 22:45, 28 April 2015

Video

Set Up Your Own Demo Environment

You can set up your own demo environment to run your own installation of Solum with Devstack in a vagrant box. This uses VirtualBox as the default provider, so it will work on a Mac or PC with Vagrant and VirtualBox loaded. The demo system can actually deploy an application, and has a fully functional CLI included.

Solum Demo Vagrant Installation Instructions

1. Install Vagrant (http://www.vagrantup.com/downloads.html). Tested with Vagrant v1.6.3

2. Make a directory vagrant repository.

mkdir ~/Solum-Demo
cd ~/Solum-Demo
git clone https://github.com/rackerlabs/vagrant-solum-dev.git vagrant

3. Git clone solum and python-solumclient code:

cd
git clone https://github.com/stackforge/solum.git solum
git clone https://github.com/stackforge/python-solumclient.git python-solumclient

3. Set the following environment variables.

export SOLUM_IMAGE_FORMAT=docker
export SOLUM=<path-to-the-directory-where-you-cloned-solum>
export SOLUMCLIENT=<path-to-the-directory-where-you-cloned-python-solumclient>

4. Create the demo environment on your system:

cd ~/Solum-Demo/vagrant
vagrant up

NOTE: This may take between about 15 and 60 minutes to install, depending on the speed of your machine and network.

5. Login to vagrant VM

 vagrant ssh

6. Now you are ready to experiment deploying your applications using Solum.

7. Start with the Quick start guide here: https://solum.readthedocs.org/en/latest/getting_started/index.html

8. You can follow the steps of creating a language pack, creating an app, deploying the app, etc.

@@ Line 1: / Line 1: @@
-=== Work In Progress ===
+=== Video ===
-Video
+https://vimeo.com/126307313
-Coming soon.
+=== Set Up Your Own Demo Environment ===
-Set Up Your Own Demo Environment
 You can set up your own demo environment to run your own installation of Solum with Devstack in a vagrant box. This uses VirtualBox as the default provider, so it will work on a Mac or PC with Vagrant and VirtualBox loaded. The demo system can actually deploy an application, and has a fully functional CLI included.
@@ Line 12: / Line 9: @@
 === Solum Demo Vagrant Installation Instructions ===
-. Install Vagrant (http://www.vagrantup.com/downloads.html). ''Tested with Vagrant v1.5.4''
+. Install Vagrant (http://www.vagrantup.com/downloads.html). ''Tested with Vagrant v1.6.3''
 . Make a directory vagrant repository.
@@ Line 20: / Line 17: @@
   git clone https://github.com/rackerlabs/vagrant-solum-dev.git vagrant
-. Set the following environment variables.
+. Git clone solum and python-solumclient code:
-export SOLUM_IMAGE_FORMAT=docker
+ cd
-export NOVADOCKER_REPO=https://github.com/ed-/nova-docker.git
+ git clone https://github.com/stackforge/solum.git solum
-export NOVADOCKER_BRANCH=solum-pin
+ git clone https://github.com/stackforge/python-solumclient.git python-solumclient
-Note:
+. Set the following environment variables.
-The repository https://github.com/ed-/nova-docker.git is a fork of nova-docker pinned to the commit hash just before nova-docker included docker-py in its requirements.
+ export SOLUM_IMAGE_FORMAT=docker
-Since docker-py is not yet in global-requirements.txt, starting up the vagrant up fails if we don't pin to the above version.
+ export SOLUM=<path-to-the-directory-where-you-cloned-solum>
-However, for solum to work in the Vagrant setup, we need the latest code of nova-docker. So the way we get around this seemingly inconsistent situation is by
+ export SOLUMCLIENT=<path-to-the-directory-where-you-cloned-python-solumclient>
-pinning to the a specific version (as above) before starting vagrant and then installing the latest version of nova-docker once inside the Vagrant VM.
-This is explained more in step 4.
 . Create the demo environment on your system:
-  cd vagrant
+  cd ~/Solum-Demo/vagrant
   vagrant up
 NOTE: This may take between about 15 and 60 minutes to install, depending on the speed of your machine and network.
 . Login to vagrant VM
    vagrant ssh
-. Git clone the latest nova-docker
+. Now you are ready to experiment deploying your applications using Solum.
-     mv /opt/stack/nova-docker /opt/stack/nova-docker.bak
-     git clone http://github.com/stackforge/nova-docker.git /opt/stack/nova-docker
-. For the nova-docker change to take effect we need to restart the nova services:
-   You can restart the n-* services by going to their screen sessions and killing and restarting the service.
-   Steps:
-   screen -x stack
-   Ctrl A + n -> next screen
-   Ctrl A + p -> previous screen
-   Ctrl C within a screen will stop the process
-   You can restart it by typing up arrow and hitting enter
-. Now you are ready to experiment deploying your applications using Solum.
 . Start with the Quick start guide here: https://solum.readthedocs.org/en/latest/getting_started/index.html
 . You can follow the steps of creating a language pack, creating an app, deploying the app, etc.