| <!DOCTYPE html> |
| <html lang="en"> |
| <head> |
| <meta charset="utf-8"> |
| <title>Single Machine Guide - DevStack</title> |
| <meta name="description" content=""> |
| <meta name="author" content=""> |
| |
| <!-- Le HTML5 shim, for IE6-8 support of HTML elements --> |
| <!--[if lt IE 9]> |
| <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script> |
| <![endif]--> |
| |
| <!-- Le styles --> |
| <link href="../assets/css/bootstrap.css" rel="stylesheet"> |
| <link href="../assets/css/local.css" rel="stylesheet"> |
| <style type="text/css"> |
| body { padding-top: 60px; } |
| dd { padding: 10px; } |
| </style> |
| |
| <!-- Le javascripts --> |
| <script src="../assets/js/jquery-1.7.1.min.js" type="text/javascript" charset="utf-8"></script> |
| <script src="../assets/js/bootstrap.js" type="text/javascript" charset="utf-8"></script> |
| </head> |
| |
| <body> |
| |
| <div class="navbar navbar-fixed-top"> |
| <div class="navbar-inner"> |
| <div class="container"> |
| <a class="brand" href="/">DevStack</a> |
| <ul class="nav pull-right"> |
| <li><a href="../overview.html">Overview</a></li> |
| <li><a href="../changes.html">Changes</a></li> |
| <li><a href="../faq.html">FAQ</a></li> |
| <li><a href="https://git.openstack.org/cgit/openstack-dev/devstack">git.openstack.org</a></li> |
| <li><a href="https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z">Gerrit</a></li> |
| </ul> |
| </div> |
| </div> |
| </div> |
| |
| <div class="container"> |
| <section id="overview"> |
| <h1>Running a Cloud in a VM</h1> |
| <p>Use the cloud to build the cloud! Use your cloud to launch new versions of OpenStack |
| in about 5 minutes. When you break it, start over! The VMs launched in the cloud will |
| be slow as they are running in QEMU (emulation), but their primary use is testing |
| OpenStack development and operation. Speed not required.</p> |
| </section> |
| |
| <section id="prerequisites"> |
| <div class="page-header"> |
| <h2>Prerequisites <small>Cloud & Image</small></h2> |
| </div> |
| |
| <h3>Virtual Machine</h3> |
| <p>DevStack should run in any virtual machine running a supported Linux release. It will perform best with 2Gb or more of RAM.</p> |
| |
| <h3>OpenStack Deployment & cloud-init</h3> |
| <p>If the cloud service has an image with <code>cloud-init</code> pre-installed, use it. You can |
| get one from <a href="http://uec-images.ubuntu.com">Ubuntu's Daily Build</a> |
| site if necessary. This will enable you to launch VMs with userdata that installs |
| everything at boot time. The userdata script below will install and run |
| DevStack with a minimal configuration. The use of <code>cloud-init</code> |
| is outside the scope of this document, refer to <a href"http://cloudinit.readthedocs.org/en/latest/index.html">the |
| <code>cloud-init</code> docs</a> for more information.</p> |
| |
| <p>If you are directly using a hypervisor like Xen, kvm or VirtualBox you can manually kick off |
| the script below as a non-root user in a bare-bones server installation.</p> |
| </section> |
| |
| <section id="requirements"> |
| <div class="page-header"> |
| <h2>Installation <small>shake and bake</small></h2> |
| </div> |
| |
| <h3>Launching With Cloud-Init</h3> |
| <p>This cloud config grabs the latest version of DevStack via git, creates a minimal |
| <code>local.conf</code> file and kicks off <code>stack.sh</code>. It should |
| be passed as the user-data file when booting the VM.</p> |
| <pre>#cloud-config |
| |
| users: |
| - default |
| - name: stack |
| lock_passwd: False |
| sudo: ["ALL=(ALL) NOPASSWD:ALL\nDefaults:stack !requiretty"] |
| shell: /bin/bash |
| |
| write_files: |
| - content: | |
| #!/bin/sh |
| DEBIAN_FRONTEND=noninteractive sudo apt-get -qqy update || sudo yum update -qy |
| DEBIAN_FRONTEND=noninteractive sudo apt-get install -qqy git || sudo yum install -qy git |
| sudo chown stack:stack /home/stack |
| cd /home/stack |
| git clone https://git.openstack.org/openstack-dev/devstack |
| cd devstack |
| echo '[[local|localrc]]' > local.conf |
| echo ADMIN_PASSWORD=password >> local.conf |
| echo MYSQL_PASSWORD=password >> local.conf |
| echo RABBIT_PASSWORD=password >> local.conf |
| echo SERVICE_PASSWORD=password >> local.conf |
| echo SERVICE_TOKEN=tokentoken >> local.conf |
| ./stack.sh |
| path: /home/stack/start.sh |
| permissions: 0755 |
| |
| runcmd: |
| - su -l stack ./start.sh</pre> |
| <p>As DevStack will refuse to run as root, this configures <code>cloud-init</code> |
| to create a non-root user and run the <code>start.sh</code> script as that user.</p> |
| |
| <h3>Launching By Hand</h3> |
| <p>Using a hypervisor directly, launch the VM and either manually perform the steps in the |
| embedded shell script above or copy it into the VM.</p> |
| |
| <h3>Using OpenStack</h3> |
| <p>At this point you should be able to access the dashboard. Launch VMs and if you give them floating IPs access those VMs from other machines on your network.</p> |
| |
| <p>One interesting use case is for developers working on a VM on their laptop. Once |
| <code>stack.sh</code> has completed once, all of the pre-requisite packages are installed |
| in the VM and the source trees checked out. Setting <code>OFFLINE=True</code> in |
| <code>local.conf</code> enables <code>stack.sh</code> to run multiple times without an Internet |
| connection. DevStack, making hacking at the lake possible since 2012!</p> |
| </section> |
| |
| <footer> |
| <p>© Openstack Foundation 2011-2014 — An <a href="https://www.openstack.org/">OpenStack</a> <a href="https://wiki.openstack.org/wiki/Programs">program</a></p> |
| </footer> |
| |
| </div> <!-- /container --> |
| |
| </body> |
| </html> |