=============
 Quo Vadimus
=============

Where are we going?

This is a document in Devstack to outline where we are headed in the
future. The future might be near or far, but this is where we'd like
to be.

This is intended to help people contribute, because it will be a
little clearer if a contribution takes us closer to or further away to
our end game.

==================
 Default Services
==================

Devstack is designed as a development environment first. There are a
lot of ways to compose the OpenStack services, but we do need one
default.

That should be the Compute Layer (currently Glance + Nova + Cinder +
Neutron Core (not advanced services) + Keystone). It should be the
base building block going forward, and the introduction point of
people to OpenStack via Devstack.

================
 Service Howtos
================

Starting from the base building block all services included in
OpenStack should have an overview page in the Devstack
documentation. That should include the following:

- A helpful high level overview of that service
- What it depends on (both other OpenStack services and other system
  components)
- What new daemons are needed to be started, including where they
  should live

This provides a map for people doing multinode testing to understand
what portions are control plane, which should live on worker nodes.

Service how to pages will start with an ugly "This team has provided
no information about this service" until someone does.

===================
 Included Services
===================

Devstack doesn't need to eat the world. Given the existence of the
external devstack plugin architecture, the future direction is to move
the bulk of the support code out of devstack itself and into external
plugins.

This will also promote a more clean separation between services.

=============================
 Included Backends / Drivers
=============================

Upstream Devstack should only include Open Source backends / drivers,
it's intent is for Open Source development of OpenStack. Proprietary
drivers should be supported via external plugins.

Just being Open Source doesn't mean it should be in upstream Devstack
if it's not required for base development of OpenStack
components. When in doubt, external plugins should be used.

========================================
 OpenStack Services vs. System Services
========================================

ENABLED_SERVICES is currently entirely too overloaded. We should have
a separation of actual OpenStack services that you have to run (n-cpu,
g-api) and required backends like mysql and rabbitmq.

===========================
 Splitting up of Functions
===========================

The functions-common file has grown over time, and needs to be split
up into smaller libraries that handle specific domains.

======================
 Testing of Functions
======================

Every function in a functions file should get tests. The devstack
testing framework is young, but we do have some unit tests for the
tree, and those should be enhanced.

==============================
 Not Co-Gating with the World
==============================

As projects spin up functional test jobs, Devstack should not be
co-gated with every single one of those. The Devstack team has one of
the fastest turn arounds for blocking bugs of any Open Stack
project.

Basic service validation should be included as part of Devstack
installation to mitigate this.

============================
 Documenting all the things
============================

Devstack started off as an explanation as much as an install
script. We would love contributions to that further enhance the
comments and explanations about what is happening, even if it seems a
little pedantic at times.