kayobe-config/README.rst
Pierre Riteau a9e00ad15b Synchronise README with Kayobe
Change-Id: Id02d5c192ae33e5807a64187b1cade3785cdf091
2024-11-14 16:49:12 +01:00

81 lines
2.7 KiB
ReStructuredText

====================
Kayobe Configuration
====================
This repository provides configuration for the `kayobe
<https://opendev.org/openstack/kayobe>`_ project. It is intended to encourage
version control of site configuration.
Kayobe enables deployment of containerised OpenStack to bare metal.
Containers offer a compelling solution for isolating OpenStack services, but
running the control plane on an orchestrator such as Kubernetes or Docker
Swarm adds significant complexity and operational overheads.
The hosts in an OpenStack control plane must somehow be provisioned, but
deploying a secondary OpenStack cloud to do this seems like overkill.
Kayobe stands on the shoulders of giants:
* OpenStack bifrost discovers and provisions the cloud
* OpenStack kolla builds container images for OpenStack services
* OpenStack kolla-ansible delivers painless deployment and upgrade of
containerised OpenStack services
To this solid base, kayobe adds:
* Configuration of cloud host OS & flexible networking
* Management of physical network devices
* A friendly openstack-like CLI
All this and more, automated from top to bottom using Ansible.
Features
--------
* Heavily automated using Ansible
* *kayobe* Command Line Interface (CLI) for cloud operators
* Deployment of a *seed* VM used to manage the OpenStack control plane
* Configuration of physical network infrastructure
* Discovery, introspection and provisioning of control plane hardware using
`OpenStack bifrost <https://docs.openstack.org/bifrost/latest/>`_
* Deployment of an OpenStack control plane using `OpenStack kolla-ansible
<https://docs.openstack.org/kolla-ansible/latest/>`_
* Discovery, introspection and provisioning of bare metal compute hosts
using `OpenStack ironic <https://docs.openstack.org/ironic/latest/>`_ and
`ironic inspector <https://docs.openstack.org/ironic-inspector/latest/>`_
* Virtualised compute using `OpenStack nova
<https://docs.openstack.org/nova/latest/>`_
* Containerised workloads on bare metal using `OpenStack magnum
<https://docs.openstack.org/magnum/latest/>`_
* Control plane monitoring using `Prometheus <https://prometheus.io/>`__ and
`Grafana <https://grafana.com/>`__.
* Log aggregation using `OpenSearch <https://opensearch.org/docs/latest/>`__
and `OpenSearch Dashboards
<https://opensearch.org/docs/latest/dashboards/index/>`__.
Documentation
-------------
https://docs.openstack.org/kayobe/latest/
Release Notes
-------------
https://docs.openstack.org/releasenotes/kayobe/
Bugs
----
https://bugs.launchpad.net/kayobe
Community
---------
OFTC's `IRC channel <http://webchat.oftc.net/?channels=openstack-kolla>`_: #openstack-kolla
License
-------
Kayobe is distributed under the `Apache 2.0 License <https://www.apache.org/licenses/LICENSE-2.0>`__.