Jump to: navigation, search

Difference between revisions of "Solum/solum kilo demo"

(Work In Progress)
(Solum Demo Vagrant Installation Instructions)
Line 10: Line 10:
 
=== Solum Demo Vagrant Installation Instructions ===
 
=== Solum Demo Vagrant Installation Instructions ===
  
1. Install Vagrant (http://www.vagrantup.com/downloads.html). ''Tested with Vagrant v1.5.4''
+
1. Install Vagrant (http://www.vagrantup.com/downloads.html). ''Tested with Vagrant v1.6.3''
  
 
2. Make a directory vagrant repository.
 
2. Make a directory vagrant repository.
Line 21: Line 21:
  
 
  export SOLUM_IMAGE_FORMAT=docker
 
  export SOLUM_IMAGE_FORMAT=docker
export NOVADOCKER_REPO=https://github.com/ed-/nova-docker.git
 
export NOVADOCKER_BRANCH=solum-pin
 
  
Note:
+
4. Create the demo environment on your system:
 
 
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 vagrant vm using 'vagrant up' command (step 3) fails if we don't pin to the above version of nova-docker.
 
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 a specific version of nova-docker (as above) before booting up the vagrant vm, and then installing the latest version of nova-docker once inside the vagrant vm
 
as shown in step 4.
 
 
 
3. Create the demo environment on your system:
 
 
  cd vagrant
 
  cd vagrant
 
  vagrant up
 
  vagrant up
Line 38: Line 28:
 
NOTE: This may take between about 15 and 60 minutes to install, depending on the speed of your machine and network.
 
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
+
5. Login to vagrant VM
 
   vagrant ssh
 
   vagrant ssh
  
5. Git clone the latest nova-docker
+
6. 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
 
 
 
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
+
7. 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.
+
8. You can follow the steps of creating a language pack, creating an app, deploying the app, etc.

Revision as of 20:05, 28 April 2015

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.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. Set the following environment variables.

export SOLUM_IMAGE_FORMAT=docker

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

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.