blob: d245035a1a460128793e0b4a899d2d0681bec0f0 [file] [log] [blame]
Dean Troyer0986a7b2014-10-29 22:08:13 -05001========
2Overview
3========
Sean M. Collins09e550c2014-10-21 11:40:08 -04004
5DevStack has evolved to support a large number of configuration options
6and alternative platforms and support services. That evolution has grown
7well beyond what was originally intended and the majority of
8configuration combinations are rarely, if ever, tested. DevStack is not
9a general OpenStack installer and was never meant to be everything to
Shilla Saebicae97da2015-04-16 13:58:56 -040010everyone.
Sean M. Collins09e550c2014-10-21 11:40:08 -040011
12Below is a list of what is specifically is supported (read that as
13"tested") going forward.
14
15Supported Components
Sean Dague32930462014-11-18 06:51:16 -050016====================
Sean M. Collins09e550c2014-10-21 11:40:08 -040017
18Base OS
Sean Dague32930462014-11-18 06:51:16 -050019-------
Sean M. Collins09e550c2014-10-21 11:40:08 -040020
21*The OpenStack Technical Committee (TC) has defined the current CI
22strategy to include the latest Ubuntu release and the latest RHEL
23release (for Python 2.6 testing).*
24
25- Ubuntu: current LTS release plus current development release
26- Fedora: current release plus previous release
27- RHEL: current major release
28- Other OS platforms may continue to be included but the maintenance of
29 those platforms shall not be assumed simply due to their presence.
30 Having a listed point-of-contact for each additional OS will greatly
31 increase its chance of being well-maintained.
32- Patches for Ubuntu and/or Fedora will not be held up due to
33 side-effects on other OS platforms.
34
35Databases
Sean Dague32930462014-11-18 06:51:16 -050036---------
Sean M. Collins09e550c2014-10-21 11:40:08 -040037
38*As packaged by the host OS*
39
40- MySQL
41- PostgreSQL
42
43Queues
Sean Dague32930462014-11-18 06:51:16 -050044------
Sean M. Collins09e550c2014-10-21 11:40:08 -040045
46*As packaged by the host OS*
47
48- Rabbit
49- Qpid
50
51Web Server
Sean Dague32930462014-11-18 06:51:16 -050052----------
Sean M. Collins09e550c2014-10-21 11:40:08 -040053
54*As packaged by the host OS*
55
56- Apache
57
58OpenStack Network
Sean Dague32930462014-11-18 06:51:16 -050059-----------------
Sean M. Collins09e550c2014-10-21 11:40:08 -040060
Shilla Saebicae97da2015-04-16 13:58:56 -040061*Defaults to nova network, optionally use neutron*
Sean M. Collins09e550c2014-10-21 11:40:08 -040062
63- Nova Network: FlatDHCP
64- Neutron: A basic configuration approximating the original FlatDHCP
65 mode using linuxbridge or OpenVSwitch.
66
67Services
Sean Dague32930462014-11-18 06:51:16 -050068--------
Sean M. Collins09e550c2014-10-21 11:40:08 -040069
Shilla Saebicae97da2015-04-16 13:58:56 -040070The default services configured by DevStack are Identity (keystone),
71Object Storage (swift), Image Service (glance), Block Storage (cinder),
72Compute (nova), Networking (nova), Dashboard (horizon), Orchestration
73(heat)
Sean M. Collins09e550c2014-10-21 11:40:08 -040074
75Additional services not included directly in DevStack can be tied in to
Dean Troyerea3cdfa2014-11-08 08:29:16 -060076``stack.sh`` using the :doc:`plugin mechanism <plugins>` to call
Sean M. Collins09e550c2014-10-21 11:40:08 -040077scripts that perform the configuration and startup of the service.
78
79Node Configurations
Sean Dague32930462014-11-18 06:51:16 -050080-------------------
Sean M. Collins09e550c2014-10-21 11:40:08 -040081
82- single node
83- multi-node is not tested regularly by the core team, and even then
84 only minimal configurations are reviewed
85
86Exercises
Sean Dague32930462014-11-18 06:51:16 -050087---------
Sean M. Collins09e550c2014-10-21 11:40:08 -040088
89The DevStack exercise scripts are no longer used as integration and gate
90testing as that job has transitioned to Tempest. They are still
91maintained as a demonstrations of using OpenStack from the command line
92and for quick operational testing.