Difference between revisions of "Solum/solum kilo demo"

Revision as of 22:25, 24 April 2015

Work In Progress

Video

Coming soon.

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.5.4

2. Make a directory vagrant repository.

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

3. Set the following environment variables.

export SOLUM_IMAGE_FORMAT=docker export NOVADOCKER_REPO=https://github.com/ed-/nova-docker.git export NOVADOCKER_BRANCH=solum-pin

Note:

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. 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. 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 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.

3. Create the demo environment on your system:

cd vagrant
vagrant up

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

4. Login to vagrant VM

 vagrant ssh

5. Git clone the latest nova-docker

    mv /opt/stack/nova-docker /opt/stack/nova-docker.bak
    git clone http://github.com/stackforge/nova-docker.git /opt/stack/nova-docker

6. 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

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

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

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

@@ Line 20: / Line 20: @@
   git clone https://github.com/rackerlabs/vagrant-solum-dev.git vagrant
-. Set the following environment variables:
+. Set the following environment variables.
 export SOLUM_IMAGE_FORMAT=docker
@@ Line 26: / Line 26: @@
 export NOVADOCKER_BRANCH=solum-pin
-Note: 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.
+Note:
+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.
 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.
 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