From fa2b96297ca2451bd5621c9c0bd8d85fa81b13a3 Mon Sep 17 00:00:00 2001
From: "Michal (inc0) Jastrzebski" <inc007@gmail.com>
Date: Fri, 16 Sep 2016 20:49:47 +0000
Subject: [PATCH] Point to boostrap-servers playbook in quickstart
Since initial setup is arguably the hardest part of kolla deployment,
let's show people our new plabybook to lower the barrier of entry.
TrivialFix
Change-Id: I6edf355772b5705207cdecfbe8c45672a63badf0
---
doc/multinode.rst | 2 ++
doc/production-architecture-guide.rst | 2 ++
doc/quickstart.rst | 23 +++++++++++++++++++++++
3 files changed, 27 insertions(+)
diff --git a/doc/multinode.rst b/doc/multinode.rst
index 245cbc30b0..46de3f2524 100644
--- a/doc/multinode.rst
+++ b/doc/multinode.rst
@@ -87,6 +87,8 @@ Restart docker by executing the following commands:
# Ubuntu with upstart or sysvinit
sudo service docker restart
+.. _edit-inventory:
+
Edit the Inventory File
=======================
diff --git a/doc/production-architecture-guide.rst b/doc/production-architecture-guide.rst
index 63d5e895e0..6fc560d162 100644
--- a/doc/production-architecture-guide.rst
+++ b/doc/production-architecture-guide.rst
@@ -29,6 +29,8 @@ A basic Kolla inventory consists of several types of nodes, known in Ansible as
Network configuration
=====================
+.. _interface-configuration:
+
Interface configuration
***********************
diff --git a/doc/quickstart.rst b/doc/quickstart.rst
index 56700134a7..82f60b4afd 100644
--- a/doc/quickstart.rst
+++ b/doc/quickstart.rst
@@ -27,6 +27,29 @@ started with deploying OpenStack on bare metal or a virtual machine with Kolla.
There are other deployment environments referenced below in
`Additional Environments`_.
+Automatic host bootstrap
+========================
+
+.. note:: New in Newton
+
+To quickly prepare hosts for Kolla, playbook ``bootstrap-servers`` can be used.
+This is an Ansible playbook which works on Ubuntu 14.04, 16.04 and CentOS 7
+hosts to install and prepare cluster for Kolla installation.
+
+.. note:: Installation of dependencies for deployment node and configuration
+ of Kolla interfaces is still required prior to running this command. More
+ information about Kolla interface configuration in
+ :ref:`interface-configuration`.
+
+Command to run the playbook:
+
+::
+
+ kolla-ansible -i <<inventory file>> bootstrap-servers
+
+To learn more about the inventory file, follow :ref:`edit-inventory`.
+
+
Install Dependencies
====================