adjutant/README.rst
Dale Smith 8ae383f9fe Fix gates for Antelope and update Django
* Zuul deprecated (and now removed) declaring shared queues at a pipeline
  level [1]. This patch fixes the syntax to make the gate work for
  adjutant.
* Updates Django version to allow upper-constraints version
* Fix Django 3.2 warnings
* Fix flake8 errors
* Remove support for Python 3.6, Python 3.7

[1] https://lists.openstack.org/pipermail/openstack-discuss/2022-May/028603.html

Change-Id: Ic369b59bb062df867d78b006f06e48cf9c98a3ee
2022-12-07 19:52:27 +13:00

40 lines
1.4 KiB
ReStructuredText

========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/tc/badges/adjutant.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
.. Change things from this point on
Adjutant
========
A basic workflow framework built using Django and
Django-Rest-Framework to help automate basic Admin tasks within an
OpenStack cluster.
Primarily built as user registration service that fits into the
OpenStack ecosystem alongside Keystone, its purpose to fill
functionality missing from Keystone. Ultimately it is just a framework
with actions that are tied to an endpoint and can require certain data
fields and perform actions via the OpenStack clients as well as talk
to external systems as needed.
Useful for automating generic admin tasks that users might request but
otherwise can't do without the admin role. Also allows automating the
signup and creation of new users, and allows such requests to require
approval first if wanted. Due to issuing of uri+tokens for final steps
of some actions, allows for a password submit/reset system as well.
Documentation
=============
Documentation can be found at: https://docs.openstack.org/adjutant/latest
Documentation is stored in doc/, a sphinx build of the documentation
can be generated with the command `tox -e docs`.
An API Reference is stored in api-ref. This is also a sphinx build and
can be generated with `tox -e api-ref`.