Gitiles
Code Review Sign In
spfactory.storpool.com / devstack / eb9b08a8833884b7c7c5b55813d7621715fe7adf / . / doc / source / overview.rst
blob: 4384081769eac845360142e43c6d400370ec8c4f [file] [log] [blame]
Dean Troyer0986a7b2014-10-29 22:08:13 -0500[diff] [blame]1========
2Overview
3========
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]4
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 -0400[diff] [blame]10everyone.
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]11
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 -0500[diff] [blame]16====================
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]17
18Base OS
Sean Dague32930462014-11-18 06:51:16 -0500[diff] [blame]19-------
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]20
21*The OpenStack Technical Committee (TC) has defined the current CI
22strategy to include the latest Ubuntu release and the latest RHEL
Sean Dague2686b362017-05-02 08:49:17 -0400[diff] [blame]23release.*
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]24
25- Ubuntu: current LTS release plus current development release
Dr. Jens Harbottfbc18652023-06-07 15:19:37 +0200[diff] [blame]26- RHEL/CentOS/RockyLinux: current major release
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]27- Other OS platforms may continue to be included but the maintenance of
28 those platforms shall not be assumed simply due to their presence.
29 Having a listed point-of-contact for each additional OS will greatly
30 increase its chance of being well-maintained.
Dr. Jens Harbottfbc18652023-06-07 15:19:37 +0200[diff] [blame]31- Patches for Ubuntu and/or RockyLinux will not be held up due to
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]32 side-effects on other OS platforms.
33
34Databases
Sean Dague32930462014-11-18 06:51:16 -0500[diff] [blame]35---------
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]36
37*As packaged by the host OS*
38
39- MySQL
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]40
41Queues
Sean Dague32930462014-11-18 06:51:16 -0500[diff] [blame]42------
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]43
44*As packaged by the host OS*
45
46- Rabbit
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]47
48Web Server
Sean Dague32930462014-11-18 06:51:16 -0500[diff] [blame]49----------
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]50
51*As packaged by the host OS*
52
53- Apache
54
55OpenStack Network
Sean Dague32930462014-11-18 06:51:16 -0500[diff] [blame]56-----------------
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]57
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]58- Neutron: A basic configuration approximating the original FlatDHCP
59 mode using linuxbridge or OpenVSwitch.
60
61Services
Sean Dague32930462014-11-18 06:51:16 -0500[diff] [blame]62--------
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]63
Shilla Saebicae97da2015-04-16 13:58:56 -0400[diff] [blame]64The default services configured by DevStack are Identity (keystone),
Sean Dague2686b362017-05-02 08:49:17 -0400[diff] [blame]65Object Storage (swift), Image Service (glance), Block Storage
Nguyen Haie7299762019-02-13 15:04:02 +0900[diff] [blame]66(cinder), Compute (nova), Placement (placement),
67Networking (neutron), Dashboard (horizon).
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]68
69Additional services not included directly in DevStack can be tied in to
Dean Troyerea3cdfa2014-11-08 08:29:16 -0600[diff] [blame]70``stack.sh`` using the :doc:`plugin mechanism <plugins>` to call
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]71scripts that perform the configuration and startup of the service.
72
73Node Configurations
Sean Dague32930462014-11-18 06:51:16 -0500[diff] [blame]74-------------------
Sean M. Collins09e550c2014-10-21 11:40:08 -0400[diff] [blame]75
76- single node
Sean Dague2686b362017-05-02 08:49:17 -0400[diff] [blame]77- multi-node configurations as are tested by the gate