openstack/devstack
Code Issues Proposed changes
9eb8177eb7
devstack/doc/source/index.rst
Dean Troyer 26dd21be8c One last format and content cleanup for the index page 
Update the form of the links to other documents in the tree;
the generated HTML links must remain in the original form.
The layout is changed from the previous tables to a more Sphinx-y
TOC-like list.

Also editorial changes to the index page and guide titles

Change-Id: I52df0cc542754c386fb3c99d9efdf2524c11bf48
2014-11-07 12:12:21 -06:00

5.9 KiB
Raw Blame History

DevStack - an OpenStack Community Production

overview configuration plugins faq changes contributing

Quick Start

  1. Select a Linux Distribution

    Only Ubuntu 14.04 (Trusty), Fedora 20 and CentOS/RHEL 6.5 are documented here. OpenStack also runs and is packaged on other flavors of Linux such as OpenSUSE and Debian.

  2. Install Selected OS

    In order to correctly install all the dependencies, we assume a specific minimal version of the supported distributions to make it as easy as possible. We recommend using a minimal install of Ubuntu or Fedora server in a VM if this is your first time.

  3. Download DevStack

    git clone https://git.openstack.org/openstack-dev/devstack

    The devstack repo contains a script that installs OpenStack and templates for configuration files

  4. Configure

    We recommend at least a minimal configuration <configuration> be set up.

  5. Start the install

    cd devstack; ./stack.sh

    It takes a few minutes, we recommend reading the script while it is building.

Guides

Walk through various setups used by stackers

guides/single-vm guides/single-machine guides/multinode-lab

All-In-One Single VM

Run OpenStack in a VM <guides/single-vm>. The VMs launched in your cloud will be slow as they are running in QEMU (emulation), but it is useful if you don't have spare hardware laying around. [Read] <guides/single-vm>

All-In-One Single Machine

Run OpenStack on dedicated hardware <guides/single-machine> This can include a server-class machine or a laptop at home. [Read] <guides/single-machine>

Multi-Node Lab

Setup a multi-node cluster <guides/multinode-lab> with dedicated VLANs for VMs & Management. [Read] <guides/multinode-lab>

DevStack Documentation

Overview

An overview of DevStack goals and priorities <overview>

Configuration

Configuring and customizing the stack <configuration>

Plugins

Extending DevStack with new features <plugins>

Recent Changes

An incomplete summary of recent changes <changes>

FAQ

The DevStack FAQ <faq>

Contributing

Pitching in to make DevStack a better place <contributing>

Code

A look at the bits that make it all go

Scripts

Configuration

local.conf stackrc openrc exerciserc eucarc

Tools

Samples

Exercises