openstack/devstack
Code Issues Proposed changes
7b5c7dce53
devstack/doc/source/index.rst
Bernd Mueller b1518427c6 removed dead link to stack.sh.html 
the referenced file was removed with the following change
Ie7f4b265368f1d10a8908d75e11d625b2cc39e7c

Change-Id: I0e25b1f38e0969037d1c8af367432da56bb12e92
2016-05-04 22:33:21 +02:00

4.0 KiB
Raw Blame History

DevStack

image

DevStack is a series of extensible scripts used to quickly bring up a complete OpenStack environment. It is used interactively as a development environment and as the basis for much of the OpenStack project's functional testing.

The source is available at https://git.openstack.org/cgit/openstack-dev/devstack.

overview configuration plugins plugin-registry faq hacking

Quick Start

  1. Select a Linux Distribution

    Only Ubuntu 14.04 (Trusty), Fedora 22 (or Fedora 23) and CentOS/RHEL 7 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 be set up.

  5. Add Stack User

    Devstack should be run as a non-root user with sudo enabled (standard logins to cloud images such as "ubuntu" or "cloud-user" are usually fine).

    You can quickly create a separate stack user to run DevStack with

    devstack/tools/create-stack-user.sh; su stack

  6. Start the install, this will take a few minutes.

    cd devstack; ./stack.sh

Guides

Walk through various setups used by stackers

guides/single-vm guides/single-machine guides/lxc guides/multinode-lab guides/neutron guides/devstack-with-nested-kvm guides/nova guides/devstack-with-lbaas-v2

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>

All-In-One LXC Container

Run OpenStack in a LXC container <guides/lxc>. Beneficial for intermediate and advanced users. The VMs launched in this cloud will be fully accelerated but not all OpenStack features are supported. [Read] <guides/lxc>

Multi-Node Lab

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

DevStack with Neutron Networking

Building a DevStack cluster with Neutron Networking <guides/neutron>. This guide is meant for building lab environments with a dedicated control node and multiple compute nodes.

DevStack with KVM-based Nested Virtualization

Procedure to setup DevStack with KVM-based Nested Virtualization <guides/devstack-with-nested-kvm>. With this setup, Nova instances will be more performant than with plain QEMU emulation.

Nova and devstack

Guide to working with nova features Nova and devstack <guides/nova>.

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>

FAQ

The DevStack FAQ <faq>

Contributing

Pitching in to make DevStack a better place <hacking>