Ansible playbooks for deploying OpenStack.
Find a file
2025-12-23 10:54:28 +00:00
deploy-guide/source Merge "Switch to Gazpacho development" 2025-12-16 15:28:47 +00:00
doc Merge "Switch to Gazpacho development" 2025-12-16 15:28:47 +00:00
etc Merge "Add minimal AIO files for k8s clusters" 2025-12-15 21:06:46 +00:00
inventory Do not define openstack_pki_san in integrated repo 2025-12-17 16:04:21 +00:00
molecule/default Add noop molecule job to the integrated repo 2025-01-06 11:40:07 +01:00
osa_toolkit Return command help if no argument is provided 2025-10-08 13:18:17 +00:00
playbooks Move remaining playbooks to collection 2025-03-20 13:20:23 +01:00
releasenotes reno: Update master for unmaintained/2024.1 2025-12-18 14:17:37 +00:00
scripts Ensure bash-completion also search for .yaml 2025-12-18 19:21:48 +01:00
sync Move sync framework to integrated repo 2025-04-17 21:31:25 +02:00
tests Merge "Add minimal AIO files for k8s clusters" 2025-12-15 21:06:46 +00:00
zuul.d Merge "Switch to Gazpacho development" 2025-12-16 15:28:47 +00:00
.ansible-lint Stop skipping FQCN ansible-lint rule 2025-04-01 14:45:44 +00:00
.gitignore Remove non-working dynamic build of AIO scenario table 2018-09-16 10:49:29 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:48:42 +00:00
ansible-collection-requirements.yml Merge "Switch to Gazpacho development" 2025-12-16 15:28:47 +00:00
ansible-role-requirements.yml Switch to Gazpacho development 2025-12-08 14:03:30 +00:00
bindep.txt Remove python2 packages from bindep.txt 2020-09-30 06:53:58 +00:00
CONTRIBUTING.rst docs: fix for incorrect Contributors guide url 2025-05-04 10:13:28 +00:00
global-requirement-pins.txt Bump global requirements 2025-11-05 13:16:32 +00:00
LICENSE.txt Correct path to callback plugins in gate script 2016-02-01 16:52:54 +00:00
README.rst Fix urls in README 2025-05-04 10:00:38 +00:00
requirements.txt Re-adding PrettyTable dependency 2021-04-03 06:08:03 +00:00
setup.cfg Add relevant releases tooling into the repo 2025-08-12 14:41:51 +02:00
setup.py Cleanup py27 support 2022-08-15 11:12:16 +08:00
test-requirements.txt Add relevant releases tooling into the repo 2025-08-12 14:41:51 +02:00
tox.ini Remove functional test environments from tox.ini 2025-08-12 15:11:35 +02:00

=================
OpenStack-Ansible
=================

.. image:: https://governance.openstack.org/tc/badges/openstack-ansible.svg

.. Change things from this point on

OpenStack-Ansible is an `official OpenStack project`_ which aims to deploy
production environments from source in a way that makes it scalable while
also being simple to operate, upgrade, and grow.

For an overview of the mission, repositories and related Wiki home page,
please see the formal `Home Page`_ for the project.

For those looking to test OpenStack-Ansible using an All-In-One (AIO) build,
please see the `Quick Start`_ guide.

For more detailed Installation and Operator documentation, please see the
`Deployment Guide`_.

If OpenStack-Ansible is missing something you'd like to see included, then
we encourage you to see the `Developer Documentation`_ for more details on
how you can get involved.

Developers wishing to work on the OpenStack-Ansible project should always
base their work on the latest code, available from the master GIT repository
at `Source`_.

If you have some questions, or would like some assistance with achieving your
goals, then please feel free to reach out to us on the
`OpenStack Mailing Lists`_ (particularly openstack-discuss)
or on IRC in ``#openstack-ansible`` on the `OFTC network`_.

OpenStack-Ansible Roles
#######################

OpenStack-Ansible offers separate role repositories for each individual role
that OpenStack-Ansible supports. For individual role configuration options,
see the `Role Documentation`_.

An individual role's source code can be found at:
https://opendev.org/openstack/openstack-ansible-<ROLENAME>.

.. _official OpenStack project: https://governance.openstack.org/tc/reference/projects/index.html
.. _Home Page: https://governance.openstack.org/tc/reference/projects/openstackansible.html
.. _Deployment Guide: https://docs.openstack.org/project-deploy-guide/openstack-ansible/latest
.. _Quick Start: https://docs.openstack.org/openstack-ansible/latest/user/aio/quickstart.html
.. _Developer Documentation: https://docs.openstack.org/openstack-ansible/latest/contributors/index.html
.. _Source: https://opendev.org/openstack/openstack-ansible
.. _OpenStack Mailing Lists: https://lists.openstack.org/mailman3/lists/
.. _OFTC network: https://www.oftc.net/
.. _Role Documentation: https://docs.openstack.org/project-deploy-guide/openstack-ansible/latest/configure.html#advanced-service-configuration

Resources
#########

* License: Apache License, Version 2.0
* Documentation: https://docs.openstack.org/openstack-ansible/latest/
* Source: https://opendev.org/openstack/openstack-ansible
* Bugs: https://bugs.launchpad.net/openstack-ansible
* Release notes: https://docs.openstack.org/releasenotes/openstack-ansible/