From 9119e2e360f6a72b52c8879c4b68adf0c050a727 Mon Sep 17 00:00:00 2001 From: Steven Dake Date: Wed, 9 Mar 2016 00:27:24 -0500 Subject: [PATCH] Add note about heat being busted for development Heat development environments don't work at all. As such document this so folks avoid them unless they want to work on making them better. Change-Id: Ibe3296660d30ccc24213c272ef379e6d3e2c21f2 --- doc/quickstart.rst | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/doc/quickstart.rst b/doc/quickstart.rst index 838596a4c0..e3f2a922b9 100644 --- a/doc/quickstart.rst +++ b/doc/quickstart.rst @@ -11,12 +11,22 @@ operating system. If developing Kolla on an OpenStack cloud environment that supports Heat, follow the :doc:`Heat developer environment guide `. -If developing Kolla on a system that provides VirtualBox or Libvirt in addition -to Vagrant, use the Vagrant virtual environment documented in +If developing Kolla on a system that provides VirtualBox or Libvirt in +addition to Vagrant, use the Vagrant virtual environment documented in :doc:`Vagrant developer environment guide `. +Currently the Heat development environment is entirely non-functional. +The Kolla core reviewers have debated removing it from the repository +but have resisted to provide an opportunity for contributors to make Heat +usable for Kolla development. THe Kolla core reviewers believe Heat +would offer a great way to develop Kolla in addition to Vagrant, +bare metal, or a manually setup virtual machine. + +For more information refer to +`_bug 1562334 `__. + If evaluating Kolla, the community strongly recommends using bare metal or a -virtual machine during the evaluation period. Follow the instructions in this +virtual machine during the evaluation period. Follow the instructions in this document to get started with deploying OpenStack on bare metal or a virtual machine with Kolla. @@ -664,4 +674,4 @@ values are overridden, in ``/etc/kolla/globals.yml``. The value of Note: When you log in to Kibana web interface for the first time, you are prompted to create an index. Please create an index using the name ``log-*``. This step is necessary until the default Kibana dashboard is implemented in -Kolla. \ No newline at end of file +Kolla.