2016-11-24 14:05:38 +01:00
|
|
|
========================
|
|
|
|
Team and repository tags
|
|
|
|
========================
|
|
|
|
|
|
|
|
.. image:: http://governance.openstack.org/badges/kolla-ansible.svg
|
|
|
|
:target: http://governance.openstack.org/reference/tags/index.html
|
|
|
|
|
|
|
|
.. Change things from this point on
|
|
|
|
|
2017-01-13 09:27:27 +08:00
|
|
|
======================
|
|
|
|
Kolla-Ansible Overview
|
|
|
|
======================
|
2014-09-19 13:52:33 -04:00
|
|
|
|
2017-01-13 09:27:27 +08:00
|
|
|
The Kolla-Ansible is a deliverable project separated from Kolla project.
|
|
|
|
|
|
|
|
Kolla-Ansible deploys OpenStack services and infrastructure components
|
|
|
|
in Docker containers.
|
2016-09-06 10:31:25 +02:00
|
|
|
|
2015-08-14 21:32:09 -07:00
|
|
|
Kolla's mission statement is:
|
2014-09-19 13:52:33 -04:00
|
|
|
|
2015-08-20 23:06:10 -07:00
|
|
|
::
|
|
|
|
|
2016-09-06 10:31:25 +02:00
|
|
|
To provide production-ready containers and deployment tools for operating
|
|
|
|
OpenStack clouds.
|
2015-08-14 21:32:09 -07:00
|
|
|
|
2015-08-20 23:06:10 -07:00
|
|
|
Kolla is highly opinionated out of the box, but allows for complete
|
|
|
|
customization. This permits operators with little experience to deploy
|
|
|
|
OpenStack quickly and as experience grows modify the OpenStack
|
|
|
|
configuration to suit the operator's exact requirements.
|
2014-09-19 13:52:33 -04:00
|
|
|
|
|
|
|
Getting Started
|
2014-09-20 21:10:29 -07:00
|
|
|
===============
|
2014-09-19 13:52:33 -04:00
|
|
|
|
2017-01-13 09:27:27 +08:00
|
|
|
Learn about Kolla-Ansible by reading the documentation online
|
|
|
|
`docs.openstack.org <http://docs.openstack.org/developer/kolla-ansible/>`__.
|
2015-11-05 13:46:49 -05:00
|
|
|
|
2016-02-17 17:20:00 -07:00
|
|
|
Get started by reading the `Developer
|
2017-01-13 09:27:27 +08:00
|
|
|
Quickstart <http://docs.openstack.org/developer/kolla-ansible/quickstart.html>`__.
|
2016-09-06 10:31:25 +02:00
|
|
|
|
|
|
|
OpenStack services
|
|
|
|
------------------
|
|
|
|
|
2017-01-13 09:27:27 +08:00
|
|
|
Kolla-Ansible deploys containers for the following OpenStack projects:
|
2015-11-17 16:24:36 -05:00
|
|
|
|
2015-12-03 16:00:56 -05:00
|
|
|
- `Aodh <http://docs.openstack.org/developer/aodh/>`__
|
2016-09-19 16:18:44 +05:30
|
|
|
- `Barbican <http://docs.openstack.org/developer/barbican/>`__
|
2016-09-02 11:59:43 +02:00
|
|
|
- `Bifrost <http://docs.openstack.org/developer/bifrost/>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
- `Ceilometer <http://docs.openstack.org/developer/ceilometer/>`__
|
|
|
|
- `Cinder <http://docs.openstack.org/developer/cinder/>`__
|
2016-08-01 00:12:13 +02:00
|
|
|
- `CloudKitty <http://docs.openstack.org/developer/cloudkitty/>`__
|
2016-09-01 10:52:33 +05:30
|
|
|
- `Congress <http://docs.openstack.org/developer/congress/>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
- `Designate <http://docs.openstack.org/developer/designate/>`__
|
2017-02-05 19:35:49 +08:00
|
|
|
- `Freezer <https://wiki.openstack.org/wiki/Freezer-docs>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
- `Glance <http://docs.openstack.org/developer/glance/>`__
|
|
|
|
- `Heat <http://docs.openstack.org/developer/heat/>`__
|
|
|
|
- `Horizon <http://docs.openstack.org/developer/horizon/>`__
|
|
|
|
- `Ironic <http://docs.openstack.org/developer/ironic/>`__
|
2017-01-20 10:36:02 +08:00
|
|
|
- `Karbor <http://docs.openstack.org/developer/karbor/>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
- `Keystone <http://docs.openstack.org/developer/keystone/>`__
|
2016-09-02 11:59:43 +02:00
|
|
|
- `Kuryr <http://docs.openstack.org/developer/kuryr/>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
- `Magnum <http://docs.openstack.org/developer/magnum/>`__
|
2016-03-04 14:16:43 -05:00
|
|
|
- `Manila <http://docs.openstack.org/developer/manila/>`__
|
2016-01-12 11:22:55 +09:00
|
|
|
- `Mistral <http://docs.openstack.org/developer/mistral/>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
- `Murano <http://docs.openstack.org/developer/murano/>`__
|
|
|
|
- `Neutron <http://docs.openstack.org/developer/neutron/>`__
|
2016-09-02 11:59:43 +02:00
|
|
|
- `Nova <http://docs.openstack.org/developer/nova/>`__
|
2017-02-09 15:36:49 +08:00
|
|
|
- `Octavia <http://docs.openstack.org/developer/octavia/>`__
|
2016-11-10 02:55:57 +00:00
|
|
|
- `Panko <http://docs.openstack.org/developer/panko/>`__
|
2016-09-02 11:59:43 +02:00
|
|
|
- `Rally <http://docs.openstack.org/developer/rally/>`__
|
|
|
|
- `Sahara <http://docs.openstack.org/developer/sahara/>`__
|
2016-10-18 16:36:05 +08:00
|
|
|
- `Searchlight <http://docs.openstack.org/developer/searchlight/>`__
|
2016-09-02 11:59:43 +02:00
|
|
|
- `Senlin <http://docs.openstack.org/developer/senlin/>`__
|
2016-11-07 15:26:09 +08:00
|
|
|
- `Solum <http://docs.openstack.org/developer/solum/>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
- `Swift <http://docs.openstack.org/developer/swift/>`__
|
2016-11-15 18:51:52 +00:00
|
|
|
- `Tacker <http://docs.openstack.org/developer/tacker/>`__
|
2015-12-03 16:00:56 -05:00
|
|
|
- `Tempest <http://docs.openstack.org/developer/tempest/>`__
|
2016-03-07 09:49:22 +05:30
|
|
|
- `Trove <http://docs.openstack.org/developer/trove/>`__
|
2016-09-02 11:59:43 +02:00
|
|
|
- `Vmtp <http://vmtp.readthedocs.io/en/latest/>`__
|
|
|
|
- `Watcher <http://docs.openstack.org/developer/watcher/>`__
|
2017-03-01 10:32:09 +08:00
|
|
|
- `Zaqar <http://docs.openstack.org/developer/zaqar/>`__
|
|
|
|
- `Zun <http://wiki.openstack.org/wiki/zun>`__
|
2015-11-17 16:24:36 -05:00
|
|
|
|
2016-09-06 10:31:25 +02:00
|
|
|
Infrastructure components
|
|
|
|
-------------------------
|
|
|
|
|
2017-01-13 09:27:27 +08:00
|
|
|
Kolla-Ansible deploys containers for the following infrastructure components:
|
2015-11-17 16:24:36 -05:00
|
|
|
|
2017-03-17 08:30:36 +01:00
|
|
|
- `Ceph <http://ceph.com/>`__ implementation for Cinder, Glance and Nova.
|
|
|
|
- `Collectd <https://collectd.org/>`__,
|
2017-03-28 11:45:49 +08:00
|
|
|
`Telegraf <https://docs.influxdata.com/telegraf/>`__,
|
2016-09-06 10:31:25 +02:00
|
|
|
`InfluxDB <https://influxdata.com/time-series-platform/influxdb/>`__, and
|
2017-03-17 08:30:36 +01:00
|
|
|
`Grafana <http://grafana.org/>`__ for performance monitoring.
|
|
|
|
- `Elasticsearch <https://www.elastic.co/de/products/elasticsearch/>`__ and
|
|
|
|
`Kibana <https://www.elastic.co/de/products/kibana/>`__ to search, analyze,
|
|
|
|
and visualize log messages.
|
2017-03-28 11:45:49 +08:00
|
|
|
- `Etcd <https://coreos.com/etcd/>`__ a distributed reliable key-value store.
|
2017-03-17 08:30:36 +01:00
|
|
|
- `Fluentd <https://www.fluentd.org/>`__ as an open source data collector
|
2017-03-01 10:32:09 +08:00
|
|
|
for unified logging layer.
|
2017-06-01 14:44:38 +08:00
|
|
|
- `Gnocchi <http://gnocchi.xyz/>`__ A time-series storage database.
|
2015-11-17 16:24:36 -05:00
|
|
|
- `HAProxy <http://www.haproxy.org/>`__ and
|
|
|
|
`Keepalived <http://www.keepalived.org/>`__ for high availability of services
|
|
|
|
and their endpoints.
|
2017-03-01 10:32:09 +08:00
|
|
|
- `Kafka <http://kafka.apache.org/documentation/>`__ A distributed streaming
|
|
|
|
platform.
|
2016-09-06 10:31:25 +02:00
|
|
|
- `MariaDB and Galera Cluster <https://mariadb.com/kb/en/mariadb/galera-cluster/>`__
|
2017-03-17 08:30:36 +01:00
|
|
|
for highly available MySQL databases.
|
|
|
|
- `Memcached <https://memcached.org/>`__ a distributed memory object caching system.
|
2016-09-06 10:31:25 +02:00
|
|
|
- `MongoDB <https://www.mongodb.org/>`__ as a database backend for Ceilometer
|
2017-03-17 08:30:36 +01:00
|
|
|
and Gnocchi.
|
|
|
|
- `Open vSwitch <http://openvswitch.org/>`__ and Linuxbridge backends for Neutron.
|
2016-09-06 10:31:25 +02:00
|
|
|
- `RabbitMQ <https://www.rabbitmq.com/>`__ as a messaging backend for
|
|
|
|
communication between services.
|
2014-09-20 21:10:29 -07:00
|
|
|
|
2015-02-16 21:37:03 +00:00
|
|
|
Directories
|
|
|
|
===========
|
2014-10-21 06:50:58 -07:00
|
|
|
|
2017-01-13 09:27:27 +08:00
|
|
|
- ``ansible`` - Contains Ansible playbooks to deploy OpenStack services and
|
|
|
|
infrastructure components in Docker containers.
|
2016-10-14 12:55:26 +02:00
|
|
|
- ``contrib`` - Contains demos scenarios for Heat and Murano and a development
|
|
|
|
environment for Vagrant
|
2016-09-06 10:31:25 +02:00
|
|
|
- ``doc`` - Contains documentation.
|
|
|
|
- ``etc`` - Contains a reference etc directory structure which requires
|
2015-08-20 23:06:10 -07:00
|
|
|
configuration of a small number of configuration variables to achieve
|
|
|
|
a working All-in-One (AIO) deployment.
|
2017-01-13 09:27:27 +08:00
|
|
|
- ``specs`` - Contains the Kolla-Ansible communities key arguments about
|
2015-08-20 23:06:10 -07:00
|
|
|
architectural shifts in the code base.
|
2017-03-15 17:21:47 +08:00
|
|
|
- ``tests`` - Contains functional testing tools.
|
|
|
|
- ``tools`` - Contains tools for interacting with Kolla-Ansible.
|
2014-10-21 06:50:58 -07:00
|
|
|
|
2015-02-16 21:37:03 +00:00
|
|
|
Getting Involved
|
|
|
|
================
|
2014-10-21 06:50:58 -07:00
|
|
|
|
2015-08-20 23:06:10 -07:00
|
|
|
Need a feature? Find a bug? Let us know! Contributions are much
|
|
|
|
appreciated and should follow the standard `Gerrit
|
2015-11-02 13:54:37 -05:00
|
|
|
workflow <http://docs.openstack.org/infra/manual/developers.html>`__.
|
2014-10-01 12:38:20 -04:00
|
|
|
|
2016-05-03 11:35:16 -04:00
|
|
|
- We communicate using the #openstack-kolla irc channel.
|
2015-08-20 23:06:10 -07:00
|
|
|
- File bugs, blueprints, track releases, etc on
|
2017-01-10 13:21:43 -03:00
|
|
|
`Launchpad <https://launchpad.net/kolla-ansible>`__.
|
2015-08-20 23:06:10 -07:00
|
|
|
- Attend weekly
|
|
|
|
`meetings <https://wiki.openstack.org/wiki/Meetings/Kolla>`__.
|
2017-01-13 09:27:27 +08:00
|
|
|
- Contribute `code <https://git.openstack.org/openstack/kolla-ansible>`__.
|
2014-10-01 12:38:20 -04:00
|
|
|
|
2015-02-16 21:37:03 +00:00
|
|
|
Contributors
|
|
|
|
============
|
2014-09-20 09:42:33 -07:00
|
|
|
|
2015-08-20 23:06:10 -07:00
|
|
|
Check out who's `contributing
|
|
|
|
code <http://stackalytics.com/?module=kolla-group&metric=commits>`__ and
|
|
|
|
`contributing
|
|
|
|
reviews <http://stackalytics.com/?module=kolla-group&metric=marks>`__.
|
2016-12-05 21:53:34 -07:00
|
|
|
|
|
|
|
Notices
|
|
|
|
=======
|
|
|
|
|
|
|
|
Docker and the Docker logo are trademarks or registered trademarks of
|
|
|
|
Docker, Inc. in the United States and/or other countries. Docker, Inc.
|
|
|
|
and other parties may also have trademark rights in other terms used herein.
|