aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichal (inc0) Jastrzebski <inc007@gmail.com>2016-09-16 20:49:47 +0000
committerMichal (inc0) Jastrzebski <inc007@gmail.com>2016-09-21 15:08:57 +0000
commitfa2b96297ca2451bd5621c9c0bd8d85fa81b13a3 (patch)
tree415079913fd7dbb50faf80aa04b6ef4d268f9e9b
parent43307904dde96ec802a9472b026b8b73da03f56d (diff)
downloadkolla-fa2b96297ca2451bd5621c9c0bd8d85fa81b13a3.tar.gz
kolla-fa2b96297ca2451bd5621c9c0bd8d85fa81b13a3.zip
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
-rw-r--r--doc/multinode.rst2
-rw-r--r--doc/production-architecture-guide.rst2
-rw-r--r--doc/quickstart.rst23
3 files changed, 27 insertions, 0 deletions
diff --git a/doc/multinode.rst b/doc/multinode.rst
index 245cbc30b..46de3f252 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 63d5e895e..6fc560d16 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 56700134a..82f60b4af 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
====================