openstack-ansible/deploy-guide/source/app-aboutosa.rst
Jean-Philippe Evrard d99c1d3469 [Docs] Include OpenStack-Ansible Manifesto
The OpenStack Ansible Deployment manifesto [1] was lost in times in
pages long forgotten of the wiki.

Instead, it should be part of the documentation, in our reference
section. The reference is a great place because it's where we
explain WHY we are doing things.

To increase visibility of this page, the design decisions are
directly linked from the deploy guide appendix about
"Why OpenStack-Ansible".

Change-Id: Ifb3ef041c773ee6dbe6606e2e5efc0542776dfc5
2018-03-23 19:15:48 +00:00

53 lines
2.3 KiB
ReStructuredText

.. _app-aboutosa:
=======================
About OpenStack-Ansible
=======================
OpenStack-Ansible (OSA) uses the `Ansible <https://www.ansible.com/how-ansible-works>`_
IT automation engine to deploy an OpenStack environment on Ubuntu, with CentOS and
openSUSE currently in Beta release.
For isolation and ease of maintenance, you can install OpenStack components
into machine containers.
The OpenStack-Ansible manifesto
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
All the design considerations (the container architecture, the ability to
override any code, the network considerations, etc.) of this project are
listed in our :dev_docs:`architecture reference <reference/architecture/index.html>`.
Why choose OpenStack-Ansible?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Supports the major Linux distributions Ubuntu, CentOS (WIP) and OpenSUSE
(WIP).
* Supports the major CPU architectures x86, ppc64, s390x (WIP).
* Offers automation for upgrades between major OpenStack releases.
* Uses OpenStack defaults for each of the project roles, and provides
extra wiring and optimised configuration when combining projects
together.
* Does not implement its own DSL, and uses wherever possible Ansible
directly. All the experience acquired using Ansible can be used in
openstack-ansible, and the other way around.
* You like to use reliable, proven technology. We try to run OpenStack
with a minimum amount of packages that are not provided by distributions
or the OpenStack community. Less dependencies and distribution tested
software make the project more reliable.
* You want to be able to select how to deploy on your hardware: deploy
partially on metal, fully on metal, or fully in machine containers.
When **not** to choose OpenStack-Ansible?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* If your company is already invested with other configuration management
systems, Puppet or Chef, and does not want to use Ansible we recommend
re-using your knowledge and experimenting with a different
OpenStack deployment project.
* You want to deploy OpenStack with 100% application containers.
We currently support machine containers, with lxc and we will support
*systemd-nspawn* in the future (WIP). If you want to go 100% Docker,
there are other projects in the OpenStack community that can
help you.